3 步把你的脚本变成开机自启服务 — systemd 单元文件一篇讲透
技术教程 · DevOps · 自动化运维 · 2026-09-05
3 步把你的脚本变成开机自启服务 — systemd 单元文件一篇讲透
你写了个爬虫、同步脚本,或一个常驻的 Python/Node 服务,现在是手动 nohup 跑着。机器一重启就没了,进程崩了也不会自动拉起。今天用 systemd 一篇解决:3 个步骤,把任何长跑程序变成开机自启、崩溃自动重启的标准服务。
前置准备
-
一台 Linux 机器(systemd 已是 RHEL/CentOS/Fedora/Ubuntu/Debian 默认 init,绝大多数发行版自带)
-
一个你写好、能在前台正常运行的长跑程序。本文以 /opt/myapp/start.sh 为例
步骤 1:写一个 .service 文件
把你自己的服务单元文件放到 /etc/systemd/system/ 目录(这里优先级最高,是给你自定义和覆盖用的,不要改 /lib/systemd/system/ 里包自带的文件)。
sudo vim /etc/systemd/system/myapp.service
一个最小可用的服务文件长这样:
[Unit]
Description=My App Service
After=network.target
[Service]
Type=simple
User=www-data
WorkingDirectory=/opt/myapp
ExecStart=/bin/bash /opt/myapp/start.sh
Restart=on-failure
RestartSec=5
[Install]
WantedBy=multi-user.target
几个关键项说明:
-
Type=simple:默认值,systemd 认为进程一启动就算服务起来了。适合前台进程;老式后台 fork 的守护进程要用 Type=forking,并配合 PIDFile=。
-
ExecStart:真正要跑的命令,必须写完整路径,默认不做 shell 展开、不支持管道。真要用 shell 特性才写 /bin/bash -c '...',否则直接调二进制。
-
User=:以非 root 用户跑,网络暴露的服务务必这么做。
-
Restart=on-failure:只在退出码非 0、被信号杀、超时等异常时重启,比 Restart=always 更稳妥。
步骤 2:加载并启动
sudo systemctl daemon-reload # 让 systemd 读到新文件
sudo systemctl start myapp # 立即启动
sudo systemctl enable myapp # 设置开机自启
# 两条合并成一条:enable --now
每次改完 .service 文件,都要先 daemon-reload 再 restart,否则改动不生效——这是最常见的「改了没反应」的原因。
步骤 3:验证 + 看日志
systemctl status myapp # 看状态 + 最近几行日志
journalctl -u myapp -f # 实时跟踪日志
journalctl -u myapp -n 50 # 最近 50 行
服务把 stdout/stderr 写进 journal,用 journalctl 就能抓到报错。
常见坑(含作者补充)
-
status=203/EXEC:ExecStart 里的二进制找不到或没执行权限,几乎都是路径或 chmod 问题。
-
status=217/USER:User= 指定的用户不存在,先 useradd 建好用户。
-
status=200/CHDIR:WorkingDirectory 目录不存在或没访问权限。
-
「Start request repeated too quickly」:服务疯狂崩溃重启,systemd 触发启动限流后放弃。用 systemctl reset-failed myapp 清计数,并加 RestartSec= 避免抖动。(作者补充:生产环境见过一个服务每 0.5 秒崩一次、日志刷满磁盘,就是没配 RestartSec 的坑)
-
改了配置没生效:漏了 daemon-reload。改一次 reload 一次,别省这一步。
一句话总结
写一个 .service 文件([Unit]/[Service]/[Install] 三段),daemon-reload + enable --now 两步启用,剩下的交给 systemd 自动拉起。你的脚本从此不用再 nohup 裸奔。