GinCdn被控节点V1.0.4 安装教程（Ubuntu 18.04~24.04 通用）

本教程适配Ubuntu 18.04/20.04/22.04/24.04 64位系统，专为GinCdn V1.0.4版本被控节点打造，一键命令全自动部署，新手零门槛操作。

一、部署前置要求

系统权限：必须使用root用户执行命令（非root用户请在所有命令前加sudo）
网络条件：服务器可访问公网，80/443/8080端口放行（与主控端配置一致）
基础依赖：系统自带curl/wget，脚本会自动补全缺失依赖

二、一键全自动部署（核心步骤）

1. 执行一键部署命令

直接复制下方完整命令，粘贴到服务器终端执行，无需分步操作，自动完成下载、授权、启动全流程：

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

2. 配置主控端地址

脚本运行后，会自动提示输入主控端地址，按照格式填写即可：

格式示例：http://你的主控IP:8080
填写完成按回车，脚本自动完成剩余配置

3. 部署完成

脚本执行无报错，即代表GinCdn V1.0.4被控节点部署成功。

三、部署成功验证（必查）

部署完成后，执行以下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

四、日常运维命令

1. 服务管理

# 启动节点服务
systemctl start ws_config_client.service
# 停止节点服务
systemctl stop ws_config_client.service
# 重启节点服务
systemctl restart ws_config_client.service

2. 修改主控地址（配置错误时使用）

# 替换配置文件中的主控地址
sed -i "s|MASTER_API_URL=\".*\"|MASTER_API_URL=\"新主控地址\"|g" /opt/gincdn/conf/node_config.conf
# 重启服务生效
systemctl restart ws_config_client.service

3. 卸载被控节点

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

五、常见问题解决方案

1. 脚本下载失败

解决方案：命令已强制使用HTTP1.1协议，重新执行一键部署命令即可

2. 解压失败（unzip: command not found）

apt install -y unzip

3. 服务启动失败

systemctl daemon-reload
systemctl restart ws_config_client.service

教程总结

GinCdn V1.0.4被控节点仅需1条命令即可完成部署，适配Ubuntu全版本
核心流程：执行一键命令 → 输入主控地址 → 验证服务状态
部署完成后，服务自动配置开机自启，无需手动干预