常见安装问题
安装阶段的高频问题速查。没找到你的问题?去 反馈建议 或 QQ 交流群提问。
安装与启动
| 现象 | 怎么办 |
|---|---|
| 安装向导页面打不开 | 云安全组 + 服务器防火墙都放行脚本打印的 TCP 端口(如 8080);宝塔表单里的项目端口要与脚本打印的一致 |
| 提示 MySQL 没装 / 3306 没监听 | 宝塔「软件商店」装 MySQL 8.0,装完重跑 ./install.sh --bt;不用自己建库 |
| MySQL 版本低于 8.0 / 是 MariaDB | 别折腾升级,改用 Docker 安装(自带独立 MySQL 8 容器,不影响原库) |
启动报 nohup ... config.yaml: No such file or directory | 宝塔「执行命令」填错了,改成完整的 ./go_fan config.yaml |
| 宝塔「数据库」页看不到程序的数据库 | 正常:向导直接用 MySQL 建库,不经过宝塔添加流程;凭据在后台「系统 → 数据库」页可查看 |
| 向导完成后长时间不跳转 | 回宝塔「网站 → Go 项目」对 go_fan 点一下「启动 / 重启」,再刷新页面 |
访问问题
| 现象 | 怎么办 |
|---|---|
| 域名 / IP 打不开 | 域名访问只放行 80/443;http://IP:端口 直连时要放行项目端口;确认域名 A 记录已生效 |
只能 http://域名:8080 访问 | 宝塔 Go 项目把「运行用户」从 www 改为 root,保存重启;「系统自检 → 域名直连(80)」核对 |
| 自定义端口访问不了 | 80 被占用且没有 nginx 时,程序才会使用自定义端口——这是唯一需要你放行端口的场景:去云安全组 / 服务器防火墙放行向导里填的端口 |
| 装完向导页一直没跳登录页 | 自动拉起偶尔失败:页面会给手动指引(宝塔用户回「网站 → Go 项目」点一下「启动」),操作后直接访问打印的地址即可 |
| 站点被旧配置抢占(反代异常) | 站点管理勾选站点 → 「批量生成反代」:为被旧通配抢占 / 无反代接管的域名逐个生成专属反代,不改动旧站点配置(1.1.48+) |
授权相关(安装期)
| 现象 | 怎么办 |
|---|---|
| 显示「待激活」/ 前台打不开 | 装的时候没填授权码:进后台「系统更新」页填授权码激活;没有授权码就把页面上的机器码发给客服购买 |
| 提示「设备超限」 | 授权码绑定的机器满了:到 188mi 会员中心「我的授权」解绑旧设备后重试 |
| 忘记后台密码 | 到 188mi 会员中心「我的授权」→ 找回,邮箱验证后新密码自动生效,不用登录服务器;详见 解绑与密码找回 |
i一键自检
后台「系统自检」页集中展示数据库 / Redis / 授权 / 更新 / 反代 / 端口状态,异常项附中文原因与修复入口(含一键修复按钮),遇到问题先看这里。