概述
本文记录 natpierce 和 sunshine 两个服务的正确配置方法。
区别
| 环境 | 适合运行 | 图形支持 |
|---|---|---|
| 系统服务 (root) | 系统守护进程、硬件服务 | ❌ 无图形环境 |
| 用户服务 (普通用户) | GUI 程序、用户级守护 | ✅ 完整图形环境 |
1. NatPierce 服务（系统级服务）
特点
- 系统守护进程
- root 权限运行
- 无需图形界面
服务文件
[Unit]
Description=NatPierce Service
After=network.target
[Service]
Type=simple
ExecStart=/opt/natpierce/natpierce
Restart=always
RestartSec=5
User=root
[Install]
WantedBy=multi-user.target
文件位置
- 服务文件：
/etc/systemd/system/natpierce.service
2. Sunshine 服务（用户级服务）
特点
- GUI 程序，需要图形环境
- 登录后自启动
- 关闭/崩溃自动重启
服务文件
[Unit]
Description=Sunshine Game Streaming
After=graphical-session.target
[Service]
ExecStartPre=/bin/sleep 3
ExecStart=/opt/sunshine/sunshine.AppImage
Restart=always
RestartSec=5
[Install]
WantedBy=graphical-session.target
Wayland 推荐使用
KWin screencast捕获；推荐使用最新预发布版本sunshine
文件位置
- 服务文件：
/etc/systemd/user/sunshine.service
参数说明
ExecStartPre=/bin/sleep 3- 等待 3 秒确保图形环境就绪Restart=always- 任何退出（包括手动关闭）都会自动重启RestartSec=5- 重启间隔 5 秒
常用命令
NatPierce (系统服务)
# 启动/停止/重启
sudo systemctl start natpierce.service
sudo systemctl stop natpierce.service
sudo systemctl restart natpierce.service
# 查看状态
sudo systemctl status natpierce.service
# 查看日志
sudo journalctl -u natpierce.service -f
# 开机自启
sudo systemctl enable natpierce.service
Sunshine (用户服务)
# 启动/停止/重启
systemctl --user start sunshine.service
systemctl --user stop sunshine.service
systemctl --user restart sunshine.service
# 查看状态
systemctl --user status sunshine.service
# 查看日志
journalctl --user -u sunshine.service -f
# 重新加载配置（修改 service 文件后需要）
systemctl --user daemon-reload
# 开机自启
systemctl --user enable sunshine.service
注意事项
- GUI 程序必须用用户服务：不能用系统服务运行 GUI，否则会因缺少显示环境变量而失败
- 用户服务需要在登录后运行：图形会话启动后才会运行
- 服务文件位置：
- 系统服务：
/etc/systemd/system/ - 用户服务：
/etc/systemd/user/
- 系统服务：
