systemd 服务必须包含 [unit]、[service]、[install] 三区块：[unit] 定义描述与启动依赖，[service] 配置执行方式、用户及重启策略，[install] 设置启用目标；路径须绝对，环境变量需显式声明，日志默认走 journal。
写一个能被 systemd 正确识别、启动、重启和管理的守护进程服务脚本，关键不是“写个脚本”，而是按规范组织 .service 文件，并让服务行为可预期、可调试、可维护。核心在于三个区块各司其职：依赖声明清晰、执行逻辑明确、安装策略合理。
基础结构必须包含三块
所有有效的 systemd 服务文件都由 [Unit]、[Service]、[Install] 三个区块组成，缺一不可：
-
[Unit]：说明“这个服务是什么、什么时候该启动”。重点用
Description写清用途，用After和Wants表达启动时机（如After=network.target+Wants=network-online.target比单写 network.target 更稳妥）；避免滥用Requires，除非真需要强阻断。 -
[Service]：定义“怎么跑、以谁身份跑、出错了怎么办”。
ExecStart必须是绝对路径；Type根据进程行为选：simple（前台常驻）、oneshot（执行完就退出，配RemainAfterExit=yes）、forking（传统 daemon 启动方式）；User/Group强烈建议指定非 root 用户。 -
[Install]：决定“要不要开机自启”。只写
WantedBy=multi-user.target即可覆盖绝大多数服务器场景；启用时执行systemctl enable xxx实际就是创建软链接到该 target 的 wants 目录下。
关键配置项避坑指南
几个高频出错点，直接关系到服务是否真能“守得住”：
-
路径必须绝对：
ExecStart=/usr/bin/python3 /opt/app/main.py，不能写~/app/main.py或依赖 PATH；脚本内也建议全用绝对路径（如/bin/mkdir而非mkdir）。 -
重启策略要匹配服务类型：常驻服务用
Restart=on-failure或always，配合RestartSec=5防止狂刷日志；一次性任务不用设 Restart，否则会报错。 -
日志输出别丢：默认
StandardOutput=journal就够用，查日志统一用journalctl -u xxx.service -n 50；若需落盘，改用file:/var/log/xxx.log，但得确保目录存在且权限正确。 -
环境变量要显式声明：不要指望 shell profile 生效。用
Environment="PATH=/usr/local/bin:/usr/bin"或EnvironmentFile=/etc/sysconfig/xxx加载外部变量文件。
生产可用模板（Python Web 服务示例）
以下是一个经过多发行版验证的通用模板，替换路径和用户后即可部署：
[Unit]
Description=My Python API Service
After=network.target
Wants=network-online.target
[Service]
Type=simple
User=www-data
Group=www-data
WorkingDirectory=/opt/myapi
ExecStart=/usr/bin/python3 /opt/myapi/app.py
Restart=on-failure
RestartSec=10
Environment="PYTHONUNBUFFERED=1"
StandardOutput=journal
StandardError=journal
[Install]
WantedBy=multi-user.target
启用与验证一步到位
写完文件后，四条命令走完流程：
- 重载配置：
sudo systemctl daemon-reload（漏掉这步，systemd 完全看不见新服务） - 启用自启：
sudo systemctl enable myapi.service - 立即启动：
sudo systemctl start myapi.service - 检查状态：
sudo systemctl status myapi.service（看 Active 状态和最近几行日志）
