申请与安装子节点

前提条件

• 一台可以用 root 操作的 Linux 服务器（amd64 或 arm64）；
• 能访问 GitHub、Docker Hub 与各发行版官方源，建议境外线路；
• 注册一个 开源驿站 账号。

⚠️ 如果服务器位于中国大陆，一键安装脚本会提醒你：子节点直接访问上游，
国内网络下加速效果可能不明显，建议改用境外机器。

流程

1. 登录后进入用户中心 → 贡献服务器，填写节点名称、地区、线路、配置与联系方式并提交申请；
2. 管理员审核通过后，页面会给出一次性安装命令（只显示一次，请立即复制）；
3. 在子服务器上执行该命令；
4. 安装脚本会自动注册、拿到通讯密钥与访问域名、写入 systemd 服务并启动；
5. 之后节点每 30 秒向主节点心跳，状态会出现在节点列表里。

安装命令长什么样

curl -fsSL 'https://www.gh-proxy.cn/node/install.sh?token=一次性令牌' | sudo sh

脚本做的事情（可以先下载下来自己审阅再执行）：

1. 检查 root 权限与系统架构，并检测网络所在国家/地区（国内会提醒）；
2. 从主节点下载 gha-node 程序到 /usr/local/bin；
3. 用一次性令牌向主节点注册，换取通讯密钥与访问域名，
   并把本机机器指纹一起上报（一个安装命令只能绑定一台机器）；
4. 写入 /etc/gha-node/agent.env（权限 600）并注册 gha-node.service；
5. 生成 /etc/gha-node/uninstall.sh 方便随时卸载。

非交互安装（自动化部署）

安装脚本全程只使用普通命令行文本提示，不需要任何终端界面组件，
输出按 [1/7] 这样的步骤编号排列，方便直接贴进日志。

在 CI、批量部署或没有终端（无法输入 y 确认）的环境里，请显式表示同意使用 80 与 443 端口：

curl -fsSL 'https://www.gh-proxy.cn/node/install.sh?token=一次性令牌' | sudo sh -s -- --yes

也可以用环境变量 GHA_ACCEPT_PORTS=1 达到同样效果。脚本还支持
--help（查看用法）与 --uninstall（停止服务并清理文件）。

换机器 / 重装

在「贡献服务器」页面点击重新生成安装命令，旧命令立即失效，然后在新机器上执行新命令即可。

卸载

sh /etc/gha-node/uninstall.sh
# 或者
systemctl disable --now gha-node && rm -rf /etc/gha-node /var/lib/gha-node /usr/local/bin/gha-node

管理员在后台撤销该节点时，节点会在下一次心跳（默认 30 秒）内自动停止服务、
删除配置与程序文件，并从节点列表中消失。

常见问题