零基础宝塔面板快速部署 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。若未开启SSLhttp://www.gincdn.cn若已开启SSLhttps://www.gincdn.cnlicense:你的授权码完成修改后保存文件。步骤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执行命令系统会自动生成一般保持默认点击“提交”然后点击“启动”按钮确认项目状态变为“运行中”。步骤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 默认密码及管理员后台默认账号密码以保障系统安全。
