小帕的小窝

Systemd 与应用生命周期

用户 Passthem 的头像
Passthem
・

最近在开发此方 BOT 的时候,越来越讨厌在单容器里同时拉起浏览器池、主程序等一大坨各种各样的东西,所以在思考能不能把此方 BOT 重新放到裸金属运行,用 systemd 管理它的死活。

Systemd 虽然一直都被诟病「小而美」[1],但是最近看了一个 systemd 教程[2],发现它其实还是挺好用的。

因此在这里简要讲解一下 Systemd 的 Unit 生命周期,并讲解如何使用 libsystemd 告诉 systemd 应用的状态。

Systemd 简概

Systemd 是目前主流 Linux 发行版中常用的 init 进程[3],也就是内核创建的第一个用户进程,它的 PID=1,并且负责拉起一大堆服务并且管理它们的启动顺序。很多时候的服务器运维,都通过它来指定各种开机自启动的应用。

Systemd 中,每一个基本结构,包括服务在内,都被称作一个 unit。每个 unit 之间可以规定它们的依赖、启动顺序之类的限制关系。

例如,我有一个需要让 Root 启动的开机自启动脚本,我写了这个:

/etc/systemd/system/ssh-port-forward.service
[Unit]
Description=SSH 端口转发服务
# 这是我一直在用的一个服务,用来端口转发我的一个本地音乐服务,让我
# 可以在我的手机随时随机收听我电脑上的音乐。
After=network.target
[Service]
ExecStart=/usr/bin/ssh -N -T -R xxxxx:localhost:xxxxx xxxxxx -o ExitOnForwardFailure=yes
Restart=always
RestartSec=5
StartLimitIntervalSec=60s
StartLimitBurst=10
[Install]
WantedBy=multi-user.target

这里就声明了依赖关系:这个服务,在 multi-user.target 启动的时候被启动,但是要等 network.target 启动成功。这样就可以保证开机以后,等网络栈初始化后,开始试着启动。

Systemd 状态机

怎么知道「启动成功」和「开始被启动」的区别呢?每一个 unit 都有一个状态机:

systemd unit 的状态机
systemd unit 的状态机

当状态从 inactive 到 activating,则代表开始启动;从 activating 到 active,则是启动了。

常见的 Systemd 服务类型

一般写 Systemd 服务的时候,会有这几种类型:

  • simple: 默认的类型。只要进程 fork 了就进 active 状态(甚至不考虑能不能执行!!)
  • exec: 只要进程开始执行了就进 active 状态
  • oneshot[4]: 只要 ExecStart 进程结束就进 active 状态(通常配合 RemainAfterExit=true)

这些类型很好,而且非常实用。不过,如果一个进程复杂一些(例如等到一个什么状态了才算启动完成,别的服务才能开始依赖它),这些基础类型就束手无策。Systemd 提供了若干方法可以让我们自定义获取服务状态的方法,包括 dbus 和 notify。这里较为简单的就是 notify。

Type=notify

在这个模式下,Systemd 会提供一个 socket。我们可以使用 libsystemd 中的 sd_notify 函数来向 systemd 报告自己的状态。

这里我们做个小实验:

./main.c
#include <systemd/sd-daemon.h>
#include <stdio.h>
#include <stdlib.h>
#include <unistd.h>
// 赫赫这个是用来输出用的!
#define LOG(fmt, ...) fprintf(stderr, fmt "\n", ##__VA_ARGS__)
const char *env(const char *n) {
const char *e = getenv(n);
return e ? e : "未设置";
}
int main() {
LOG("main() NOTIFY_SOCKET=%s", env("NOTIFY_SOCKET"));
sleep(2);
LOG("发送 READY=1");
sd_notify(0, "READY=1");
sleep(2);
LOG("send STOPPING=1");
sd_notify(0, "STOPPING=1");
sleep(2);
LOG("main() exited");
return 0;
}
services/wtf.service
[Service]
Type=notify
ExecStart=/app/main

写个测试脚本来每秒检测一次它的状态:

test_script.sh
#!/usr/bin/env bash
for i in 1 2 3 4 5 6 7 8; do
systemctl status wtf.service 2>&1 \
| grep "Active:" \
| sed -r 's/^.+(Active: \S+) .+$/\1/g'
sleep 1
done
journalctl --unit wtf --unit test \
| tail -n +2 \
| sed -r 's/ [0-9a-f]{12}//' > /data/result
systemctl --no-block exit 0
services/test.service
[Unit]
After=multi-user.target
Wants=wtf.service
[Service]
Type=oneshot
ExecStart=/app/test_script.sh
[Install]
WantedBy=multi-user.target

在容器里跑它们吧:

Dockerfile
FROM ubuntu:20.04 AS builder
WORKDIR /app
RUN apt-get update && \
apt-get install --assume-yes gcc libsystemd-dev
COPY main.c /app/
RUN gcc -o main main.c -lsystemd
FROM ubuntu:20.04 AS runner
WORKDIR /app
RUN apt-get update && \
apt-get install --assume-yes systemd
COPY --from=builder /app/main /app/
COPY ./test_script.sh /app/
COPY ./services/* /etc/systemd/system/
RUN ln -s /etc/systemd/system/test.service \
/etc/systemd/system/multi-user.target.wants/test.service
CMD ["/lib/systemd/systemd"]

结果是这样的:

data/result
Nov 15 16:45:10 systemd[1]: Starting wtf.service...
Nov 15 16:45:10 main[39]: main() NOTIFY_SOCKET=/run/systemd/notify
Nov 15 16:45:10 systemd[1]: Starting test.service...
Nov 15 16:45:10 test_script.sh[54]: Active: activating
Nov 15 16:45:11 test_script.sh[58]: Active: activating
Nov 15 16:45:12 main[39]: 发送 READY=1
Nov 15 16:45:12 systemd[1]: Started wtf.service.
Nov 15 16:45:12 test_script.sh[62]: Active: active
Nov 15 16:45:13 test_script.sh[66]: Active: active
Nov 15 16:45:14 main[39]: send STOPPING=1
Nov 15 16:45:14 test_script.sh[70]: Active: deactivating
Nov 15 16:45:15 test_script.sh[74]: Active: deactivating
Nov 15 16:45:16 main[39]: main() exited
Nov 15 16:45:16 systemd[1]: wtf.service: Succeeded.
Nov 15 16:45:16 test_script.sh[78]: Active: inactive
Nov 15 16:45:17 test_script.sh[82]: Active: inactive

Bonus: 让 Systemd 控制我们应用安全关闭

那么,怎么在 systemctl stop my-service.service 的时候安全关闭应用呢?这个不需要库就可以做了:默认情况下,我们的应用捕获 SIGTERM 就行。默认情况下,我们的应用会直接被关闭,来不及反应。如果捕获 SIGTERM 信号,就可以安全退出:

main.c
#include <signal.h>
#include <systemd/sd-daemon.h>
#include <stdio.h>
#include <stdlib.h>
#include <unistd.h>
#define LOG(fmt, ...) fprintf(stderr, fmt "\n", ##__VA_ARGS__)
const char *env(const char *n) {
const char *e = getenv(n);
return e ? e : "未设置";
}
void handle_signal(int _) {
LOG("哦不程序被关了,收拾下走人吧");
sleep(2);
LOG("已收拾。");
exit(0);
}
int main() {
signal(SIGTERM, handle_signal);
LOG("main() NOTIFY_SOCKET=%s", env("NOTIFY_SOCKET"));
sleep(2);
LOG("发送 READY=1");
sd_notify(0, "READY=1");
sleep(2);
LOG("send STOPPING=1");
sd_notify(0, "STOPPING=1");
sleep(2);
LOG("main() exited");
return 0;
}

引入一个新的脚本来中途关闭它:

daemon_script.sh
#!/usr/bin/env bash
sleep 3.11415926
echo "斩!"
systemctl stop wtf.service

结果:

data/result
Nov 15 17:24:53 systemd[1]: Starting daemon.service...
Nov 15 17:24:53 systemd[1]: Starting wtf.service...
Nov 15 17:24:53 main[40]: main() NOTIFY_SOCKET=/run/systemd/notify
Nov 15 17:24:54 systemd[1]: Starting test.service...
Nov 15 17:24:54 test_script.sh[56]: Active: activating
Nov 15 17:24:55 test_script.sh[60]: Active: activating
Nov 15 17:24:55 main[40]: 发送 READY=1
Nov 15 17:24:55 systemd[1]: Started wtf.service.
Nov 15 17:24:56 test_script.sh[64]: Active: active
Nov 15 17:24:57 daemon_script.sh[35]: 斩!
Nov 15 17:24:57 main[40]: 哦不程序被关了,收拾下走人吧
Nov 15 17:24:57 systemd[1]: Stopping wtf.service...
Nov 15 17:24:57 test_script.sh[69]: Active: deactivating
Nov 15 17:24:58 test_script.sh[73]: Active: deactivating
Nov 15 17:24:59 main[40]: 已收拾。
Nov 15 17:24:59 systemd[1]: wtf.service: Succeeded.
Nov 15 17:24:59 systemd[1]: Stopped wtf.service.
Nov 15 17:24:59 systemd[1]: daemon.service: Succeeded.
Nov 15 17:24:59 systemd[1]: Finished daemon.service.
Nov 15 17:24:59 test_script.sh[77]: Active: inactive
Nov 15 17:25:00 test_script.sh[81]: Active: inactive
Nov 15 17:25:01 test_script.sh[85]: Active: inactive

默认的超时时间 TimeoutStopSec=90s。

参考文献

[1]
微信是如何一步步告别「小而美」的?[EB/OL]. [2026-11-15]. https://sspai.com/post/75731.
[2]
JAMBOR S. systemd by example - Part 4: Installing units[EB/OL]. [2026-11-15]. https://seb.jambor.dev/posts/systemd-by-example-part-4-installing-units/.
[3]
systemd[EB/OL]. [2026-11-15]. https://systemd.io/.
[4]
Oneshotのニコくんちゃんすき[EB/OL]. [2026-11-15]. https://misskey.io/notes/arsfd8yd19vs039t.

评论区