Linux 与服务器运维 / 系统课时

自己写一个 systemd Service

自己写一个 systemd Service

当脚本或自研程序需要随系统启动、以固定用户运行,并在异常退出后自动恢复时,可以把它交给 systemd 管理。本课从一个最小可运行脚本出发,写出 Service Unit,完成加载、启动、自启和重启策略验证。

学习目标

  • 编写包含 ExecStart、WorkingDirectory、User 和 Restart 的 Service Unit。
  • 理解 [Unit]、[Service]、[Install] 三个区段各自承担的职责。
  • 使用 daemon-reload、enable --now、journalctl 验证服务行为。

准备被托管的程序

先创建一个专用系统用户、工作目录和测试脚本。脚本启动后每 30 秒输出一次心跳,便于通过 journal 验证它是否真的由 systemd 托管。

bash
sudo groupadd --system anystack-demo 2>/dev/null || true
id -u anystack-demo >/dev/null 2>&1 || sudo useradd --system --gid anystack-demo --no-create-home --shell /usr/sbin/nologin anystack-demo
sudo install -d -o anystack-demo -g anystack-demo /var/lib/anystack-demo
sudo tee /usr/local/bin/anystack-clock.sh >/dev/null <<'EOF'
#!/bin/bash
echo "service started at $(date -Is)"
while true; do
  echo "heartbeat $(date -Is)"
  sleep 30
done
EOF
sudo chmod 755 /usr/local/bin/anystack-clock.sh

预期结果

text
命令成功返回;正常情况下没有标准输出。

这里把程序放在 /usr/local/bin,把可写工作目录放在 /var/lib/anystack-demo。服务将使用低权限用户 anystack-demo 运行,而不是直接使用 root。

编写 Service Unit

将 Unit 文件放到 /etc/systemd/system,适合管理员自行维护的本机服务。下面的配置可以直接用于刚才创建的脚本。

bash
sudo tee /etc/systemd/system/anystack-clock.service >/dev/null <<'EOF'
[Unit]
Description=Anystack clock demo
After=network.target

[Service]
Type=simple
User=anystack-demo
Group=anystack-demo
WorkingDirectory=/var/lib/anystack-demo
ExecStart=/usr/local/bin/anystack-clock.sh
Restart=on-failure
RestartSec=3

[Install]
WantedBy=multi-user.target
EOF

预期结果

text
命令成功返回;Unit 文件写入后通常没有标准输出。

ExecStart 指定主进程启动命令;WorkingDirectory 决定进程的当前目录;User 和 Group 决定运行身份。Restart=on-failure 会在进程异常退出时重启,但正常执行 systemctl stop 不会触发自动拉起。WantedBy=multi-user.target 则为后续 enable 提供开机启动关系。

重新加载并启动服务

新增或修改 Unit 文件后,systemd 管理器不会自动重新读取磁盘内容,因此先执行 daemon-reload。随后用 enable --now 同时设置开机自启并立即启动。

bash
sudo systemctl daemon-reload
sudo systemctl --quiet enable --now anystack-clock.service
systemctl is-enabled anystack-clock.service
systemctl is-active anystack-clock.service

预期输出

text
enabled
active

再读取应用自己的输出,使用 -o cat 可以去掉 journal 的时间戳和主机名前缀,只保留消息正文:

bash
sudo journalctl -u anystack-clock.service -o cat --no-pager | grep -E 'service started|heartbeat' | tail -n 2

预期输出

text
service started at <TIME>
heartbeat <TIME>

<TIME> 会随实际运行时间变化。

验证自动重启策略

为了验证 Restart=on-failure,可以给主进程发送 SIGKILL。systemd 会把这次退出视为失败,并在 RestartSec=3 后重新启动服务。

bash
sudo systemctl kill --signal=SIGKILL anystack-clock.service
sleep 5
systemctl is-active anystack-clock.service

预期输出

text
active

如果修改了 Unit 内容,要再次执行 sudo systemctl daemon-reload,再 restart 服务使新配置生效。排查启动失败时,优先查看 systemctl status anystack-clock.service 和 journalctl -u anystack-clock.service,通常能直接看到权限、路径或启动命令错误。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

自己写一个 systemd Service

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通