systemd兼容守护进程无需手动daemonize,只需编写前台式阻塞程序,响应SIGTERM、保持stdout/stderr开放并重定向至journal。

用 C++ 编写 systemd 兼容的守护进程
systemd 不需要你手动 fork、脱离终端或重定向 stdin/stdout/stderr —— 它会自动管理这些。你只需写一个普通、阻塞式、长期运行的 C++ 程序,按 systemd 的约定行为即可。
关键设计原则:不要自己 daemonize
传统 Unix 守护进程常调用 fork()、setsid()、关闭文件描述符等。在 systemd 下,这不仅多余,还可能引发问题(比如 systemd 无法正确追踪主进程、日志丢失、启动超时失败)。systemd 要求你的服务是“前台式”的:
- 程序启动后立即进入主循环(如监听 socket、定时检查、处理消息)
- 不退出,不自行后台化
- 标准输入保持打开(systemd 可能用于 IPC),但可忽略;stdout/stderr 会自动被重定向到 journal
- 响应
SIGTERM(systemd 默认停止信号),优雅退出;可选处理SIGHUP或SIGUSR1
最小可行 C++ 示例(带信号处理)
以下是一个符合 systemd 要求的极简服务:
#include <iostream>
#include <csignal>
#include <chrono>
#include <thread>
<p>volatile sig_atomic_t running = 1;</p><p><span>立即学习</span>“<a href="https://pan.quark.cn/s/6e7abc4abb9f" style="text-decoration: underline !important; color: blue; font-weight: bolder;" rel="nofollow" target="_blank">C++免费学习笔记(深入)</a>”;</p><p>void signal_handler(int sig) {
if (sig == SIGTERM || sig == SIGINT) {
std::cerr << "Received shutdown signal, exiting...\n";
running = 0;
}
}</p><p>int main() {
// 注册信号处理器(仅需处理 SIGTERM)
signal(SIGTERM, signal_handler);
signal(SIGINT, signal_handler); // 方便调试时 Ctrl+C</p><pre class="brush:php;toolbar:false;">std::cerr << "MyService started, PID: " << getpid() << "\n";
while (running) {
std::this_thread::sleep_for(std::chrono::seconds(5));
std::cout << "Heartbeat at " << time(nullptr) << "\n";
}
std::cerr << "MyService stopped gracefully.\n";
return 0;}
编译:g++ -std=c++17 -o /usr/local/bin/myservice myservice.cpp
编写对应的 systemd service 文件
新建 /etc/systemd/system/myservice.service:
[Unit] Description=My C++ Background Service After=network.target StartLimitIntervalSec=0 <p>[Service] Type=simple User=myuser Group=myuser WorkingDirectory=/var/lib/myservice ExecStart=/usr/local/bin/myservice Restart=on-failure RestartSec=5 StandardOutput=journal StandardError=journal SyslogIdentifier=myservice</p><h1>可选:限制资源</h1><h1>MemoryLimit=100M</h1><h1>CPUQuota=50%</h1><p>[Install] WantedBy=multi-user.target </p>
说明:
-
Type=simple:默认类型,systemd 认为 ExecStart 启动的进程即主服务进程 -
Restart=on-failure:进程非 0 退出时自动重启(调试阶段建议先设为no) -
StandardOutput/StandardError=journal:确保 cout/cerr 输出进 journal(可用journalctl -u myservice -f查看) - 无需
RemainAfterExit=yes(那是 for Type=oneshot)
部署与调试流程
执行以下命令启用并运行服务:
sudo systemctl daemon-reload sudo systemctl enable myservice.service # 开机自启 sudo systemctl start myservice.service # 立即启动 sudo systemctl status myservice.service # 查看状态和最近日志 journalctl -u myservice -n 50 -f # 实时跟踪输出
常见问题排查:
- 启动失败?运行
systemctl status myservice看 “Active” 状态和 “Main PID”,再查 journal 日志 - 日志没输出?确认程序用了
std::cout/std::cerr(不是 fprintf 或写文件),且 service 文件中Standard*设置正确 - 进程被杀但没触发 signal_handler?检查是否用了
Type=forking却没正确实现,应坚持Type=simple
进阶建议
生产环境可进一步增强:
- 用
sd_notify(3)告知 systemd “就绪”(例如完成 socket 初始化后):需链接-lsystemd,调用sd_notify(0, "READY=1"),并在 service 文件中加Type=notify和NotifyAccess=all - 通过
sd_journal_print()写结构化日志(比 cout 更易过滤) - 使用
systemd-sysusers和systemd-tmpfiles自动创建用户、目录、权限 - 配合
.socket或.pathunit 实现按需激活(socket activation)











