NyxBot 一键部署脚本使用文档

版本: 2.0.0
更新日期: 2026-10-08

💡 只需要一分钟，会复制粘贴就能装好。不需要懂编程。

🧭 Java 版与 Go 版的区别

NyxBot 目前有两个后端版本。Go 版是 Java 版（Spring Boot）迁移到 Go/Gin 的重写实现，目标是在不改前端的前提下完整兼容，但迁移仍在进行中、功能尚未与 Java 版完全对齐（进度见 NyxBot-Go 仓库）——追求功能完整请用 Java 版，想尝鲜 Go 重写版或需要单二进制轻量部署再往下看。

对比项 Java 版（现役） Go 版（重写中）
运行产物 NyxBot.jar，需要 Java 21（部署脚本会自动装好） 单个二进制 NyxBot，不需要任何运行时
部署脚本 nyxbot-deploy.sh（Linux/macOS）、nyxbot-deploy.ps1（Windows） nyxbot-go-deploy.sh（Linux / macOS）
安装位置 用户目录 ~/NyxBot（注册 systemd 服务时需要 sudo） 系统级 /opt/nyxbot + 专用系统用户（全程需要 sudo）
服务托管 systemd / nohup / Windows 计划任务 systemd（其他环境自动降级 nohup）
配置文件 以启动参数为主，脚本自动记忆 /opt/nyxbot/config.yaml（程序首启自动生成，脚本仅改端口/模式/Token）
Docker 镜像 kingprimes/nyxbot kingprimes/nyxbot-go（另有 GHCR 源）
系统兼容 能装 Java 就能跑（Alpine 也可以） 依赖 glibc，Alpine 等 musl 系统只能走 Docker
版本状态 正式稳定版 预览版（下载优先稳定版，无稳定版自动用最新预览版）

还没有服务器？ 按版本对号入座就行：Java 版推荐 2核4G，Go 版 2核2G 即可稳定运行。精选特惠服务器（低至 68 元/年）👉 云上特惠推广 · NyxBot 部署推荐服务器

🐹 Go 版部署（Linux / macOS）

交互式安装（会依次询问端口、Token、通讯模式等）：

1
curl -fsSL https://kingprimes.top/script/nyxbot-go-deploy.sh | bash

无人值守安装（不提问，适合脚本 / CI。bash -s -- 用于把后面的参数传给脚本本身，--token 必填）：

1
curl -fsSL https://kingprimes.top/script/nyxbot-go-deploy.sh | bash -s -- --quiet --token=<OneBot令牌>

参数说明（除 --quiet 外均可省略）：

参数 作用 必填
--quiet 无人值守：全程不提问 无人值守时必填
--token=xxx OneBot 鉴权令牌 无人值守（--quiet）必填；交互模式会提示输入
--port=8080 服务端口 可选，默认 8080
--server / --client OneBot 通讯模式：服务端（默认）/ 客户端 可选
--ws-url=ws://主机:3001 客户端模式的正向 WS 地址 仅 --client 模式使用
--docker / --local 强制 Docker / 本地二进制安装（默认自动：glibc 系统用本地，Alpine 等 musl 系统用 Docker） 可选
--proxy=URL 仅脚本自身下载 GitHub 时走 HTTP 代理 可选
--inc / --noc 安装 / 不安装 nyxbot-go 系统命令 可选（交互模式会询问，无人值守默认不装）
--unc 仅移除已安装的 nyxbot-go 系统命令 可选
--tui / --text 强制 TUI 表单 / 文本问答界面 可选
--force 检测到冲突的既有安装（如 Java 版同名服务）时直接覆盖，不再询问 可选

查看完整帮助：curl -fsSL https://kingprimes.top/script/nyxbot-go-deploy.sh | bash -s -- --help

⚠️ 不建议在同一台机器同时安装两个版本：服务名（nyxbot）与默认端口（8080）相同，会相互冲突。

🚀 新版统一部署脚本（推荐）

本节为 Java 版 部署教程；Go 版部署见上一节。

v2.0 全新升级！ 管理菜单、实时状态监控、双引擎 TUI、系统命令注册、JAR 完整性校验。

在开始之前，请先装好 OneBot 客户端（NapCat 或 LLOneBot），它是让机器人连上 QQ 的软件。

不会装？看这里 → NyxBot 手把手部署教程

💻 Windows（最多人用的系统）

第一步：下载脚本

打开 PowerShell（在开始菜单搜索就行，普通运行即可，不需要管理员），输入：

1
Invoke-WebRequest -Uri "https://kingprimes.top/script/nyxbot-deploy.ps1" -OutFile "nyxbot-deploy.ps1"

如果提示"无法加载文件"或"禁止执行脚本"，先输入这行再试：
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

第二步：运行脚本

1
.\nyxbot-deploy.ps1

会弹出一个图形化窗口，填好配置就能一键安装：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
┌─────────────────────────────────┐
│ NyxBot One-Click Deploy      X │
├─────────────────────────────────┤
│ Port / 端口    [8080    ]      │  ← 端口号，不改就用 8080
│ Token *        [        ]      │  ← OneBot Token，必填！
│ Mode / 模式   ○Server ○Client  │  ← 选 Server（默认就行）
│ Proxy / 代理   [        ]      │  ← 没有代理就空着
│ Install / 安装 ○Docker ○Local  │  ← 推荐 Docker，没有就 Local
├─────────────────────────────────┤
│ NyxBot: Running / 运行中        │  ← 安装后会显示运行状态
│ Task:    Active / 已注册        │  ← 开机自启状态
│ [停止] [移除计划任务]           │  ← 管理按钮
├─────────────────────────────────┤
│         [取消] [开始安装]        │
└─────────────────────────────────┘
  • Token 是唯一必须填的（在 NapCat / LLOneBot 里能看到）
  • 其他选项保持默认就行，什么都不用改
  • 填好 Token，点 Deploy / 开始安装，等着就行

脚本会自动：测速选最快线路 → 下载 → 校验文件完整性 → 创建计划任务 → 启动 NyxBot。

安装完成后打开浏览器访问 http://localhost:8080，看到 NyxBot 管理页面就是成功了。

💡 不需要管理员权限！ 脚本会尝试创建计划任务（开机自启），如果没有管理员权限会自动降级为用户级任务，一样能开机自启。即使计划任务创建失败，也会直接启动 NyxBot，不影响使用。

📌 已经装过了？再跑一次就行

再次运行脚本，窗口会自动检测：

  • 版本已是最新 → 跳过下载，直接启动（几秒钟就好）
  • 发现新版本 → 弹出更新提示，选"是"更新，选"否"继续用旧版
  • 上次填的 Token、端口等配置会自动预填，不用重新输入

窗口下方有实用的管理按钮：

按钮 作用
Stop / 停止 停止正在运行的 NyxBot，同时移除计划任务防止自动重启
Remove Task / 移除计划任务 仅移除开机自启，不影响当前运行

📌 命令行模式（没有图形界面时用）

1
.\nyxbot-deploy.ps1 -Text     # 命令行问答模式

如果环境不支持图形窗口（如远程 SSH），加 -Text 参数就会用传统的命令行问答方式来安装。

其他参数：

1
2
3
.\nyxbot-deploy.ps1 -Docker -Quiet -Token 你的Token      # 静默 Docker（不弹窗不提问）
.\nyxbot-deploy.ps1 -Local -Port 9090 -Token 你的Token    # 本地安装 + 自定义端口
.\nyxbot-deploy.ps1 -Help                                 # 查看所有参数说明

🐧 Linux / macOS

一步到位（复制粘贴就完事）：

1
curl -fsSL https://kingprimes.top/script/nyxbot-deploy.sh | bash

脚本会自动检测你的系统、安装 Java（没有的话）、测速选最快下载路线、下载 NyxBot、弹出配置表单。

不喜欢管道？手动下载：

1
2
3
curl -O https://kingprimes.top/script/nyxbot-deploy.sh
chmod +x nyxbot-deploy.sh
./nyxbot-deploy.sh

首次安装

运行脚本后会自动进入配置流程（支持 dialog/whiptail TUI 表单或文本问答）：

1
2
3
4
5
6
7
8
9
10
── Basic Config / 基础配置 ──
  Port / 端口 [8080]:        ← 端口号，不改就回车
  Token (required / 必填):   ← OneBot Token，必填！
── Mode / 通讯模式 ──
  1) Server  2) Client
── Proxy / 代理 (回车跳过) ──
── System Command / 系统命令 ──
  Install 'nyxbot' command? [Y/n]
── Confirm / 确认 ──
  Proceed? / 确认安装? [Y/n]

填好后脚本自动：检测环境 → 安装 Java → 测速选线路 → 下载 → SHA256 校验 → 安装 systemd 服务 → 启动。

安装完成后访问 http://你的IP:8080。

已安装？再跑一次 = 管理面板

再次运行脚本，会显示管理菜单：

1
2
3
4
5
6
7
8
9
10
11
12
── NyxBot Management / NyxBot 管理 ──
  Status / 状态: Running / 运行中

  1) Update / 更新 (download latest + restart)
  2) Restart / 重启
  3) Stop / 停止
  4) Status / 查看状态
  5) Reconfigure / 重新配置
  6) Remove system command / 移除系统命令
  7) Quit / 退出

  Select / 选择 [1]:
选项 作用
1) Update 检查版本 → 已最新跳过 / 有新版本下载更新
2) Restart/Start 重启或启动 NyxBot
3) Stop 停止运行中的 NyxBot
4) Status 实时状态监控（自动刷新，Esc 退出）
5) Reconfigure 修改端口/Token/代理等配置
6) Remove cmd 移除 nyxbot 系统命令
7) Quit 退出脚本

💡 管理菜单是循环的——选完一个操作后回到菜单，只有选 7 才退出。

安装为系统命令

安装时选 Y 安装 nyxbot 命令，之后在任何目录都能管理：

1
2
3
4
nyxbot              # 打开管理菜单
nyxbot --tui        # TUI 配置界面
nyxbot --help       # 查看帮助
nyxbot --unc        # 移除命令

常用参数

1
2
3
4
5
6
7
8
9
10
./nyxbot-deploy.sh                          # 交互式部署（自动检测 TUI）
./nyxbot-deploy.sh --docker                 # 强制 Docker 容器部署
./nyxbot-deploy.sh --local                  # 强制本地 JAR 部署
./nyxbot-deploy.sh --tui                    # TUI 可视化表单（dialog/whiptail）
./nyxbot-deploy.sh --text                   # 文本问答模式（SSH 兼容）
./nyxbot-deploy.sh --quiet --token=xxx      # 静默部署（不提问，CI/CD 用）
./nyxbot-deploy.sh --inc                    # 安装后注册为系统命令
./nyxbot-deploy.sh --proxy=http://IP:端口    # 使用 HTTP 代理
./nyxbot-deploy.sh --port=9090              # 自定义端口
./nyxbot-deploy.sh --pu=用户名 --pp=密码     # 代理认证

新版特性

特性 说明
🖥️ Windows 图形化窗口 可视化表单填写配置，不需要记命令，一看就会
🎛️ 管理菜单 已安装后再运行自动进入管理面板（更新/重启/停止/状态/重配）
📺 实时状态监控 自动刷新显示运行状态、systemd 日志，Esc 退出
🔍 自动版本检测 已安装时自动跳过下载，发现新版本询问更新
🔐 SHA256 完整性校验 下载后自动验证文件哈希值 + 重配时校验已有 JAR 完整性
📝 配置自动保存 Token、端口等配置自动记忆，再跑脚本一键更新
🐳 Docker 部署 自动检测 Docker，优先容器安装，国内镜像源自动切换
📊 双引擎 TUI dialog（多字段表单）+ whiptail（分步问答），SSH 终端友好
📶 网络测速 直连 + 9 个 GitHub 代理测速，自动选最快线路
🔧 系统命令注册 nyxbot 命令全局可用，任意目录管理 NyxBot
🤖 静默模式 --quiet --token=xxx 一行部署，适合 CI/CD
💻 跨平台 Linux (systemd/nohup) + macOS 全支持，自动适配
🔒 智能降级 Docker 不可用→本地安装 / TUI 不可用→文本模式 / dialog→whiptail

安装后输出示例

Windows：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
========================================
  NyxBot Deploy v1.0.0
  NyxBot 一键部署脚本
========================================

[+] System / 系统: Windows Windows 10 专业版 (x64)
[+] Java 21 : installed / 已安装
[>] Network speed test / 网络测速 (parallel / 并行)...
  Testing 9 proxies / 正在测试 9 个代理......
[+] Best / 最快: https://gh-proxy.com (48.8 KB/s)
[>] Get latest version / 获取最新版本...
[+] Version / 版本: v2.1.5
[>] Downloading NyxBot v2.1.5 / 正在下载...
  File size / 文件大小: 165.2 MB
  Testing Range support with chunk 0 / 使用首个分块测试 Range 支持...
[+]   Range supported, downloading remaining chunks...
  Chunk 1/3 / 分块 1/3... Done / 完成
  Chunk 2/3 / 分块 2/3... Done / 完成
  Chunk 3/3 / 分块 3/3... Done / 完成
  Assembling & verifying / 正在合并并校验... Done / 完成
[+] Download complete / 下载完成 (165.2 MB)
  Verifying SHA256 / 正在校验完整性... OK / 通过
[>] Creating scheduled task / 创建计划任务...
[+]   Task level: User (auto-start on logon) / 用户级(登录自启)
[+] NyxBot started / 已启动 (task: NyxBot)

+------------------------------------------+
|  NyxBot Installed / NyxBot 安装完成!      |
+------------------------------------------+
  Dashboard / 管理页面: http://localhost:8080
  Data / 数据目录: <当前目录>\NyxBot
  Status / 状态: Get-ScheduledTask 'NyxBot'

Linux / macOS：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
  _   _            ____        _   
 | \ | |_   ___  _| __ )  ___ | |_ 
 |  \| | | | \ \/ /  _ \ / _ \| __|
 | |\  | |_| |>  <| |_) | (_) | |_ 
 |_| \_|\__, /_/\_\____/ \___/ \__|
        |___/                      

  NyxBot Deploy v2.0.0 / NyxBot 一键部署脚本

[✔] System: ubuntu x86_64 / 系统: ubuntu x86_64
[ ] Mode: Local install (ubuntu) / 安装方式: 本地安装 (ubuntu)
[ ] Directory: /home/kingprimes/NyxBot

[✔] Java 21: installed / Java 21: 已安装
[>] Network speed test / 网络测速...
  Testing: Direct / 直连... 90.3 KB/s
  Testing: ghfast.top... 42.3 KB/s
  ...
[✔] Best: https://ghm.078465.xyz (88.2 KB/s)
[>] Fetching latest version... / 获取最新版本...
[✔] Version: v2.1.5 / 版本: v2.1.5
[>] Chunked download (4 chunks) / 分块下载 (4 块)...
  Chunk 1/3 / 分块 1/3... Done / 完成
  ...
  Assembling & verifying / 合并并校验... OK
[✔] Download complete (165.2 MB) / 下载完成 (165.2 MB)
  Verifying SHA256 / 校验完整性... OK / 通过
[>] Creating systemd service... / 创建 systemd 服务...
[✔] systemd service installed and started

┌──────────────────────────────────────────┐
│        NyxBot Install Complete!           │
│        NyxBot 安装完成！                   │
├──────────────────────────────────────────┤
│  Dashboard / 管理页面: http://localhost:8080
│  Data / 数据目录: /home/kingprimes/NyxBot
│  Logs / 日志:    tail -f /home/kingprimes/NyxBot/nyxbot.log
│  Restart / 重启: systemctl restart nyxbot
│  Status / 状态:  systemctl status nyxbot
└──────────────────────────────────────────┘

安装后如何管理

Windows

推荐方式：重新运行部署脚本，图形窗口会显示 NyxBot 运行状态，可以一键停止或管理计划任务。

手动方式：

1
2
3
4
5
6
7
8
9
10
11
# 查看计划任务状态
Get-ScheduledTask -TaskName "NyxBot"

# 手动启动
Start-ScheduledTask -TaskName "NyxBot"

# 手动停止（停掉 java 进程）
Get-Process -Name "java" | Where-Object { $_.CommandLine -like "*NyxBot.jar*" } | Stop-Process

# 移除计划任务（不再开机自启）
Unregister-ScheduledTask -TaskName "NyxBot" -Confirm:$false

Linux / macOS

推荐方式：运行 nyxbot 命令或重新运行脚本，进入管理菜单：

1
2
3
4
5
6
── NyxBot Management / NyxBot 管理 ──
  Status / 状态: Running / 运行中

  1) Update / 更新      4) Status / 查看状态     7) Quit / 退出
  2) Restart / 重启     5) Reconfigure / 重新配置
  3) Stop / 停止        6) Remove system command
  • 选 4) Status 进入实时状态监控，自动刷新显示运行状态和最新日志，按 Esc 退出
  • 选 5) Reconfigure 修改端口、Token、代理等配置，保存后手动选 2 重启生效
  • 操作完成后自动回到菜单，选 7) Quit 才退出

手动命令：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
# systemd (Linux)
systemctl status nyxbot        # 看状态
systemctl restart nyxbot       # 重启
systemctl stop nyxbot          # 停止

# Docker 模式
docker logs -f nyxbot          # 看日志
docker restart nyxbot          # 重启
docker stop nyxbot             # 停止

# nohup 模式 (macOS / 无 systemd)
tail -f ~/NyxBot/nyxbot.log    # 看日志
cat ~/NyxBot/nyxbot.pid        # 查看 PID
kill $(cat ~/NyxBot/nyxbot.pid) # 停止

常见问题

Q1: PowerShell 报错"禁止执行脚本"

1
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

输入这行，然后重新运行脚本。

Q2: 脚本说找不到 Java 怎么办

脚本会自动帮你装 Java 21。如果自动安装失败了：

  • Ubuntu/Debian：sudo apt install openjdk-21-jre-headless -y
  • CentOS/Fedora：sudo dnf install java-21-openjdk-headless -y
  • macOS：brew install openjdk@21
  • Windows：去 Oracle 下载安装包双击安装

装完再跑一次脚本。

Q3: 国内网络下载太慢

脚本内置了 8 个 GitHub 加速源（ghfast.top、gh-proxy.com 等），会自动测速选最快的。如果你发现还是慢：

  1. 手动去 GitHub Releases 下载 NyxBot.jar
  2. 放到脚本同级目录下的 NyxBot/ 文件夹里
  3. 运行脚本时选本地安装模式

Q4: Docker Hub 拉不下镜像

脚本内置了 3 个国内 Docker 镜像源，会自动切换。你也可以手动拉：

1
2
docker pull docker.1panel.live/kingprimes/nyxbot:latest
docker tag docker.1panel.live/kingprimes/nyxbot:latest kingprimes/nyxbot:latest

Q5: 怎么改端口？

Windows：再跑一次 .\nyxbot-deploy.ps1，窗口里的 Port 改成你想要的端口号，点开始安装就行。脚本会自动更新计划任务。

Linux / macOS：

1
2
3
4
5
6
# 启动时指定
./nyxbot-deploy.sh --port=9090

# 已经装了？Docker 模式重跑容器：
docker rm -f nyxbot
docker run --name nyxbot -d -p 9090:8080 kingprimes/nyxbot:latest

第三方脚本支持

  • 除了官方提供的部署脚本外，我们还支持由社区维护的第三方部署脚本。

nyxbot-linux-D_R.run

来源: FreeStar007/NyxGo

基于 Python 的可视化部署脚本，提供更友好的交互界面。

  • ✅ 基于 Python 实现，提供更友好的交互界面
  • ✅ 自动检测系统环境并安装依赖
  • ✅ 支持多种 OneBot 实现的自动安装
  • ✅ 内置 Python 虚拟环境，不影响系统 Python
  • ✅ 包含可视化的部署进度和状态显示
  • ✅ Linux 系统 (Debian/Ubuntu, RHEL/CentOS, Arch 等)
教程视频

第三方脚本的问题请直接向原作者反馈：GitHub Issues

贡献与反馈

如果您遇到问题，请提供以下信息：

  1. 操作系统: uname -a（Linux/macOS）或在 Windows 设置中查看
  2. Java 版本: java -version
  3. NyxBot 版本：在你下载时看到的版本号
  4. 错误截图: 如果有的话

附录

脚本文件

1
2
3
nyxbot-deploy.sh        # Java 版 · Linux / macOS 统一脚本 v2.0（推荐）
nyxbot-deploy.ps1       # Java 版 · Windows PowerShell 脚本（推荐）
nyxbot-go-deploy.sh     # Go 版 · NyxBot-Go 部署脚本 v1.0（Linux / macOS）

旧版 nyxbot-linux.sh / nyxbot-macos.sh / nyxbot-windows.ps1 在服务器保留可用，但推荐使用新版。

nyxbot-go-deploy.sh 用于 Go 重写版后端 NyxBot-Go：单二进制、无需 Java 运行时；安装到 /opt/nyxbot 并注册 systemd 服务（无 systemd / macOS 自动降级 nohup），Alpine 等 musl 系统请使用 --docker 容器模式。

常用命令

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
# 交互式部署（自动检测 TUI）
./nyxbot-deploy.sh

# TUI 表单（dialog 优先，降级 whiptail，再降级文本）
./nyxbot-deploy.sh --tui

# 文本问答（SSH 兼容）
./nyxbot-deploy.sh --text

# Docker 容器
./nyxbot-deploy.sh --docker

# 本地 JAR
./nyxbot-deploy.sh --local

# 静默（不提问，CI/CD 用）
./nyxbot-deploy.sh --quiet --token=xxx --port=9090

# 使用代理 + 注册系统命令
./nyxbot-deploy.sh --inc --proxy=http://127.0.0.1:10808

# 安装后管理
nyxbot                    # 管理菜单
nyxbot --tui              # TUI 重配
nyxbot --unc              # 移除系统命令
systemctl status nyxbot   # Linux 服务状态
docker logs -f nyxbot     # Docker 日志

相关链接

文档版本: v2.0.0
最后更新: 2026-10-08
维护者: KingPrimes