GinCdn内容分发系统Ubuntu18-24被控节点部署安装教程

GinCdn是一款轻量级的内容分发系统，本文将详细讲解在Ubuntu 18.04~24.04系统中，如何快速部署GinCdn被控节点，全程通过命令行操作，新手也能轻松上手。
gincdn透明.png

一、部署前准备

1. 环境要求

系统版本：Ubuntu 18.04/20.04/22.04/24.04（64位）
网络要求：服务器可访问公网，且80/443/8080端口（根据主控端配置）可正常通信
配置要求：2H2G、2H4G、4H4G、4H8G、8H2G、8H4G、8H8G、8H16G、16H16G、16H2G、16H4G、16H8G、16H32G等规格（根据业务负载选择）
权限要求：使用 root 用户执行命令（非 root 需在命令前加sudo）

2. 基础依赖检查

提前安装基础网络工具（可选，脚本会自动安装）：

apt update -y && apt install -y curl wget

二、一键部署步骤

1. 下载部署脚本

执行以下命令下载官方部署脚本，并赋予执行权限（核心命令，解决HTTP/2协议兼容问题）：

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

执行成功标志：

  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
100 10932  100 10932    0     0   254k      0 --:--:-- --:--:-- --:--:--  254k

显示100%下载完成且无报错，说明脚本下载成功。

2. 运行部署脚本

执行下载好的脚本，启动全自动部署流程：

/root/start.sh

3. 配置主控地址

脚本执行过程中会提示输入主控地址，格式示例：http://192.168.1.100:8080（替换为你的实际主控端地址）：

三、部署结果验证

1. 检查服务状态

执行以下命令查看GinCdn节点服务状态：

systemctl status ws_config_client.service

成功标志：输出中包含Active: active (running)，示例：

● ws_config_client.service - GinCDN WS配置客户端服务
     Loaded: loaded (/etc/systemd/system/ws_config_client.service; enabled; vendor preset: enabled)
     Active: active (running) since Sat 2026-03-07 17:48:08 UTC; 1min ago
   Main PID: 118070 (bash)
      Tasks: 5 (limit: 9507)
     Memory: 13.3M
     CGroup: /system.slice/ws_config_client.service
             └─118070 /bin/bash /opt/gincdn/ws_config_client.sh

2. 验证主控地址配置

检查配置文件中主控地址是否正确：

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

成功标志：输出显示你配置的主控地址，示例：

MASTER_API_URL="http://192.168.1.100:8080"

3. 检查开机自启

确认服务已配置开机自启：

systemctl is-enabled ws_config_client.service

成功标志：输出enabled。

四、常见问题解决

1. 脚本下载失败（curl: (92) HTTP/2 stream 0 was not closed cleanly）

原因：目标服务器HTTP/2协议兼容问题，解决方案：使用--http1.1参数强制HTTP/1.1协议（本文核心命令已包含）。

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

原因：未安装unzip工具，解决方案：

apt install -y unzip

3. 服务启动失败（Active: inactive (dead)）

解决方案：

# 重新加载服务配置
systemctl daemon-reload
# 重启服务
systemctl restart ws_config_client.service

4. 主控地址配置错误

修改配置文件并重启服务：

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

五、日常运维命令

1. 服务启停

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

2. 卸载节点（可选）

# 停止服务
systemctl stop ws_config_client.service
# 禁用开机自启
systemctl disable ws_config_client.service
# 删除相关文件
rm -rf /root/gincdn.sh /opt/gincdn /etc/systemd/system/ws_config_client.service
# 重新加载服务配置
systemctl daemon-reload

总结

GinCdn 被控节点在 Ubuntu 18~24 系统中的部署流程高度自动化，核心步骤仅需「下载脚本→运行脚本→配置主控地址」三步，全程无需手动修改配置文件。部署完成后重点验证服务是否为active (running)状态，确保节点与主控端正常通信。该部署方案适配全版本 Ubuntu 系统，不同配置的服务器均可按需部署，满足各类内容分发场景的需求

GinCdn内容分发系统Ubuntu18-24被控节点怎么部署安装？