CDNCA
查看文档目录

节点重装指引

节点重装指引：在控制台生成重装命令，卸载并清除旧状态，再重新安装，配置和证书随后自动下发。

作用

让一个已经接入的节点在新机器上，或在重置系统后的机器上重新安装。重装后沿用该节点的 ID、名称、区域、IP、线路组和网站分配，主控无需调整；站点配置和证书自动重新下发，不需要手工重新绑定。

使用场景

  • 把节点换到一台新机器上。
  • 节点所在机器重置了系统，需要重新安装。

在哪里配置

控制台：节点列表，选择节点，“重装此节点”。页面生成一条一次性命令，“命令有效期”默认 3600 秒（1 小时），命令只能使用一次，过期后重新生成。

步骤

  1. 在控制台点“重装此节点”，复制生成的命令。
  2. 如果是在原来的机器上重装，先用 root 执行卸载并清除旧状态（换到全新机器时不需要这一步）：
/usr/libexec/cdnca-edge-agent/uninstall.sh --purge --non-interactive --confirm-purge DELETE-EDGE-IDENTITY-AND-STATE
  1. 在要接替该节点的机器上，以 root 执行第 1 步复制的命令。安装完成时，原机器上 Agent 的证书会被吊销并断开连接。
  2. 回到控制台，确认节点在线、配置自动下发。同一线路组里的节点逐台操作。

清除时会一并删除动态路由状态。/var/lib/dynroute 下如果挂载了其他磁盘，磁盘里的内容会保留，并提示你，其余内容照常删除。

重装后会自动发生什么

  • 站点配置自动重新下发；某次下发失败时，在 6 小时内每 10 分钟自动重试。
  • 证书发放的等待时间清零，下一轮（约 1 分钟）就补发。
  • 证书送达全部节点后，控制台自动显示发布成功。
  • 主控会定时更新节点安装包，重装的节点装到的是与主控匹配的版本。主控的重装命令在主控首选 WebSocket 入口时，也带有直连参数，直连不通时自动走 443 的 WebSocket。

常见问题

命令执行到一半失败了

排除原因后，在同一条命令后面加 --resume 再执行。令牌在注册前失败时，1 小时内可以重复使用。

命令过期了

回到控制台重新点“重装此节点”生成新的命令。

重装后节点在线但站点打不开

先等一轮自动重发。过一会儿仍然打不开，在控制台查看该节点的发布状态，并检查证书是否已经送达。

其他节点要不要一起重装

不需要，哪台有问题装哪台。同一线路组里要重装多台时，逐台进行。