GinCdn被控节点V1.0.4 安装教程Ubuntu 18~24 通用推荐 Ubuntu 24.042H2G~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.0464位推荐Ubuntu 24.04 LTS内核新、性能强、依赖更完整2. 服务器配置根据业务选择测试/轻量业务2H2G常规业务4H4G / 4H8G / 8H8G / 8H16G高并发大流量16H16G / 16H32G3. 网络与权限必须使用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 -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.service3. 卸载节点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 foundapt update apt install unzip -y3. 服务启动失败显示 inactive (dead)systemctl daemon-reload systemctl restart ws_config_client.service4. 节点连不上主控可能原因主控地址写错8080 端口未通安全组/防火墙未放行主控服务未启动排查ping 主控IP telnet 主控IP 80805. 提示脚本被篡改/密钥错误解决删除旧脚本重新执行rm -f /root/start.sh再重新执行一键安装命令。七、总结GinCdn V1.0.4 被控节点在Ubuntu 18~24 全版本均可稳定运行推荐 Ubuntu 24.04性能最佳。部署仅需一条命令全自动配置、自动注册、自动开机自启适合大量边缘节点批量部署。配置从 2H2G 到 16H32G 全覆盖可满足个人测试、企业高并发 CDN 分发场景。
GinCdn被控节点V1.0.4 安装教程（Ubuntu 18~24 通用，推荐 Ubuntu 24.04｜2H2G~16H32G）
GinCdn被控节点V1.0.4 安装教程Ubuntu 18~24 通用推荐 Ubuntu 24.042H2G~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.0464位推荐Ubuntu 24.04 LTS内核新、性能强、依赖更完整2. 服务器配置根据业务选择测试/轻量业务2H2G常规业务4H4G / 4H8G / 8H8G / 8H16G高并发大流量16H16G / 16H32G3. 网络与权限必须使用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 -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.service3. 卸载节点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 foundapt update apt install unzip -y3. 服务启动失败显示 inactive (dead)systemctl daemon-reload systemctl restart ws_config_client.service4. 节点连不上主控可能原因主控地址写错8080 端口未通安全组/防火墙未放行主控服务未启动排查ping 主控IP telnet 主控IP 80805. 提示脚本被篡改/密钥错误解决删除旧脚本重新执行rm -f /root/start.sh再重新执行一键安装命令。七、总结GinCdn V1.0.4 被控节点在Ubuntu 18~24 全版本均可稳定运行推荐 Ubuntu 24.04性能最佳。部署仅需一条命令全自动配置、自动注册、自动开机自启适合大量边缘节点批量部署。配置从 2H2G 到 16H32G 全覆盖可满足个人测试、企业高并发 CDN 分发场景。
