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 托管。
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预期结果
命令成功返回;正常情况下没有标准输出。这里把程序放在 /usr/local/bin,把可写工作目录放在 /var/lib/anystack-demo。服务将使用低权限用户 anystack-demo 运行,而不是直接使用 root。
编写 Service Unit
将 Unit 文件放到 /etc/systemd/system,适合管理员自行维护的本机服务。下面的配置可以直接用于刚才创建的脚本。
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预期结果
命令成功返回;Unit 文件写入后通常没有标准输出。ExecStart 指定主进程启动命令;WorkingDirectory 决定进程的当前目录;User 和 Group 决定运行身份。Restart=on-failure 会在进程异常退出时重启,但正常执行 systemctl stop 不会触发自动拉起。WantedBy=multi-user.target 则为后续 enable 提供开机启动关系。
重新加载并启动服务
新增或修改 Unit 文件后,systemd 管理器不会自动重新读取磁盘内容,因此先执行 daemon-reload。随后用 enable --now 同时设置开机自启并立即启动。
sudo systemctl daemon-reload
sudo systemctl --quiet enable --now anystack-clock.service
systemctl is-enabled anystack-clock.service
systemctl is-active anystack-clock.service预期输出
enabled
active再读取应用自己的输出,使用 -o cat 可以去掉 journal 的时间戳和主机名前缀,只保留消息正文:
sudo journalctl -u anystack-clock.service -o cat --no-pager | grep -E 'service started|heartbeat' | tail -n 2预期输出
service started at <TIME>
heartbeat <TIME><TIME> 会随实际运行时间变化。
验证自动重启策略
为了验证 Restart=on-failure,可以给主进程发送 SIGKILL。systemd 会把这次退出视为失败,并在 RestartSec=3 后重新启动服务。
sudo systemctl kill --signal=SIGKILL anystack-clock.service
sleep 5
systemctl is-active anystack-clock.service预期输出
active如果修改了 Unit 内容,要再次执行 sudo systemctl daemon-reload,再 restart 服务使新配置生效。排查启动失败时,优先查看 systemctl status anystack-clock.service 和 journalctl -u anystack-clock.service,通常能直接看到权限、路径或启动命令错误。