能跑起来的最小可用systemd服务必须完整包含[unit]、[service]、[install]三段，其中[install]段至少需wantedby=multi-user.target，且type需按进程行为选simple（前台常驻）或forking（后台守护），execstart须用绝对路径并显式指定user和环境变量。
能跑起来的最小可用 systemd 服务，必须写对 [Unit]、[Service]、[Install] 三段，缺一不可；漏掉 WantedBy 或用错 Type 是最常导致 systemctl enable 报错或服务静默失败的原因。
为什么 systemctl enable 总报 “unit not found” 或 “no installation config”
这不是路径问题，而是 [Install] 段缺失或格式错误。systemd 要求该段至少包含一个 WantedBy=（或 RequiredBy=），否则拒绝启用。常见错误包括：
- 忘记写
[Install]段，或段名拼错成[install]（大小写敏感） -
WantedBy值写成不存在的目标，比如WantedBy=default.target（多数发行版不定义此 target） - 把
WantedBy写在了[Service]段里，造成语法解析失败
验证方法：运行 systemctl cat your-service.service，确认输出中完整显示三个段，且 [Install] 下有且仅有合法的 WantedBy=multi-user.target 或 WantedBy=graphical.target。
Type=simple 和 Type=forking 到底怎么选
选错 Type 会导致 systemd 认为服务“已启动成功”，其实进程早已退出，或者反过来一直卡在 “activating (start)” 状态。关键看你的程序是否自己 daemonize：
-
Type=simple：适用于前台常驻进程，如 Python 脚本循环打印日志、Go 编写的 HTTP server、dotnet myapp.dll。systemd 直接把ExecStart启动的进程当主进程，它退出，服务就终止。 -
Type=forking：只用于传统守护进程，如 Nginx、Apache。它们启动时会 fork 出子进程，然后父进程立即退出。此时必须配PIDFile=，否则 systemd 找不到主进程 PID，无法管理。 -
Type=oneshot：适合初始化脚本、备份任务等执行完即退出的命令。必须加RemainAfterExit=yes，否则systemctl is-active永远返回inactive。
绝大多数自研脚本/应用应优先尝试 Type=simple；如果程序启动后立刻返回 shell，大概率是它自己后台化了——这时要么改程序禁用 daemonize，要么换 Type=forking 并提供 PIDFile。
Linux系统管理专家，覆盖12大模块：用户权限、SSH、存储、网络、systemd、防火墙、日志监控、备份恢复、TLS证书、Ansible、容器、IaC。提供配置、验证、加固、监控、备份、自动化、故障排查、回滚闭环。关键词：useradd、sudo、sshd_config、chmod、SEL...
路径、权限、环境变量这三处最容易踩坑
手动执行 ExecStart 命令能成功，不代表 systemd 下能跑通。根本原因是 systemd 运行环境更干净、更受限：
-
ExecStart必须用绝对路径，./script.sh或~/bin/app全部无效；连bash -c "xxx"都得写成/bin/bash -c "xxx" -
User=必须显式指定，不写默认是root；若脚本依赖用户家目录下的配置（如~/.config/myapp/），不设User=就会读错位置 - 环境变量几乎全清空：
$PATH默认只有/usr/bin:/bin；需要Environment=PATH=/opt/myapp/bin:/usr/local/bin:/usr/bin:/bin显式补全 -
WorkingDirectory=不设的话，当前工作目录是/，脚本里所有相对路径都会崩
调试建议：先用 sudo -u youruser /bin/bash -c 'cd /opt/myapp && ./myapp.py' 模拟 systemd 环境手动跑一次，再查 journalctl -u your-service.service -n 50 --no-pager 看真实报错。
重启策略和超时时间不是可选项，而是稳定性底线
生产环境不配 Restart 和 TimeoutSec 就等于裸奔。systemd 默认不重启崩溃进程，也不限制启动耗时：
-
Restart=on-failure覆盖大多数意外退出场景；Restart=always更激进，连正常 exit(0) 都会重启（慎用） -
RestartSec=5防止密集重启压垮系统；不设则默认 100ms，可能触发雪崩 -
TimeoutSec=30控制ExecStart最长等待时间；不设默认 90s，启动慢的服务会卡住整个 boot 流程 - 若服务启动依赖数据库或网络，务必加
After=network-online.target和Wants=network-online.target，否则TimeoutSec很容易被误触发
真正麻烦的不是服务起不来，而是它“看起来起来了”，但内部卡在连接超时、证书校验失败等半死状态——这些必须靠 journalctl 日志定位，而不是靠 systemctl status 的绿色提示。
