🚀 SOP：如何在 WSL 中配置并运行自定义 systemd 服务
🎯 目标与触发 (Goal & Trigger)
Summary
场景：需要在 WSL 后台持久化运行某个服务（如：自定义 API 代理、数据库或自动化脚本），且希望随 WSL 启动而自动启动。
结果：✅ 服务在
systemctl监管下稳定运行，并能通过journalctl查看日志。
🛠 环境准备 (Environment)
- 运行环境: WSL2 (Ubuntu 22.04+ 推荐) ✅ 2026-03-07
- 核心配置:
/etc/wsl.conf已开启 systemd 支持。 ✅ 2026-03-07 - 必要权限: 具有
sudo权限的非 root 用户。 ✅ 2026-03-07
🪜 核心流程 (The Workflow)
阶段一：开启 WSL 的 systemd 支持（仅需执行一次）
- 检查并编辑配置
在 WSL 终端中执行：
sudo nvim /etc/wsl.conf- 写入以下内容：
[boot]
systemd=true- 重启 WSL（在 Windows PowerShell 执行）：
wsl --shutdown阶段二：编写 Unit 单元文件
- 创建并编辑服务文件
sudo nvim /etc/systemd/system/my-service.service- 填充标准模板（按需修改
ExecStart）：
[Unit]
Description=My Custom Script Service
After=network.target
[Service]
Type=simple
User=<% tp.user.env("USER") %>
WorkingDirectory=/home/<% tp.user.env("USER") %>/scripts
ExecStart=/usr/bin/python3 main.py
Restart=always
[Install]
WantedBy=multi-user.target阶段三：激活与启动
- 重载系统配置：
sudo systemctl daemon-reload- 启动并设置自启：
sudo systemctl enable --now my-service✅ 验证环节 (Validation)
满足以下条件视为执行成功：
执行
systemctl status my-service显示active (running)。执行
journalctl -u my-service -n 20能看到正常的输出日志。
⚠️ 常见坑点 (Troubleshooting)
- ❌ 避坑: 不要把
ExecStart指向一个会自动退出的脚本（如没加死循环的 Shell），否则服务会不断重启。 - 🔧 排错:
- 现象:
System has not been booted with systemd as init system. - 方案: 检查第一步的
wsl.conf是否配置正确，并确保执行了wsl --shutdown。