GinCdn被控节点V1.0.7 安装教程（Ubuntu 18~24 通用，推荐 Ubuntu 24.04｜2H2G~16H32G）
GinCdn被控节点V1.0.7 安装教程（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.servicebash /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 -f2. 修改主控地址
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 -y3. 服务启动失败显示 inactive (dead)
systemctl daemon-reload systemctl restart ws_config_client.service4. 节点连不上主控
可能原因：
- 主控地址写错
- 8080 端口未通
- 安全组/防火墙未放行
- 主控服务未启动
排查：
ping 主控IP telnet 主控IP 8080七、总结
GinCdn V1.0.7 被控节点在Ubuntu 18~24 全版本均可稳定运行，推荐 Ubuntu 24.04性能最佳。
部署仅需一条命令，全自动配置、自动注册、自动开机自启，适合大量边缘节点批量部署。
配置从 2H2G 到 16H32G 全覆盖，可满足个人测试、企业高并发 CDN 分发场景。