文档导读

GinCdn 是一套自建 CDN 内容分发系统，采用「主控 + 被控节点」架构，把 CDN 加速、节点管理、DDoS 防御、CC 防护与 WAF 能力整合到一个控制台。

本套文档面向第一次部署 GinCdn 的用户，按「先装主控、再加节点、最后运维升级」的顺序组织，全程给出可直接复制执行的命令。

架构说明

text

                    ┌──────────────────────┐
                    │   用户 / 访客请求     │
                    └───────────┬──────────┘
                                │
                    ┌───────────▼──────────┐
                    │  被控节点（边缘节点）  │  ← 缓存加速 / CC 防护 / WAF
                    │  OpenResty + WAF      │
                    └───────────┬──────────┘
                                │ 回源
                    ┌───────────▼──────────┐
                    │        源站           │
                    └──────────────────────┘
                                ▲
                    ┌───────────┴──────────┐
                    │  主控端（控制台）      │  ← 统一下发配置、证书、策略
                    │  Go + MySQL + Redis   │
                    └──────────────────────┘

角色	作用	部署位置
主控端	管理后台，负责站点、节点、证书、套餐、用户、防护策略的统一管理与下发	一台具备公网 IP 的服务器，建议 2 核 4G 以上
被控节点	实际承载流量转发的边缘节点，负责缓存加速与安全防护	可多台，分布在不同区域/线路，2H2G 起步

主控与被控的关系

被控节点通过 --master-url 参数连接主控端，由主控端统一下发配置。因此主控端必须先部署完成并可访问，再安装被控节点。

阅读顺序

步骤	文档	说明
1	环境要求与准备	确认系统版本、配置、端口与依赖
2	主控端安装（宝塔面板）	部署主控端并进入管理后台
3	被控节点安装（Ubuntu）	一键部署边缘节点并绑定到主控
4	被控节点更新	已部署节点的组件升级
5	常用运维命令	日常启停、查看状态与日志
6	常见问题排查	部署与运行中的高频问题

控制台入口

主控端启动成功后，默认提供两个控制台：

控制台	地址	默认账号
管理员控制台	`http://你的域名或IP:端口/admin`	`admin` / `123456`
用户控制台	`http://你的域名或IP:端口/user`	由管理员在后台创建

部署完成后请立即修改默认密码

默认账号密码是公开的初始值，正式使用前务必修改管理员密码，并同步更换 Redis 密码。

在线演示

在正式部署前，可以先登录官方演示环境体验控制台功能：

管理员控制台：http://demo.gincdn.cc/web/#/admin ，账号 admin / 123456
用户控制台：http://demo.gincdn.cc/web/#/user ，账号 gincdn / 123456

文档约定

命令中的 http://192.168.1.100:8080 均为示例主控地址，请替换为你自己的实际地址。
被控节点相关命令默认使用 root 权限 执行，非 root 用户请加 sudo。
标注为 Ubuntu 的命令，在 Ubuntu 18.04 / 20.04 / 22.04 / 24.04 上通用。
本站文档基于 GinCdn V1.2.0。版本差异请对照版本更新日志。

文档导读 ​

架构说明 ​

阅读顺序 ​

控制台入口 ​