systemd 让 Go 服务稳稳跑起来:Restart 策略与健康检查
systemd 让 Go 服务稳稳跑起来:Restart 策略与健康检查
把 Go 程序编译成一个二进制文件只是部署的一半,另一半是让它在服务器上长期稳稳地跑:机器重启后自动起来,崩溃后自动拉起,出了问题能快速定位。systemd 就是干这个的——它是 Linux 上管理服务的标准工具,一个写好的 unit 文件,胜过一堆后台启动脚本。
先写一个能用的 unit 文件
最简单的 service 文件只有几行:[Unit] 里写 Description 和 After=network.target,[Service] 里写 ExecStart 指向二进制的绝对路径,WorkingDirectory 指向工作目录,User 指定运行用户,[Install] 里写 WantedBy=multi-user.target。关键是不要用相对路径:systemd 启动时的工作目录和你的 shell 不一样,写相对路径最常见的结果就是启动失败、日志里一句 “No such file or directory”。写好后 systemctl daemon-reload 再 systemctl enable --now 服务名,enable 保证开机自启,–now 立刻启动。
Restart 策略:崩溃了该不该立刻拉起
Restart 有三个常用值。no 是默认值,死了就死了,适合只跑一次的任务;on-failure 是后端服务最常用的选择——程序异常退出时自动重启,正常退出(比如你主动 systemctl stop)时不重启;always 是不管怎么退出都重启,适合必须常驻的守护进程。只配 Restart 还不够,要配 RestartSec:立刻重启听起来很积极,但程序如果是配置错误导致的秒退,立刻重启会变成每秒崩一次的死循环,日志瞬间刷爆磁盘。设 RestartSec=5s,给每次重启留一个喘息间隔;再配 StartLimitBurst 和 StartLimitIntervalSec,比如 5 分钟内最多重启 5 次,超过就停下来等人工介入,这才是防死循环的兜底。
环境变量和日志:别让配置散在各处
数据库地址、端口、密钥这些配置不要写进代码,也不要写在启动脚本里。systemd 的做法是 EnvironmentFile=/etc/服务名/env,把配置集中放在一个只有服务用户能读的文件里,权限 600。程序读环境变量,改配置只需要改文件加 systemctl restart,不用重新编译。日志也一样:不要让程序自己往各处写文件,标准输出和标准错误交给 journald,journalctl -u 服务名 -f 实时看,--since "1 hour ago" 按时间过滤,journalctl -u 服务名 --disk-usage 看日志占了多少磁盘。日志暴涨时先查是不是某个错误在循环打印,而不是急着清日志——清了就丢了定位线索。
健康检查:活着不等于能用
进程在不代表服务可用:死锁的程序进程还在,但所有请求都卡住了。这时需要健康检查。最简单的是在程序里留一个 /health 接口,只返回 200 和一行 “ok”,检查数据库连通性也算进去。systemd 层面可以用 ExecStartPost 或定时器定期 curl 这个接口,失败就重启服务;网关层面更常见——反向代理定期探活,失败就把节点摘掉,等恢复再加回来。部署时也一样:先启动新进程、等 /health 返回 200 再切流量,旧进程等在途请求处理完再退出,滚动更新就不会在重启瞬间丢请求。
出问题先看这三处
服务起不来,先 systemctl status 服务名 看状态和最近几行日志,再 journalctl -u 服务名 --since "10 minutes ago" 看完整报错,最后检查 ExecStart 的路径、权限和 EnvironmentFile 是否存在。多数启动失败都是这三类:路径写错、配置文件权限不对、端口已被占用。ss -tlnp 一查就知道端口被谁占了。把 unit 文件和 env 模板一起放进代码仓库,换一台机器照着抄就能跑起来,这才是部署该有的样子——服务怎么跑,应该是代码的一部分,而不是只存在某个人脑子里的操作记忆。
- 点赞
- 收藏
- 关注作者
评论(0)