NOTE · 2026.11.18

把长期服务交给 systemd:一份实用检查清单

把一个脚本变成稳定的后台服务,难点通常不在启动命令,而在之后几个月的运行、重启、日志和升级。systemd 提供了足够的机制,但默认值不一定适合每个服务。

先确认三件事

第一,服务是否真的需要以 root 运行。第二,工作目录和配置文件是否明确。第三,异常退出后是否应该自动拉起。很多“服务莫名停了”的问题,最后都落在工作目录不确定或重启策略缺失上。

[Unit]
Description=Example service
After=network-online.target
Wants=network-online.target

[Service]
Type=simple
User=example
WorkingDirectory=/opt/example
ExecStart=/opt/example/bin/example --config /etc/example/config.yml
Restart=on-failure
RestartSec=3
NoNewPrivileges=true
PrivateTmp=true

[Install]
WantedBy=multi-user.target

日志不要只靠 stdout

journalctl -u example -f 适合排查即时问题,但长期审计还需要落盘策略。至少确认 journal 的磁盘占用上限,避免一次异常刷日志把根分区写满。

把恢复步骤写下来

一套服务如果没有明确的停止、启动、回滚和验证命令,交付就还没有完成。我习惯把这几条命令放进同目录的 README,过几个月再回来看,能省下很多猜测。

最后,用 systemctl cat 和 systemctl show 检查实际生效的配置,不要只看仓库里的模板文件。