GinCdn被控节点V1.0.4 安装教程（Ubuntu 18~24 通用，推荐 Ubuntu 24.04｜2H2G~16H32G）

前言

GinCdn 是一款轻量、高性能、易部署的国产内容分发系统，采用主控+边缘节点架构，支持缓存加速、HTTPS、智能调度、WAF 防护等企业级功能。
本文基于 GinCdn V1.0.4 版本，提供 Ubuntu 全系列（18.04/20.04/22.04/24.04）被控节点安装教程，推荐优先使用 Ubuntu 24.04 LTS，性能与兼容性最佳。
全程一条命令全自动部署，无需手动编译、无需改配置，新手也能 3 分钟上线节点。

一、环境要求

1. 操作系统

支持：Ubuntu 18.04 / 20.04 / 22.04 / 24.04（64位）
推荐：Ubuntu 24.04 LTS（内核新、性能强、依赖更完整）

2. 服务器配置（根据业务选择）

测试/轻量业务：2H2G
常规业务：4H4G / 4H8G / 8H8G / 8H16G
高并发大流量：16H16G / 16H32G

3. 网络与权限

必须使用 root 权限 执行
服务器可访问公网

二、一键部署命令（核心）

直接复制以下完整命令粘贴执行，自动下载、授权、运行一条龙：

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

命令说明

--http1.1 强制使用 HTTP/1.1，解决部分服务器 HTTP/2 下载失败问题
自动保存脚本到 /root/start.sh
自动赋予执行权限并启动安装

三、安装过程说明

1. 脚本执行成功截图特征（可直接截终端配图）

你可以在 CSDN 文章里放一张终端成功执行的示例图，描述如下：

✅ 脚本正常运行特征：

出现 100% 下载进度条
自动更新 apt、安装依赖（curl/wget/openssl/unzip 等）
自动部署 OpenResty + WS 配置客户端
中途提示输入 主控地址
无红色报错、无中断、无异常退出

示例截图描述文案：

如下图所示，脚本正常执行会持续输出部署日志，无红色报错，最后提示服务启动成功即表示部署完成。

2. 输入主控地址

安装过程中会提示：

请输入主控端API地址:

按格式输入：

http://主控IP:8080

输入完成按回车，后续全自动完成。

四、部署成功验证

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

# 查看日志
journalctl -u ws_config_client.service -f

2. 修改主控地址

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

3. 卸载节点

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

六、常见问题排查（完整版 CSDN 必备）

1. 脚本下载失败 curl:(92) HTTP/2 stream error

原因： 服务器对 HTTPS/HTTP2 兼容差
解决：
本文命令已加 --http1.1，重新复制执行即可。

2. 报错 unzip: command not found

apt update && apt install unzip -y

3. 服务启动失败显示 inactive (dead)

systemctl daemon-reload
systemctl restart ws_config_client.service

4. 节点连不上主控

可能原因：

主控地址写错
8080 端口未通
安全组/防火墙未放行
主控服务未启动

排查：

ping 主控IP
telnet 主控IP 8080

5. 提示脚本被篡改/密钥错误

解决：
删除旧脚本重新执行：

rm -f /root/start.sh

再重新执行一键安装命令。

七、总结

GinCdn V1.0.4 被控节点在 Ubuntu 18~24 全版本 均可稳定运行，推荐 Ubuntu 24.04 性能最佳。
部署仅需一条命令，全自动配置、自动注册、自动开机自启，适合大量边缘节点批量部署。
配置从 2H2G 到 16H32G 全覆盖，可满足个人测试、企业高并发 CDN 分发场景。

GinCdn CDN部署 Ubuntu24 被控节点 运维一键脚本 OpenResty 国产CDN