快速安装向导推荐

推荐大多数用户使用的安装路径:以宝塔面板为例的标准流程,全程界面操作、照抄表单即可,不需要懂命令行。遇到问题可截图发给客服。

i没有宝塔面板?

先在服务器上安装宝塔面板(bt.cn 官方一键脚本),再回到本页照做;有老项目怕受影响、或 MySQL 低于 8.0 无法升级的服务器,改用 Docker 安装。

快速安装向导:完整六步

第 1 步:上传安装包并解压

宝塔面板「文件」→ 进入 /www/wwwroot/ → 上传 go_fan-v版本-linux-amd64.tar.gz → 右键「解压」,得到程序目录。
第 2 步:在宝塔「终端」跑安装预置脚本
打开宝塔左侧「终端」(黑窗口),逐行复制粘贴,每行回车一次:
bash
```
cd /www/wwwroot/go_fan-v1.1.54-linux-amd64   # 换成你的实际目录名
chmod +x install.sh go_fan bin/fetch-images
./install.sh --bt
```
脚本会设置文件权限、锁定访问端口,并打印一张「宝塔表单照抄清单」。它不碰你的数据库密码——数据库信息在安装向导第 1 步里填。脚本能正确识别宝塔安装的 MySQL(不在系统 PATH 里也能找到),「装没装 / 起没起」分开提示,不会误报。

!提示「本机没找到 MySQL」时

到宝塔「软件商店」→ 找到 MySQL → 安装 8.0 版本(已装的点【启动】),装完回终端再跑一次 ./install.sh --bt。MySQL 版本低于 8.0 或为 MariaDB 时,改用 Docker 安装。

第 3 步:宝塔添加 Go 项目(照抄清单)

宝塔面板 → 网站 → Go 项目 → 添加项目,逐项照抄脚本打印的清单:

表单项	填什么
项目执行文件	点「选择」,选中脚本打印的路径(形如 `/www/wwwroot/go_fan-v…/go_fan`)
项目名称	`go_fan`
项目端口	照抄脚本打印的端口(默认 8080,被占用时脚本会自动换)
执行命令	`./go_fan config.yaml`(完整照抄,不要只填 config.yaml)
环境变量	留空(脚本提示「未能自动获取公网 IP」时才填 `SETUP_PUBLIC_IP=你的公网IP`)
运行用户	`root`(统一填 root,装完即可域名直连访问)
开机启动	开启
绑定域名	有域名就填,每行一个;暂时没有可留空

填完点「提交」,然后点「启动」。

第 4 步:拿到安装链接,浏览器打开
程序首次启动会开启安装向导,链接形如 http://1.2.3.4:8080/?t=xxxx,必须整段复制(?t= 是一次性访问凭证,少了打不开)。链接从三处任取其一:
- 宝塔「网站 → Go 项目」→ go_fan「设置」→「项目日志」,搜 ?t=(最省事);
- 宝塔「文件」:打开 程序目录/storage/fan/setup-url,第一行即完整链接;
- 宝塔「终端」:第 2 步脚本最后打印的路径。
!打不开向导页?

八成是防火墙没放行:到云服务器控制台「安全组」放行脚本打印的 TCP 端口(如 8080),宝塔「安全」页防火墙放行同一端口,刷新浏览器即可,不用重启程序。
第 5 步:安装向导三步

① 数据库:主机 / 端口 / 账号默认即可,密码在宝塔「数据库」页上方「root密码」处复制,点「测试连接并自动建库」;② 授权码:粘贴验证,或留空跳过(页面顶部有机器码,买码时发给客服);③ 管理员密码:设置后台登录密码。部署模式与访问方式都不需要选,详见安装向导详解。
第 6 步:装完验证
- 打开 http://你的域名/ 或 http://公网IP:8080/,能看到站点首页;
- 后台 /admin 用 admin + 你设置的密码登录;
- 登录后打开「系统自检」:数据库、授权、域名访问是否正常一目了然。

域名直连(80 端口)说明

程序以 root 运行且 80 端口空闲时,域名直连自动开启——浏览器输 http://域名 即可,不用带端口。
宝塔机器上一般装着 Nginx(占 80 端口),程序不会抢占也不报错,域名访问二选一:① 在宝塔 Go 项目里绑定域名,由宝塔 Nginx 反代(还能顺带申请 HTTPS 证书);② 停用宝塔 Nginx,下次启动时域名直连自动生效。
装完发现只能 http://域名:8080 访问:到宝塔「Go 项目 → go_fan → 设置」把「运行用户」从 www 改为 root,保存重启;后台「系统自检 → 域名直连(80)」可核对是否生效。

卸载

bash

cd /www/wwwroot/go_fan-v1.1.54-linux-amd64
./install.sh --uninstall            # 常规卸载:停进程、清理反代配置(自动备份)、询问是否删库
./install.sh --uninstall --purge    # 彻底卸载:连程序目录一起删(重装前用)

卸载脚本只停进程,最后记得回宝塔「网站 → Go 项目」把 go_fan 项目删除。nginx 配置清理前会自动备份到 /root/go_fan-uninstall-backup-*。