生产环境部署Gin必须禁用调试模式（gin.ReleaseMode）、绑定127.0.0.1端口、由Nginx反向代理透传请求，并通过systemd托管进程、对齐超时配置、规范日志与用户权限。
直接上生产环境跑 gin.Default() 是危险的，必须禁用调试输出、绑定正确地址、配合反向代理。Ubuntu 上部署 Gin 应用不是“扔个二进制上去就完事”，核心在于：进程守护、端口隔离、日志落盘、与 Nginx 协同。
编译时关掉调试模式和控制台颜色
Go 编译出的二进制默认带调试信息，gin.Default() 会开启 gin.DebugMode，打印详细错误堆栈并暴露内部路径——这在生产环境等于裸奔。
- 启动前必须调用
gin.SetMode(gin.ReleaseMode)或在编译前设环境变量GIN_MODE=release - 加上
gin.DisableConsoleColor()，避免日志里混入 ANSI 转义符，干扰日志收集（比如journalctl或 filebeat） - 不要用
r.Run(":8080")绑定0.0.0.0:8080；改用r.Run("127.0.0.1:8080")，只允许本地回环访问，把端口暴露权交给 Nginx
Nginx 反向代理配置要精简且明确
很多人在 /etc/nginx/sites-available/ 里抄一堆无关配置，结果 502 都不知道为啥。Gin 是纯 HTTP 服务，不需要重写、不需要 proxy_buffering 开关、不需要 special headers —— 只要正确透传。
- 确保 Nginx 已安装并运行：
sudo systemctl status nginx状态为 active - 新建配置文件，比如
/etc/nginx/sites-available/myapi，内容只要这几句：
upstream gin_backend {
server 127.0.0.1:8080;
}
server {
listen 80;
server_name api.example.com;
location / {
proxy_pass http://gin_backend;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}
}
- 启用配置：
sudo ln -sf /etc/nginx/sites-available/myapi /etc/nginx/sites-enabled/，再sudo nginx -t && sudo systemctl reload nginx - 别漏掉
proxy_set_header X-Real-IP，否则 Gin 里c.ClientIP()拿到的是127.0.0.1
用 systemd 托管进程，别用 nohup 或 screen
手动 ./myapp & 启动，崩溃后不会自拉起，日志不归档，升级还得手动 kill —— 这不是部署，是临时凑合。
- 新建 service 文件：
/etc/systemd/system/gin-myapp.service - 内容示例（注意 WorkingDirectory 和 User）：
[Unit] Description=Gin API Service After=network.target [Service] Type=simple User=www-data WorkingDirectory=/opt/myapp ExecStart=/opt/myapp/myapp Restart=always RestartSec=10 StandardOutput=journal StandardError=journal [Install] WantedBy=multi-user.target
- 启用并启动：
sudo systemctl daemon-reload && sudo systemctl enable --now gin-myapp - 查状态：
sudo systemctl status gin-myapp；看日志：sudo journalctl -u gin-myapp -f - 别用 root 启动，
User=www-data更安全；Restart=always是关键，挂了自动重启
真正容易被忽略的是：Nginx 和 Gin 的超时设置要对齐。比如 Nginx 默认 proxy_read_timeout 60，但 Gin 里没设 http.Server.ReadTimeout，长请求可能被 Nginx 中断却无提示。上线前务必检查两边 timeout 值是否匹配。
