GinCdn内容分发系统Ubuntu18-24被控节点部署安装教程GinCdn是一款轻量级的内容分发系统本文将详细讲解在Ubuntu 18.04~24.04系统中如何快速部署GinCdn被控节点全程通过命令行操作新手也能轻松上手。一、部署前准备1. 环境要求系统版本Ubuntu 18.04/20.04/22.04/24.0464位网络要求服务器可访问公网且80/443/8080端口根据主控端配置可正常通信配置要求2H2G、2H4G、4H4G、4H8G、8H2G、8H4G、8H8G、8H16G、16H16G、16H2G、16H4G、16H8G、16H32G等规格根据业务负载选择权限要求使用 root 用户执行命令非 root 需在命令前加sudo2. 基础依赖检查提前安装基础网络工具可选脚本会自动安装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.sh3. 配置主控地址脚本执行过程中会提示输入主控地址格式示例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.sh2. 验证主控地址配置检查配置文件中主控地址是否正确grep MASTER_API_URL /opt/gincdn/conf/node_config.conf成功标志输出显示你配置的主控地址示例MASTER_API_URLhttp://192.168.1.100:80803. 检查开机自启确认服务已配置开机自启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 unzip3. 服务启动失败Active: inactive (dead)解决方案# 重新加载服务配置 systemctl daemon-reload # 重启服务 systemctl restart ws_config_client.service4. 主控地址配置错误修改配置文件并重启服务# 编辑配置文件 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.service2. 卸载节点可选# 停止服务 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 系统不同配置的服务器均可按需部署满足各类内容分发场景的需求