☰
零基础!宝塔面板快速部署 GinCdn V1.1.0 主控端(含 Redis 配置)
2026/9/29 2:58:34 网站建设 项目流程

零基础!宝塔面板快速部署 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:创建数据库

  1. 登录宝塔面板,进入“数据库”菜单。
  2. 点击“添加数据库”,创建一个专属数据库(例如命名为gincdn_db)。
  3. 系统会自动生成数据库名、用户名和密码,请务必记录下来,后续配置需要用到。

步骤2:上传并解压 GinCdn 源码

  1. 在宝塔面板“文件”菜单中,进入网站根目录(如/wwwroot/),新建一个项目文件夹(例如gincdn)。
  2. 进入该文件夹,点击“上传”,将本地下载的 GinCdn 源码压缩包(.zip或.tar.gz)上传。
  3. 右键压缩包,选择“解压”,确认解压后目录中包含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:导入数据库

  1. 在源码解压后的目录中,找到gincdn.sql文件。
  2. 返回宝塔面板的“数据库”菜单,点击你创建的数据库右侧的“导入”。
  3. 选择gincdn.sql文件,上传并执行导入。这一步会在数据库中创建必要的表结构。

步骤5:配置 Redis 并放行端口

Redis 配置
  1. 在宝塔面板“软件商店”中找到已安装的 Redis,点击“设置”。
  2. 将bind参数修改为0.0.0.0,允许外部连接。
  3. 设置requirepass参数为123456(启动成功后请务必修改为强密码)。
  4. 保存配置并重启 Redis 服务。
放行端口
  1. 进入宝塔面板的“安全”菜单。
  2. 添加放行规则:端口6379,协议TCP,所有IP。
  3. 同样放行你主控端配置的运行端口(如8080)。

步骤6:创建 Go 项目

  1. 进入宝塔面板的“网站”菜单,点击“Go项目”。
  2. 点击“添加Go项目”,填写以下信息:
    • 项目路径:选择你的 GinCdn 源码目录(如/wwwroot/gincdn)
    • 运行文件:选择启动文件main.go
    • 运行端口:填写你在config.yaml中配置的端口(如8080)
    • 执行命令:系统会自动生成,一般保持默认
  3. 点击“提交”,然后点击“启动”按钮,确认项目状态变为“运行中”。

步骤7:验证访问

通过 IP 访问

在浏览器中输入:http://你的服务器IP:8080,如果看到 GinCdn 主控端页面,说明启动成功!

通过域名访问
  1. 在宝塔“网站”菜单中添加一个站点,绑定你准备好的域名。
  2. 为该站点配置反向代理,目标URL为http://127.0.0.1:8080。
  3. 访问你的域名,同样能看到主控端页面即配置正确。
后台登录
  • 管理员控制台: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 默认密码及管理员后台默认账号密码,以保障系统安全。

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询