重启、升级、卸载与迁移

cdnca 主控与节点的重启、查看日志、升级、备份、节点卸载与主控迁移。

主控与节点的重启、查看日志、升级、备份、卸载和迁移。命令都在对应服务器上以 root 执行。

重启

主控：

systemctl restart cdnca-control-api cdnca-agent-gateway cdnca-control-nats cdnca-control-web复制

节点：

systemctl restart cdnca-edge-agent复制

节点没有单独的 OpenResty 服务，OpenResty 由 cdnca-edge-agent 拉起并管理。重启 cdnca-edge-agent 不会重启 OpenResty，也不会中断正在转发的连接；OpenResty 未在运行时，Agent 启动后会自动把它拉起。

查看日志

journalctl -u cdnca-control-api -n 200 --no-pager复制

节点上把 cdnca-control-api 换成 cdnca-edge-agent。安装过程的完整输出在 /var/log/cdnca-install-control-*.log 和 /var/log/cdnca-install-node-*.log。

升级

只在主控后台“系统管理 → 维护升级 → 系统升级”里升级（可以指定版本）。节点在同一页的“节点升级”里由主控统一推送，可以按节点查看日志。不要手工替换二进制文件。

升级中显示“升级失败，已回滚”时，系统已回到原版本；点“查看日志”记录失败原因后联系技术支持，不要反复重试。

备份

在“系统管理 → 维护升级 → 维护操作”的“主控备份与迁移”里：

1. 点“立即备份”。备份时会停止 control-api、Gateway 与升级程序，管理后台暂时不可用（通常几分钟），完成后自动恢复；节点继续服务。
2. 在“定时备份”里选择星期和时间、本机保留份数、异地保留份数，点“保存设置”。
3. 在“异地存储”添加 S3/RustFS 或 SFTP，填写后点“测试连接”，显示“连接正常”再保存。测试连接用的是当前填写的内容，不必先保存。
4. 点“导出恢复密钥”，设置至少 12 个字符的恢复口令。原主控整机丢失时，要凭恢复密钥文件与口令才能解开异地备份；口令不会保存，请与文件分开保管。

在“备份列表”和“运行记录”里核对每次备份的时间、大小和签名是否“有效”。备份签名指纹请另外记录，恢复时用于确认备份来自本主控。

卸载节点

/usr/libexec/cdnca-edge-agent/uninstall.sh复制

加 --purge 会同时删除节点身份与本地状态（会要求确认）：

/usr/libexec/cdnca-edge-agent/uninstall.sh --purge复制

卸载前先在主控停用或删除这台节点，并确认它不再承担网站流量。

卸载主控

主控没有卸载脚本。需要彻底移除时请重装系统。

迁移主控到新服务器

迁移会把本主控整体搬到一台全新服务器：新服务器安装同版本依赖 → 旧主控冻结并加密备份 → 传输 → 新服务器恢复并校验。

准备：

1. 一台全新系统的新服务器。
2. 在授权中心打开授权详情，在“迁移下载 IP”里填写新服务器的公网 IP，让新服务器在有效期内能下载安装包。迁移沿用原安装，不需要新的安装命令；迁移完成后再点“修改主控 IP”改成新服务器。

方式一，在旧主控后台操作：在“维护操作 → 迁移主控”填写新主控 IP 或域名、SSH 端口、用户和登录方式，点“获取指纹”并核对主机指纹，输入新主控地址确认后点“开始迁移”。开始后旧主控管理后台立即停止，结果在新主控查看。

方式二，在新服务器上执行，安装器会经 SSH 从旧主控取加密备份并恢复，等待节点重连：

bash install-control.sh migrate-from root@旧主控IP --ssh-port 22 --wait-nodes 10m复制

完成后：

• 把管理端域名与网关域名的 DNS 改到新服务器，节点会自动重连。
• 在新主控确认登录、节点在线、网站访问正常后，再关闭旧主控。旧主控迁移后保持冻结，避免两套主控同时写入。
• 需要回切时，把 DNS 改回旧主控，并在旧主控的维护操作页解除冻结。