用 systemd 管理后台服务

编写 service 单元文件,把 Python Web 应用托管给 systemd,实现开机自启、异常重启和统一的日志查看。

Linux 约 2 分钟 571 字
本文目录
  1. 单元文件结构
  2. 编写 service 文件
  3. 常用命令
  4. 查看日志
  5. 重启策略
  6. 安全加固
  7. 定时任务:timer

在服务器上长期运行一个程序,最不推荐的做法是 nohup python app.py &:进程崩溃不会自动重启,日志散落在各处,开机也不会自动启动。现代 Linux 发行版大多使用 systemd 作为初始化系统,它正好能解决这些问题。

单元文件结构 #

systemd 用单元(unit)描述被管理的对象。服务对应 .service 文件,自定义的单元文件一般放在 /etc/systemd/system/ 下。一个单元文件通常包含三个部分:

小节 作用
[Unit] 描述信息、启动顺序和依赖关系
[Service] 如何启动、停止、重启进程
[Install] systemctl enable 时挂载到哪个启动目标

编写 service 文件 #

以一个部署在 /opt/notes-app 的 Python Web 应用为例:

ini
# /etc/systemd/system/notes-app.service
[Unit]
Description=Notes web application
After=network-online.target
Wants=network-online.target

[Service]
Type=simple
User=notes
Group=notes
WorkingDirectory=/opt/notes-app
Environment=APP_PORT=8000
ExecStart=/opt/notes-app/.venv/bin/python main.py
Restart=on-failure
RestartSec=5s

[Install]
WantedBy=multi-user.target

提示

ExecStart 必须使用绝对路径。systemd 不会读取用户的 shell 配置,PATH 里找不到你在交互式终端中能用的命令。

常用命令 #

bash
sudo systemctl daemon-reload            # 修改单元文件后重新加载
sudo systemctl enable --now notes-app   # 设置开机自启并立即启动
systemctl status notes-app              # 查看运行状态
sudo systemctl restart notes-app        # 重启服务
sudo systemctl disable --now notes-app  # 停止并取消开机自启

status 的输出里可以看到主进程 PID、内存占用和最近几行日志,是排查问题的第一步。

查看日志 #

服务写到标准输出和标准错误的内容都会被 journald 收集:

bash
journalctl -u notes-app -f              # 实时跟踪日志
journalctl -u notes-app --since "1 hour ago"
journalctl -u notes-app -p err -b       # 本次开机以来的错误日志

重启策略 #

Restart= 取值 何时重启
no 从不(默认)
on-failure 非零退出码、被信号杀死、超时
on-abnormal 被信号杀死、超时,正常退出不重启
always 无论如何退出都重启

为了防止服务启动失败后陷入无限重启,systemd 默认在 10 秒内最多允许重启 5 次,可以通过 [Unit] 中的 StartLimitIntervalSec 和 StartLimitBurst 调整。

安全加固 #

systemd 提供了很多沙箱选项,只需在 [Service] 中添加几行:

ini
NoNewPrivileges=true
PrivateTmp=true
ProtectSystem=strict
ProtectHome=true
ReadWritePaths=/opt/notes-app/data

警告

开启 ProtectSystem=strict 后整个文件系统都变为只读,应用需要写入的目录必须通过 ReadWritePaths 显式放行,否则会出现权限错误。

可以用下面的命令查看服务的安全评分和改进建议:

bash
systemd-analyze security notes-app

定时任务:timer #

systemd 的 timer 单元可以替代 cron。例如每天凌晨 3 点执行一次清理脚本:

ini
# /etc/systemd/system/cleanup.timer
[Unit]
Description=Daily cleanup

[Timer]
OnCalendar=*-*-* 03:00:00
Persistent=true

[Install]
WantedBy=timers.target

同目录下再编写一个同名的 cleanup.service 定义要执行的命令,然后执行 systemctl enable --now cleanup.timer 即可。systemctl list-timers 可以查看所有定时器下一次的触发时间。