【产出】 > 把自己写的 Python 脚本或程序做成 systemd 服务:开机自动启动、崩溃自动重启、日志统一用 journalctl 查看,并弄清 Type、Restart、After / Wants 这几个最容易写错的配置项。
【版本】 > 按 systemd 官方手册
systemd.service(5)与systemd.unit(5)编写,适用于 Ubuntu、Debian、CentOS / RHEL、树莓派 OS 等使用 systemd 的发行版。
一、一个完整的例子
假设要让 /opt/sensor/.venv/bin/python /opt/sensor/main.py 开机自动运行。新建 /etc/systemd/system/sensor.service:
[Unit]
Description=Sensor data collector
Wants=network-online.target
After=network-online.target
[Service]
Type=exec
User=sensor
WorkingDirectory=/opt/sensor
EnvironmentFile=/opt/sensor/sensor.env
ExecStart=/opt/sensor/.venv/bin/python /opt/sensor/main.py
Restart=on-failure
RestartSec=5
[Install]
WantedBy=multi-user.target
启用并启动:
sudo systemctl daemon-reload # 新建或修改 unit 文件后必须执行
sudo systemctl enable --now sensor # 设为开机自启,并立即启动
systemctl status sensor # 查看状态
journalctl -u sensor -f # 实时查看日志
下面逐项解释为什么这样写。
二、Type:选 exec,不要默认的 simple
| Type | 什么时候算"启动成功" |
|---|---|
simple(只写了 ExecStart 时的默认值) | 进程 fork 出来就算成功,还没真正执行程序 |
exec | fork 和 execve 都成功才算成功 |
forking | 父进程退出才算成功,适合传统的后台守护程序,官方不推荐新程序使用 |
oneshot | 主进程运行结束才算成功,适合一次性任务 |
notify | 程序主动通过 sd_notify 发送 READY=1 才算成功 |
官方手册特别说明:simple 在程序文件不存在、User 写错时也会报告"启动成功",而 exec 会如实报告失败。所以手册推荐长期运行的服务使用 Type=exec。
三、ExecStart:写绝对路径
官方规则:第一个参数必须是可执行文件的绝对路径,或者是不带斜杠的简单文件名。简单文件名只在编译时固定的几个目录里查找(如 /usr/local/bin/、/usr/bin/),不会读取你的 PATH。
所以虚拟环境、/opt 下的程序一律写完整路径。除 Type=oneshot 外,ExecStart 只能有一条。
【注意】 > 不要写成
ExecStart=cd /opt/sensor && python main.py。ExecStart 不经过 shell,cd、&&、重定向都不会生效。工作目录用WorkingDirectory=指定,日志直接打印到标准输出,systemd 会自动收进 journal。
四、Restart:崩溃自动重启
| 值 | 含义 |
|---|---|
no | 默认值,退出后不重启 |
on-failure | 非 0 退出码、被信号杀死、超时、看门狗触发时重启。官方推荐长期运行的服务用这个 |
always | 不论什么原因退出都重启 |
RestartSec= 是重启前的等待时间,默认只有 100 ms。程序依赖的硬件或网络还没准备好时,100 ms 内会连续失败好几次,触发 systemd 的启动频率限制(StartLimitIntervalSec=、StartLimitBurst=),服务就会被判定为失败、不再重启。所以建议设成几秒,例如 RestartSec=5。
用 systemctl stop 手动停止的服务不会被自动拉起。
五、After 与 Wants:顺序和依赖是两回事
官方手册强调:依赖关系和启动顺序是相互独立的。
| 配置 | 作用 |
|---|---|
Wants= | 把对方一起拉起来,但不影响先后顺序。只写 Wants 时,两者会同时启动 |
Requires= | 比 Wants 更强的依赖。对方启动失败时,本服务不启动(需要同时写 After 才有这个效果) |
After= | 只规定先后:对方完全启动后再启动本服务。不会把对方拉起来 |
所以要"等网络就绪后再启动",两个都要写:
Wants=network-online.target
After=network-online.target
官方也把"同时写进 After= 和 Wants="描述为常见用法。只写 After=network.target 并不能保证网络已经可用。
六、[Install]:enable 时才生效
systemd 正常运行时完全不读 [Install] 段,它只在执行 systemctl enable 时起作用。WantedBy=multi-user.target 的效果是:enable 时在 multi-user.target.wants/ 目录下创建一个指向本服务的链接,于是系统启动到多用户模式时会拉起这个服务。
所以只改了 [Install] 段时,要 disable 再 enable 一次才能生效。
七、环境变量
Environment="MODE=prod" "LOG_LEVEL=info"
EnvironmentFile=/opt/sensor/sensor.env
EnvironmentFile 里每行一个 KEY=VALUE。密钥类配置放在单独的文件里,并收紧权限(chmod 600),不要直接写进 unit 文件。
八、排查
| 现象 | 查看 |
|---|---|
| 启动失败 | systemctl status sensor 看最后几行日志和退出码 |
| 看完整日志 | journalctl -u sensor -b(本次开机以来) |
| 改了配置不生效 | 是否执行了 systemctl daemon-reload |
| 手动运行正常,服务里不正常 | 服务用的是 User= 指定的用户和 WorkingDirectory=,检查权限、相对路径和环境变量 |
评价 (0)