升级 / 备份 / 迁移

备份

数据库（三端都要）

# 主控
sqlite3 /opt/nkxconsole/console.db ".backup /root/console-$(date +%F).db"
# 财务端
sqlite3 /opt/nkxweb/web.db ".backup /root/web-$(date +%F).db"
# 被控（每台）
sqlite3 /opt/pvepanel/panel.db ".backup /root/panel-$(date +%F).db"

建议写成 cron，每天凌晨执行并保留 14 天：

0 4 * * * sqlite3 /opt/nkxconsole/console.db ".backup /root/console-$(date +\%F).db" && find /root -name 'console-*.db' -mtime +14 -delete

配置文件

/opt/*/config.json 里有服务令牌 / PVE Token 等关键信息，一起备份。

升级

三端都是单文件二进制，升级 = 替换二进制 + 重启：

# 主控
systemctl stop nkxconsole
cp 新版本/nkxconsole /opt/nkxconsole/nkxconsole && chmod +x /opt/nkxconsole/nkxconsole
systemctl start nkxconsole
journalctl -u nkxconsole -n 20 --no-pager   # 确认无报错

# 财务端同理（nkxweb）
# 被控：替换 /opt/pvepanel/nkx-panel 后 systemctl restart nkx-panel

被控升级要同步安装包

主控的 /opt/nkxconsole/agent/nkx-agent 是给新杜甫下载用的，升级被控后记得一起替换，否则新节点装到旧版本。

数据库结构会自动迁移（启动时执行），升级前备份数据库即可放心。

迁移主控 / 财务端

1. 停服务
2. 拷贝 二进制 + config.json + *.db + secret.key + 证书 到新服务器（保持路径一致）
3. 改 DNS / Cloudflare 指向新 IP
4. 启动服务，验证登录

被控无需改动（它认的是主控地址，域名不变就不用动）。

迁移被控（换杜甫）

方案 A：新杜甫装被控，旧机上的机器逐台迁移

主控 → 游戏服务器/机器 → 迁移 → 选择新节点

方案 B：整机搬迁（不推荐）——PVE 集群迁移更专业。

故障排查常用命令

# 服务状态与日志
systemctl status nkxconsole --no-pager
journalctl -u nkxconsole -n 100 --no-pager

# 端口占用
ss -tlnp | grep -E '443|8443'

# 被控 API 连通性（在被控本机；用本机证书验证）
curl --cacert /opt/pvepanel/cert.pem https://127.0.0.1:8443/api/node/ping -H "Authorization: Bearer 节点Token"

# 财务端 ↔ 主控（在财务端上）
curl -sS https://console.example.com/api/exec/nodes -H "X-Service-Token: 服务令牌"

新版主控按 Agent 注册时提交的证书 SHA-256 指纹校验 Agent API 和 WebSocket。旧节点升级后需在主控重新生成安装码并执行新安装命令完成一次重新登记；更换 Agent 证书后也要重新登记。