宝塔面板不支持gin一键部署，需手动配置go环境（解压至/usr/local、写/etc/profile.d/go.sh设goroot和path）、gin监听:8080（非127.0.0.1:8080）、nginx反向代理目标填http://127.0.0.1:8080。
宝塔面板本身不支持 Gin 一键部署，必须手动配置 Go 环境 + 编译运行 + Nginx 反向代理，三步缺一不可；否则你会遇到 go: command not found、域名打不开、502 Bad Gateway 或进程启动后秒退等问题。
为什么宝塔里装不了 Go？
宝塔软件商店没有 Go 安装包，这不是功能缺失，而是 Go 官方明确不推荐通过包管理器（如 yum/apt）安装。它要求你下载官方二进制包、解压到 /usr/local、并配置系统级 PATH —— 否则宝塔后台调用的 www 用户根本找不到 go 命令。
常见错误现象：go version 在 SSH 终端能执行，但在宝塔「终端」或「计划任务」里报错；或者 Go 项目在「Go项目管理器」中启动失败，日志为空。
- 必须把
GOROOT和PATH写入/etc/profile.d/go.sh（不能只改~/.bashrc） - 内容示例：
export GOROOT=/usr/local/go<br>export PATH=$GOROOT/bin:$PATH
- 执行
sudo chmod +x /etc/profile.d/go.sh并切到www用户验证：sudo -u www go version
router.Run() 怎么写才对外可访问？
Gin 默认监听 127.0.0.1:8080 是安全行为，但会导致反向代理失效：Nginx 从本机发请求时，若你的代码写的是 router.Run("127.0.0.1:8080")，Go 进程只绑定了回环地址，拒绝来自本机其他 IP（包括 127.0.0.1 的非 loopback 接口）的连接。
验证方式：部署后执行 ss -tlnp | grep :8080，输出中必须含 *:8080 或 0.0.0.0:8080，而非 127.0.0.1:8080。
- ✅ 正确写法：
router.Run(":8080")（等价于"0.0.0.0:8080"） - ❌ 错误写法：
router.Run("127.0.0.1:8080")、router.Run("localhost:8080")、router.Run("::1:8080") - 如果你用 systemd 托管服务，还要确保
User=www，且WorkingDirectory指向项目根目录
Nginx 反向代理目标 URL 填什么？
宝塔的「网站 → 反向代理」页面里，“目标URL”必须填 http://127.0.0.1:8080，不能带 https、不能填公网 IP、不能加路径前缀（如 /api）—— Gin 本身已处理全部路由，Nginx 只负责流量转发。
容易踩的坑：502 Bad Gateway 多数是因为目标 URL 填成了 http://yourdomain.com:8080 或 https://127.0.0.1:8080，导致 Nginx 无法建立 HTTP 连接。
- 确认 Go 进程已运行：
ps aux | grep app（假设你编译出的二进制叫app） - 确认端口未被占用：
lsof -i :8080或netstat -tuln | grep :8080 - 国内环境务必设置代理：
go env -w GOPROXY=https://goproxy.cn,direct，否则go get会超时失败
真正卡住人的地方，往往不是代码写错，而是 Go 进程监听地址和 Nginx 代理目标地址没对齐 —— 一个绑 0.0.0.0，另一个却连 127.0.0.1，看似都“本地”，实则网络栈层面不通。
