systemd service 怎么写:把自研程序做成开机自启的系统服务
技术教程 · DevOps · 自动化运维 · 2026-09-23
systemd service 怎么写:把自研程序做成开机自启的系统服务
一句话开头
用 nohup ./myapp & 起的服务,机器一重启就没了;写进 crontab @reboot 又看不到日志,也不知道它到底起来没有。正确做法是写一个 systemd service 文件:开机自启、进程崩了自动拉起、标准输出自动进 journald。下面这份模板可以直接抄,后面是几个几乎人人都会踩的坑。
前置准备
- 发行版使用 systemd:RHEL/CentOS 7+、Ubuntu 16.04+、Debian 9+ 都带。执行 systemctl --version 能输出版本号即可。
- 程序要能以前台方式运行(推荐)。如果它自己会 daemon 化(fork 后父进程退出),Type 的选法不一样,见下文常见坑第 1 条。
- 准备好程序的绝对路径(如 /opt/myapp/bin/myapp)、运行用户、配置文件路径。systemd 不认 shell 的相对路径。
步骤 1:写 service 文件
文件放在 /etc/systemd/system/myapp.service(管理员自建的都放这里,/usr/lib/systemd/system 是发行版打包用的,升级时可能被覆盖):
[Unit]
Description=MyApp API Service
Documentation=https://example.com/myapp
Wants=network-online.target
After=network-online.target
StartLimitIntervalSec=60
StartLimitBurst=5
[Service]
Type=simple
User=myapp
Group=myapp
WorkingDirectory=/opt/myapp
Environment=APP_ENV=prod
EnvironmentFile=-/etc/myapp/myapp.env
ExecStart=/opt/myapp/bin/myapp --config /opt/myapp/config.yaml
ExecReload=/bin/kill -HUP $MAINPID
ExecStop=/bin/kill -TERM $MAINPID
Restart=on-failure
RestartSec=5
TimeoutStopSec=30
StandardOutput=journal
StandardError=journal
[Install]
WantedBy=multi-user.target
三块各管一件事:[Unit] 描述服务、声明启动顺序和依赖;[Service] 定义进程怎么起、怎么停、崩了怎么办;[Install] 里的 WantedBy=multi-user.target 表示跟随系统多用户模式启动,也就是开机自启的开关。
步骤 2:加载并启动
sudo systemctl daemon-reload # 让 systemd 重新读取 unit 文件
sudo systemctl enable --now myapp # 设为开机自启 + 立刻启动
systemctl status myapp
status 里看三件事:Loaded 行有没有 enabled、Active 是不是 active (running)、Main PID 是不是你的进程。这三点对了,服务就算是被 systemd 接管了。
步骤 3:看日志
不需要再在程序里写日志重定向,标准输出已经被 systemd 收走了:
journalctl -u myapp -n 100 # 最近 100 行
journalctl -u myapp -f # 实时跟踪
journalctl -u myapp --since "10 min ago"
journalctl -u myapp -p err # 只看 error 及以上
journalctl -u myapp -b -1 # 上一次开机周期的日志
步骤 4:日常操作
systemctl restart myapp # 重启
systemctl reload myapp # 平滑重载(需要配了 ExecReload)
systemctl stop myapp
systemctl disable --now myapp # 取消开机自启并停止
常见坑
-
- Type 选错,守护进程起不来。程序自己 daemon 化时(fork 后中间父进程立刻退出),用 Type=simple 会被 systemd 判定「主进程已退出」,然后把它 fork 出来的所有子进程一起杀掉,status 显示 inactive (dead)。典型例子:nginx 默认就是 daemon 模式,ExecStart=/usr/sbin/nginx 配 simple 起不来;要么改成 ExecStart=/usr/sbin/nginx -g 'daemon off;' 配 simple,要么用 Type=forking 并配 PIDFile=/run/nginx.pid。
-
- ExecStart 必须是绝对路径,且不支持管道、重定向和 &。想用管道就包装一层:ExecStart=/bin/bash -c '/opt/myapp/bin/gen | /opt/myapp/bin/load'。另外 Type=forking 才需要 PIDFile,其它类型不要配。
-
- 改完 unit 文件必须 daemon-reload。只 systemctl restart 不会重新读取文件,你会以为「改了没生效」。反过来,只改程序自己的配置文件不需要 daemon-reload。
-
- Restart=on-failure 配了却不看限流。systemd 默认 60 秒内启动超过 5 次就放弃并进入 failed 状态(StartLimitBurst/StartLimitIntervalSec),日志里能看到 start-limit-hit。配上 RestartSec=5 做退避,别让崩溃的程序把 journald 刷爆。
-
- 环境变量和登录 shell 不一致。systemd 不会加载 .bashrc / .profile,PATH 也是最小集。环境变量统一写在 Environment= 或 EnvironmentFile=(值里有空格不用引号,多个变量用空格分隔),需要 PATH 就显式写一行。
-
- 忘了 WorkingDirectory,程序按相对路径找配置直接报 No such file。代码里写相对路径的服务,务必显式指定工作目录。
- 7.(作者补充)没配 User=,服务默认以 root 跑。长期驻留的自研服务建议建独立系统用户,再加 NoNewPrivileges=true、PrivateTmp=true 做基础加固——排查权限问题时也要记得先想到这一点。
- 8.(作者补充)日志把磁盘写满。journald 默认不设上限,用 journalctl --vacuum-size=500M 紧急回收,长期方案是在 /etc/systemd/journald.conf 里设 SystemMaxUse=1G 后 systemctl restart systemd-journald。
一句话总结
一个 service 文件三块:Unit 管依赖和顺序,Service 管怎么起怎么停,Install 管开机自启。记住三件事就能少踩绝大多数坑——Type 要和程序的前台/daemon 行为匹配、ExecStart 用绝对路径、改完文件先 daemon-reload。