systemd服务文件必须放在/etc/systemd/system/(系统级)或/usr/lib/systemd/system/(发行版自带)才生效,用户自定义服务务必置于/etc/systemd/system/,否则daemon-reload无法加载。

systemd服务文件必须放在哪个目录才生效
systemd只认/etc/systemd/system/(系统级)和/usr/lib/systemd/system/(发行版自带)这两个路径下的.service文件。用户自定义服务务必放/etc/systemd/system/,否则systemctl daemon-reload不会加载它。
常见错误是把服务文件丢进/etc/init.d/或家目录下,然后反复systemctl enable失败——那根本不是systemd的扫描范围。
- 服务文件名必须以
.service结尾,例如backup-script.service - 文件权限建议为
644(root:root),避免因权限问题拒绝加载 - 修改服务文件后,必须运行
systemctl daemon-reload,否则start/enable仍用旧配置
如何让systemd定期执行Shell脚本(非长期守护进程)
别直接写Type=simple然后指望它“定时跑一次”——那是误解。真正做周期性任务,得用Timer单元,配合一个Service单元协同工作。
比如要每天凌晨2点运行/opt/scripts/backup.sh:
PyCharm 2026.2.0.1 Linux版提供 JetBrains 官方 2026.2.0.1 版本安装包,适合需要指定 PyCharm 版本进行 Python 项目开发、运行和调试的用户。
- 先写服务单元
/etc/systemd/system/backup-script.service:[Unit] Description=Run backup script [Service] Type=oneshot ExecStart=/opt/scripts/backup.sh User=root
- 再写定时器单元
/etc/systemd/system/backup-script.timer:[Unit] Description=Run backup script daily [Timer] OnCalendar=*-*-* 02:00:00 Persistent=true [Install] WantedBy=timers.target
- 启用定时器:
systemctl daemon-reload && systemctl enable --now backup-script.timer
Persistent=true很重要:如果机器在预定时间关机,开机后会补跑一次;不加这行,错过就真的错过了。
Shell脚本在systemd中执行失败的典型原因
脚本在终端能跑,放进systemd就报Failed with result 'exit-code',大概率是环境差异导致的。
- systemd默认
PATH极简(通常只有/usr/bin:/bin),脚本里用python3或jq却没写绝对路径,会找不到命令 - 脚本依赖当前工作目录(如
./config.json),但systemd默认工作目录是/,需显式设置WorkingDirectory=/opt/scripts - 脚本读取
$HOME下的配置(如~/.netrc),但User=root时$HOME是/root,且systemd可能未正确继承该变量,应改用Environment="HOME=/root" - 输出重定向被忽略——systemd不处理
> /tmp/log这类重定向,日志全走journalctl -u backup-script.service
调试systemd服务脚本最有效的三步
别靠echo加日志文件猜,systemd有现成链路。
- 立即查看最近一次执行详情:
journalctl -u backup-script.service -n 50 -o cat(-o cat去掉时间戳和元数据,干净看输出) - 检查服务实际运行环境:
systemctl show backup-script.service | grep -E "(Environment|WorkingDirectory|User|ExecStart)" - 手动模拟systemd环境运行脚本:
sudo -u root PATH=/usr/bin:/bin /opt/scripts/backup.sh,复现问题最快
注意:timer触发的服务实例在journal里会显示为带随机后缀的unit名(如backup-script@abc123.service),查日志时用journalctl -u backup-script*更稳妥。










