Go程序部署必须先编译为静态链接、无依赖的二进制文件，禁用cgo以确保ldd显示“not a dynamic executable”，再通过systemd（Type=simple、Restart=always、正确处理SIGTERM、设置WorkingDirectory和环境变量）进行生产级托管。
nohup go run main.go & 不是部署，只是临时躲开终端关闭，别在生产环境用。
必须先编译成二进制，不能直接 go run
Go 程序部署的核心前提是静态链接、无依赖的可执行文件。直接 go run 会每次启动都触发编译，浪费资源、无调试符号、无法做安全加固，且进程生命周期完全不可控。
- 本地交叉编译（如目标服务器是 Linux amd64）：
GOOS=linux GOARCH=amd64 go build -o gin-api main.go - 确保
main.go所在目录无未提交的go.mod变更，否则线上go mod download可能失败 - 编译后检查依赖：运行
ldd gin-api，应显示not a dynamic executable（Go 默认静态链接） - 上传到服务器后记得加执行权限：
chmod +x gin-api
systemd 是唯一推荐的守护方式
Linux 生产环境不接受 nohup、setsid 或自写 fork 逻辑——它们缺乏重启策略、日志归档、资源限制和依赖管理。
linux-performance-analyzer
下载
Linux 性能分析与调优专家，覆盖 CPU、内存、磁盘 I/O、网络、内核参数、编译优化、容器/K8s。适用场景：系统卡顿/高负载、内存不足/OOM/Swap 高、CPU 异常/iowait 高。
- 服务文件必须放在
/etc/systemd/system/gin-api.service -
Type=simple（不是 forking），因为 Gin 默认阻塞式启动，ExecStart启动即主进程 - 必须设
Restart=always和RestartSec=5，否则崩溃后服务静默离线 -
StandardOutput=journal和StandardError=journal，才能用journalctl -u gin-api查日志 - 环境变量如
GIN_MODE=release、PORT=8080要显式通过Environment=注入，不能靠 shell profile
优雅关机必须手动处理 SIGTERM
Gin 自身不监听系统信号；若没处理 SIGTERM，systemd 发送停止指令时进程会立刻被 KILL，正在处理的 HTTP 请求直接中断。
- 在
main()中注册信号监听：signal.Notify(sigChan, syscall.SIGTERM, syscall.SIGINT) - 调用
r.Run()前，启动一个 goroutine 等待信号，收到后调用srv.Shutdown() -
srv需是&http.Server{Addr: ":8080", Handler: r}，不能只用r.Run()（它内部封装了无超时 shutdown） - 务必设
ShutdownTimeout，例如 10 秒，避免 hang 住 systemd 的 stop 流程
别忽略工作目录与文件权限
看似无关的路径和权限问题，上线后常导致 404、500 或启动失败，且错误信息极不明确。
-
WorkingDirectory必须设为项目根目录（如/opt/gin-api），否则r.Static()、模板加载、配置文件读取全失效 - 如果用了
r.LoadHTMLGlob("templates/*")，确保 templates/ 在WorkingDirectory下，且用户（如www-data）有读权限 - 日志写入文件？别直接
os.OpenFile("app.log", ...)—— systemd 重定向了 stdout/stderr，文件操作应走io.MultiWriter或独立 log 文件 +logrotate - 用非 root 用户运行（如
User=www-data），避免端口80权限问题；要绑:80就配setcap 'cap_net_bind_service=+ep' ./gin-api
真正卡住人的从来不是编译或启动命令，而是 WorkingDirectory 没配对、SIGTERM 没接管、日志没进 journal —— 这三处一错，systemd status 看起来“active”，实际请求全 502 或超时。
