GinCdn被控节点V1.0.8 安装教程（Ubuntu 18~24 通用，推荐 Ubuntu 24.04

GinCdn被控节点V1.0.8 安装教程（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/gincdn-install https://www.gincdn.cn/download/ubuntu/gincdn-install && chmod +x gincdn-install && sudo ./gincdn-install

命令说明

用法: gincdn-install --master-url <url> 完整部署并指定主控地址 gincdn-install --update-master-url <url> 更新主控地址 gincdn-install --help 显示此帮助信息 示例: gincdn-install --master-url http://192.168.1.100:8080 gincdn-install --update-master-url http://192.168.1.200:8080 常用命令（部署完成后）: 启动: /usr/local/openresty/nginx/sbin/nginx 停止: /usr/local/openresty/nginx/sbin/nginx -s stop 重载: /usr/local/openresty/nginx/sbin/nginx -s reload

三、执行自动化安装

sudo ./gincdn-install --master-url http://192.168.1.100:8080

安装部署成功

下面这个就是因为主控后台没添加绑定该节点信息

需要手动添加一下才可以

添加节点信息时，节点名称不能有任何空格，不然会导致连接不上

添加完之后，手动执行下命令

# 重启服务 systemctl restart ws_config_client.service

bash /opt/gincdn/client.sh

四、部署成功验证

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

六、常见问题排查

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

七、总结

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