GinCdn被控节点 V1.0.4 安装教程

（推荐 Ubuntu 22.04，配置 2H2G～16H32G）

一、环境说明

• 推荐系统：Ubuntu 22.04 LTS（64位）
• 兼容系统：Ubuntu 18.04 / 20.04 / 22.04 / 24.04
• 推荐配置：2H2G 起步，高并发业务可选 4H4G、8H8G、16H16G、16H32G
• 权限要求：必须使用 root 用户执行
• 网络要求：服务器可访问公网，80/443/8080 端口正常开放

二、一键部署命令

直接复制以下单条完整命令执行，自动下载、授权、运行脚本：

curl -k --http1.1 -o /root/start.sh https://www.gincdn.cn/download/ubuntu/start.sh && chmod +x /root/start.sh && bash /root/start.sh

三、部署过程

1. 脚本自动更新系统、安装依赖、部署 OpenResty/WS 客户端等组件

2. 按提示输入主控端地址，格式示例：

   http://主控IP:8080

3. 等待脚本执行完成，出现部署成功提示即可

四、部署验证

1. 查看服务状态

systemctl status ws_config_client.service

正常状态：Active: active (running)

2. 查看主控地址配置

grep MASTER_API_URL /opt/gincdn/conf/node_config.conf

3. 查看开机自启

systemctl is-enabled ws_config_client.service

正常输出：enabled

五、常用运维命令

# 重启节点服务
systemctl restart ws_config_client.service

# 停止服务
systemctl stop ws_config_client.service

# 启动服务
systemctl start ws_config_client.service

修改主控地址

sed -i 's|MASTER_API_URL=".*"|MASTER_API_URL="http://新主控IP:8080"|g' /opt/gincdn/conf/node_config.conf
systemctl restart ws_config_client.service

卸载节点

systemctl stop ws_config_client.service
systemctl disable ws_config_client.service
rm -rf /opt/gincdn /etc/systemd/system/ws_config_client.service /root/start.sh
systemctl daemon-reload

六、常见问题

1. 下载失败：重新执行一键命令即可（已强制 HTTP/1.1）

2. 服务启动失败：

   systemctl daemon-reload
   systemctl restart ws_config_client.service

3. 缺少 unzip：

   apt update && apt install -y unzip