从零开始部署 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
# 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
如果你希望用 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";
}
}
curl http://主控IP:8080/api/health);
② 节点 ID 与密钥是否复制正确;③ 节点日志 journalctl -u gincdn-agent -n 100。
-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 才会连同数据一起删除。
联系客服,我们会尽快帮你排查。