# 添加节点

在面板取一条命令到新机器执行，审批后节点自动上线；含机器要求、端口与常见问题。

节点是接访客流量的机器。主控装好后,在面板上取一条命令到新机器执行即可,装完由管理员审批,审批后节点自动拿到配置上线。


## 机器要求
- Debian 12 / 13,或 Ubuntu 24.04 / 26.04 及更新,x86_64 或 arm64,有 systemd,以 root 执行。
- 干净系统:不要预装别的 nginx / OpenResty,80、443 端口不能被别的程序占着。
- 能访问主控的 7443(节点通信)、7444(升级包下发)、7445(日志接收),并对外开放要服务的端口(通常 80 / 443)。
- 不要装在主控所在的机器上。

## 1. 取命令
进入「节点管理」页,点右上角工具栏的「+ 添加节点」,在弹层里点「复制命令」。命令里的令牌一次性、30 分钟内有效,一条命令只装一台。

## 2. 在节点上执行
在新机器上以 root 粘贴执行。装机脚本会先做预检,不满足的一次列全并退出,本机不会被改动;通过后下载节点包并验签,验签不过一律拒装;命令里没有指定版本时,物料站上的新装默认版本(latest)也须验过超管签名才采用,不对就直接退出、不装。末行 `NODE_INSTALL_DONE <版本>` 即装好,屏幕会提示节点编号。

:::tip
取完命令马上装也没问题:主控会自动放行,脚本最多等 3 分钟、每 5 秒重连一次。
:::

## 3. 审批
回到「节点管理」页,页面上方会提示有新服务器已装好,点「初始化」审批(同时装了多台时,先点「查看并处理」打开抽屉,再逐台点「初始化」)。审批后无需再登录节点:几秒内自动领证、拉配置、起服务,在节点列表里显示为「在线」。

:::warn
命令里的主控地址如果是本机或内网地址,命令前面会多两行 `# 【警告】`。先到「系统管理 › 升级与维护 › 节点通信」填好「节点通信公网地址」再重新取命令,否则别处的节点多半连不上主控。
:::

## 常见问题
- 令牌过期:重新点「添加节点」取新命令。
- 装到一半出问题:同一条命令可以重跑,已做好的跳过、缺的补上,节点身份不变。
- 时间不同步:脚本会提示,节点上线后每 10 分钟按主控时间校时;机房拦了 UDP 123 的话放行即可。
- 节点要下线:见[卸载与迁移](https://www.gocdn888.com/zh/guide/migrate)。