systemd service 怎么写:把自研程序做成开机自启的系统服务

技术教程 · DevOps · 自动化运维 · 2026-09-23

systemd service 怎么写:把自研程序做成开机自启的系统服务

一句话开头

用 nohup ./myapp & 起的服务,机器一重启就没了;写进 crontab @reboot 又看不到日志,也不知道它到底起来没有。正确做法是写一个 systemd service 文件:开机自启、进程崩了自动拉起、标准输出自动进 journald。下面这份模板可以直接抄,后面是几个几乎人人都会踩的坑。

前置准备

步骤 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   # 取消开机自启并停止

常见坑

一句话总结

一个 service 文件三块:Unit 管依赖和顺序,Service 管怎么起怎么停,Install 管开机自启。记住三件事就能少踩绝大多数坑——Type 要和程序的前台/daemon 行为匹配、ExecStart 用绝对路径、改完文件先 daemon-reload。