Gin项目无需在服务器安装Go环境，编译为Linux二进制后即可运行；但必须正确配置Nginx反向代理（分离/api、/admin、/静态资源）、开放端口、设置数据库连接地址（非127.0.0.1）及使用systemd托管进程。
直接上结论：Gin 项目不需要在服务器上装 Go 环境，编译成二进制后丢到 ECS 就能跑；但必须配好 Nginx 反向代理、开放对应端口、处理好静态资源路径和数据库连接 —— 否则你访问得到 502 或空白页，不是代码问题，是部署链路断了。
怎么编译出可直接运行的 Gin 二进制文件
本地开发完，别传源码上去。用 go build 打包成 Linux 可执行文件，关键参数不能漏：
-
CGO_ENABLED=0：禁用 CGO，避免依赖系统库（CentOS 上没装 glibc-dev 会 panic） -
GOOS=linux GOARCH=amd64：明确目标平台（阿里云 ECS 多为 x86_64） -
-ldflags="-w -s"：剥离调试符号和 DWARF 信息，镜像/二进制体积小一半以上
示例命令：
CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -ldflags="-w -s" -o ginblog main.go
生成的 ginblog 文件直接 scp 到服务器任意目录（比如 /opt/ginblog），chmod +x 就能 ./ginblog 启动。注意：它默认监听 :8080，确保代码里没硬写 localhost:8080 这类地址（尤其是数据库或 Redis 配置）。
Nginx 反向代理配置必须隔离 /api 和静态资源
Gin 默认只管 API，前端 Vue/React 是单独构建的 dist 目录。Nginx 必须把请求分发对，否则 /admin 页面能打开但按钮点不动，或者 /api/login 404 —— 实际是 Nginx 根本没转发过去。
典型错误配置：location / { proxy_pass http://127.0.0.1:8080; } —— 这会让所有请求（包括 /index.html）都打给 Gin，而 Gin 没注册静态路由，直接 404。
正确做法是分三块：
-
location /：指向前端dist目录（如/opt/ginblog/web/front/dist） -
location /admin：指向管理后台dist（注意路径别少一级） -
location /api：proxy_pass http://127.0.0.1:8080/（结尾斜杠不能少，否则路径拼接错）
还要加 try_files $uri $uri/ /index.html; 防止前端路由刷新 404。
数据库和配置文件千万别打包进二进制
很多人把 config/app.ini 或 .env 和二进制一起上传，然后发现连不上 MySQL —— 因为配置里的 host = 127.0.0.1 在 ECS 上指的是容器/进程自身，不是宿主机 MySQL。
真实情况：
- 如果 MySQL 装在 ECS 本机：
host = 127.0.0.1可以，但得确认bind-address没设成127.0.0.1（否则远程连不了，本地却可以） - 如果用 RDS 或 Docker MySQL：
host必须填内网地址（如rm-xxx.mysql.rds.aliyuncs.com），且安全组放行 3306 -
app.ini必须放在二进制同级目录或指定路径，用./ginblog -c config/app.ini启动时显式加载
敏感配置（密码、密钥）绝不能写死在代码里，也别传 Git —— 用环境变量或挂载配置文件更安全。
怎么让 Gin 后台持续运行不退出
nohup ./ginblog & 最简单，但挂掉没法自动拉起；systemd 更稳，适合生产：
新建 /etc/systemd/system/ginblog.service：
[Unit] Description=Ginblog Backend After=network.target [Service] Type=simple User=root WorkingDirectory=/opt/ginblog ExecStart=/opt/ginblog/ginblog -c /opt/ginblog/config/app.ini Restart=always RestartSec=10 StandardOutput=journal StandardError=journal [Install] WantedBy=multi-user.target
然后执行：
systemctl daemon-reload systemctl enable ginblog systemctl start ginblog
检查状态：systemctl status ginblog。注意：如果报 failed to open config file，八成是路径写错或权限不够（chown root:root /opt/ginblog/config）。
真正容易被忽略的是日志轮转和内存泄漏监控 —— Gin 进程跑一周后 RSS 内存涨到 1.2G？那不是部署问题，是代码里 goroutine 泄漏或缓存没设 TTL。上线前先用 ab -n 1000 -c 100 http://your-ip/api/ping 压测看内存是否线性增长。
