必须写.service文件放/etc/systemd/system/并用绝对路径配execstart，否则服务无法启动；常见失败原因是路径错误（如相对路径、~符号）或权限不足，且systemd不解析shell特性、不继承用户环境。

必须写 .service 文件，放 /etc/systemd/system/，用绝对路径配 ExecStart，否则服务根本起不来。

为什么 systemctl start 报 failed 且 journalctl -u your.service 看不到有效日志

多半是 ExecStart 指向的程序没权限执行，或路径写错（比如用了相对路径、~ 符号、未加 /bin/sh -c 包裹脚本）。systemd 不会帮你展开 shell 特性，也不会继承你的用户环境变量。

• 检查二进制或脚本是否可执行：ls -l /path/to/your-program，确保有 x 权限
• 所有路径必须为绝对路径：ExecStart=/opt/myapp/bin/server ✅，ExecStart=./server ❌
• 如果启动的是 shell 脚本且含重定向/管道等，显式调用 /bin/sh：ExecStart=/bin/sh -c '/opt/myapp/run.sh >> /var/log/myapp.log 2>&1'
• 手动运行一遍 ExecStart 命令，确认它能在当前终端里直接跑通

Type=simple 还是 Type=forking？选错就卡在 activating 状态

绝大多数自定义程序应优先用 Type=simple——只要你的程序前台运行、不自行 fork+exit 主进程，就选它。误配 forking 会导致 systemd 等不到子进程上线，最终超时失败。

Linux Ai Server

Linux AI 服务器 — 将 Linux 服务器转换为本地 AI 推理集群。使用 systemd、NVIDIA CUDA 实现无头 Linux AI，零 GUI 开销。

下载

• Type=simple：程序启动后立即进入前台运行（如 Python HTTP server、Go CLI daemon），systemd 认为主进程就是 ExecStart 启动的那个进程
• Type=forking：仅适用于传统 daemon，启动后主进程立刻 exit，靠子进程继续运行（如老版本 nginx、redis-server）；此时必须配 PIDFile=，否则 systemd 无法跟踪进程
• 不确定时，先试 Type=simple；若程序启动后立即返回 shell，但你期望它持续运行，说明它默认后台化了——得关掉它的 daemonize 选项，或改用 Type=oneshot + RemainAfterExit=yes（适合初始化类任务）

服务启得起来但一断网/重启就挂，或者想限制资源怎么办

默认情况下，systemd 对服务几乎不做约束，它跑得像 root 用户直接敲命令一样“自由”，这既是便利也是隐患。

• 加依赖：在 [Unit] 里写 After=network.target 或 Wants=network-online.target，避免网络未就绪就启动
• 指定用户：用 User=www-data 和 Group=www-data，禁止以 root 运行非必要服务
• 设工作目录：WorkingDirectory=/opt/myapp，避免程序因 cwd 错误找不到配置或数据文件
• 加重启兜底：Restart=on-failure + RestartSec=3，防止崩溃后静默退出
• 限资源（可选）：MemoryMax=256M、CPUQuota=75%、LimitNOFILE=65536，防止单个服务吃光系统资源

改完配置却没生效，systemctl enable 提示 WantedBy 缺失

[Install] 节不是可选的——没有它，systemctl enable 就会报错，服务也无法开机自启。

• WantedBy=multi-user.target 是最常用值，对应命令行多用户模式（即非图形界面的常规服务器环境）
• 别写成 WantedBy=default.target，它在某些发行版中行为不稳定，且不保证是 multi-user
• 每次修改 .service 文件后，必须运行 sudo systemctl daemon-reload，否则 systemd 完全读不到新内容
• enable 只建立软链接，start 才真正触发运行；调试阶段建议先 start 再 enable

最容易被忽略的是：systemd 不会自动创建日志目录、数据目录或用户主目录。如果你的程序要写 /var/log/myapp/ 或读 /home/myuser/.config/，这些路径得提前手动建好、赋权，否则服务会在 open() 或 chdir() 阶段静默失败。