linux中编写带参数传递的systemd服务，核心是使用模板单元（如myapp@.service），通过%i占位符动态注入实例名，并结合environment、environmentfile或配置文件映射等方式传递多参数；启动时指定实例名（如systemctl start myapp@prod），实现灵活、可复用的多实例管理。
Linux中编写带参数传递的systemd服务，核心是使用模板单元（template unit），而不是为每个参数组合写一个独立的.service文件。这种方式灵活、可复用，适合多实例或配置差异化场景，比如启动多个监听不同端口的Web服务、运行多个数据库实例、或按环境（dev/staging/prod）加载不同配置。
创建模板单元文件（your-service@.service）
模板文件名必须以@结尾，例如myapp@.service，存放在/etc/systemd/system/目录下：
- 文件路径：
sudo nano /etc/systemd/system/myapp@.service - 关键标识符：
%i代表实例名（如start、port8080），%n代表完整单元名（如myapp@port8080.service），%u代表运行用户 - 示例内容：
[Unit]
Description=MyApp instance %i
After=network.target
[Service]
Type=simple
User=myuser
WorkingDirectory=/opt/myapp
Environment=INSTANCE_NAME=%i
ExecStart=/opt/myapp/bin/start.sh --env %i --config /etc/myapp/conf-%i.yaml
Restart=on-failure
RestartSec=3
[Install]
WantedBy=multi-user.target
通过实例名启动和启用服务
模板本身不能直接启动，必须指定实例名：
Agent Memory System v12
下载
Agent 记忆系统 — 五路融合检索 + 双时间线 + 因果链 + Spirit管家 + 记忆回声 + 弹性配置 + Circuit Breaker + GDPR合规 + 192项安全审计修复
- 启动单个实例：
sudo systemctl start myapp@prod（自动解析为myapp@prod.service） - 启用开机自启：
sudo systemctl enable myapp@staging - 查看状态：
systemctl status myapp@prod - 查看日志：
journalctl -u myapp@prod -f
参数传递的几种实用方式
单纯靠%i只能传一个字符串。如需多个参数或复杂配置，推荐以下组合策略：
-
环境变量注入：在
[Service]中用Environment=KEY=VALUE或EnvironmentFile=/etc/myapp/env-%i.conf加载实例专属变量 -
配置文件映射：将
%i作为配置文件后缀，如/etc/myapp/app-%i.conf，让程序自己读取 -
命令行拼接：在
ExecStart中直接使用%i，如ExecStart=/usr/bin/node server.js --port %i（此时% i应为数字如3000） -
避免硬编码路径：不要在
ExecStart里写死绝对路径加参数；统一用%i或环境变量驱动，保持模板纯净
验证与调试要点
模板服务容易因路径、权限或变量未展开而失败，调试时注意：
- 执行
sudo systemctl daemon-reload后，用systemctl cat myapp@demo确认systemd实际解析出的内容 - 检查
%i是否被正确替换：运行systemctl show myapp@dev | grep ExecStart - 若报“no such file or directory”，大概率是
ExecStart路径不存在，或脚本缺少执行权限（chmod +x） - 日志中出现
Failed at step EXEC spawning，通常意味着命令解析失败或环境缺失
