零基础!宝塔面板快速部署 GinCdn V1.1.0 主控端(含 Redis 配置)
GinCdn 作为一款轻量高效的自研 CDN 系统,依托 Go 语言的高性能特性,是中小型企业和个人搭建专属 CDN 的理想选择。本文将手把手教你通过宝塔面板,以可视化方式完成 GinCdn 主控端部署,无需复杂命令行,即使零基础也能轻松上手!
📦 前置准备
在开始部署前,请确保你已具备以下条件:
| 项目 | 要求 |
|---|---|
| 服务器 | CentOS 7.6-7.9 / Ubuntu 20.04/22.04(建议 2核4G及以上) |
| 宝塔面板 | 版本 v11.0+,并已安装 Nginx 1.18+ / Apache 2.2+、MySQL 5.7+、Redis 5.0+ |
| 域名 | 已解析至服务器 IP 的域名(用于主控端访问) |
🚀 详细部署步骤
步骤1:创建数据库
- 登录宝塔面板,进入“数据库”菜单。
- 点击“添加数据库”,创建一个专属数据库(例如命名为
gincdn_db)。 - 系统会自动生成数据库名、用户名和密码,请务必记录下来,后续配置需要用到。
步骤2:上传并解压 GinCdn 源码
- 在宝塔面板“文件”菜单中,进入网站根目录(如
/wwwroot/),新建一个项目文件夹(例如gincdn)。 - 进入该文件夹,点击“上传”,将本地下载的 GinCdn 源码压缩包(
.zip或.tar.gz)上传。 - 右键压缩包,选择“解压”,确认解压后目录中包含
main.go、config.yaml等核心文件。
步骤3:配置 GinCdn 参数
编辑源码目录下的config.yaml文件,根据你的环境填写以下关键配置:
端口配置
设置主控端运行端口(如8080),确保该端口未被其他程序占用。
port:8080数据库配置
填写步骤1中创建的数据库信息。
database:host:localhostport:3306name:gincdn_db# 数据库名user:your_user# 数据库用户名password:your_pass# 数据库密码文件访问URL配置
填写你解析好的主控端域名(例如www.gincdn.cn)。
- 若未开启SSL:
http://www.gincdn.cn - 若已开启SSL:
https://www.gincdn.cn
license:你的授权码完成修改后,保存文件。
步骤4:导入数据库
- 在源码解压后的目录中,找到
gincdn.sql文件。 - 返回宝塔面板的“数据库”菜单,点击你创建的数据库右侧的“导入”。
- 选择
gincdn.sql文件,上传并执行导入。这一步会在数据库中创建必要的表结构。
步骤5:配置 Redis 并放行端口
Redis 配置
- 在宝塔面板“软件商店”中找到已安装的 Redis,点击“设置”。
- 将
bind参数修改为0.0.0.0,允许外部连接。 - 设置
requirepass参数为123456(启动成功后请务必修改为强密码)。 - 保存配置并重启 Redis 服务。
放行端口
- 进入宝塔面板的“安全”菜单。
- 添加放行规则:端口
6379,协议TCP,所有IP。 - 同样放行你主控端配置的运行端口(如
8080)。
步骤6:创建 Go 项目
- 进入宝塔面板的“网站”菜单,点击“Go项目”。
- 点击“添加Go项目”,填写以下信息:
- 项目路径:选择你的 GinCdn 源码目录(如
/wwwroot/gincdn) - 运行文件:选择启动文件
main.go - 运行端口:填写你在
config.yaml中配置的端口(如8080) - 执行命令:系统会自动生成,一般保持默认
- 项目路径:选择你的 GinCdn 源码目录(如
- 点击“提交”,然后点击“启动”按钮,确认项目状态变为“运行中”。
步骤7:验证访问
通过 IP 访问
在浏览器中输入:http://你的服务器IP:8080,如果看到 GinCdn 主控端页面,说明启动成功!
通过域名访问
- 在宝塔“网站”菜单中添加一个站点,绑定你准备好的域名。
- 为该站点配置反向代理,目标URL为
http://127.0.0.1:8080。 - 访问你的域名,同样能看到主控端页面即配置正确。
后台登录
- 管理员控制台:
http://你的域名或IP:端口/admin(默认账号admin/ 密码123456) - 用户控制台:
http://你的域名或IP:端口/user
🛠️ 常见问题排查
| 问题现象 | 可能原因 | 解决方案 |
|---|---|---|
| 运行报错 | 数据库未正确导入或配置错误 | 检查config.yaml中的数据库连接信息,确认已导入gincdn.sql |
| 端口无法访问 | 服务器防火墙未放行 | 在宝塔“安全”菜单中放行对应端口,若使用云服务器还需在控制台安全组放行 |
| Redis 连接失败 | bind未设置或密码错误 | 确认 Redis 配置中bind 0.0.0.0且密码与config.yaml中一致 |
| 无法通过域名访问 | 反向代理配置错误 | 检查站点设置中的代理目标地址是否为http://127.0.0.1:8080 |
💎 总结
通过宝塔面板可视化操作,无需手动配置复杂的环境变量和服务脚本,即可快速完成GinCdn V1.1.0 主控端的部署。最新版本新增了 Redis 依赖,只需按照本文设置bind 0.0.0.0、初始密码123456并放行6379端口,即可一键启动。
部署完成后,你就可以通过主控端来管理节点、配置缓存规则、添加 WAF 防护,轻松搭建属于自己的企业级 CDN 体系!
注意:生产环境请务必修改 Redis 默认密码及管理员后台默认账号密码,以保障系统安全。