文档

GinCdn 部署文档

从零开始部署 GinCdn 主控端与边缘节点,包含环境要求、一键安装、手工安装与常见问题。

① 环境要求

项目要求
操作系统CentOS 7+ / RHEL / Rocky / AlmaLinux / Ubuntu 18.04+ / Debian 10+
CPU 架构x86_64(amd64)、aarch64(arm64)、armv7l
主控端内存建议 ≥ 1 GB
节点内存建议 ≥ 512 MB(缓存越大越好)
主控端口8080(管理后台 + API)
节点端口80 / 443(承载流量)
数据库内置 SQLite,无需额外部署

节点使用用户态 I/O 限流,不需要 root 权限,也不需要内核模块或 iptables 规则。

② 一键安装(推荐)

先登录本站 用户中心,在「我的授权」中拿到授权码,然后在服务器上执行:

安装主控端
curl -fsSL https://cdnhost.zheyunidc.cn/install.sh | sudo bash -s -- master --license 你的授权码
安装边缘节点
curl -fsSL https://cdnhost.zheyunidc.cn/install.sh | sudo bash -s -- agent --license 你的授权码 --master https://cdnhost.zheyunidc.cn
💡
安装脚本会自动完成:创建专用系统用户、随机化密钥、注册 systemd 开机自启、轮询健康检查、修改默认管理员密码。

③ 手工安装

# 1. 下载并解压发布包
mkdir -p /opt/gincdn && cd /opt/gincdn
curl -fsSL https://cdnhost.zheyunidc.cn/download/gincdn-latest-linux-amd64.tar.gz -o pkg.tar.gz && tar xzf pkg.tar.gz --strip-components=1

# 2. 生成配置
cp config.example.yaml config.yaml
vi config.yaml          # 按需修改端口、站点名等

# 3. 启动(前台试跑)
./gincdn -c config.yaml

④ 添加边缘节点

1. 登录主控后台(https://cdnhost.zheyunidc.cn:8080),进入「节点管理」→「添加节点」。

2. 复制系统生成的 节点 ID 与 节点密钥。

3. 在节点服务器上执行安装命令,或手工运行:

./gincdn-agent \
  -master https://cdnhost.zheyunidc.cn:8080 \
  -id 节点ID \
  -secret 节点密钥 \
  -name 节点名称 \
  -cache-dir /var/cache/gincdn \
  -cache-mb 4096

⑤ 前置 Nginx 配置(可选)

如果你希望用 80 端口访问管理后台,或者需要 HTTPS,可以在前面挂一层 Nginx 反代主控端口:

server {
    listen 80;
    server_name panel.example.com;

    location / {
        proxy_pass http://127.0.0.1:8080;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
    }
}

⑥ 常见问题

节点启动后一直显示离线?
依次检查:① 节点服务器能否访问主控的 8080 端口(curl http://主控IP:8080/api/health); ② 节点 ID 与密钥是否复制正确;③ 节点日志 journalctl -u gincdn-agent -n 100。
授权校验失败怎么办?
确认授权状态为「正常」且未过期;确认节点服务器可以访问授权接口地址; 如果使用授权校验接口,请检查主控配置中的 license 密钥是否与本授权中心一致。
怎么更换缓存目录?
编辑节点启动参数中的 -cache-dir,或修改 systemd 的 ExecStart 后执行 systemctl daemon-reload && systemctl restart gincdn-agent。注意预留足够磁盘空间。
如何升级到新版本?
重新下载新版发布包,执行 sudo bash install.sh master(或 agent)。 安装脚本会保留已有 config.yaml 中的密钥与数据,只替换二进制文件与前端资源。
卸载会删除数据吗?
sudo bash install.sh uninstall 只移除 systemd 服务与程序,保留 /opt/gincdn 数据目录; 加 --purge 才会连同数据一起删除。

遇到文档没覆盖的问题?

联系客服,我们会尽快帮你排查。

进入用户中心