wayland 下 带特殊权限的 Qt GUI 程序 部署为 开机自启+守护进程

最终目标：让一个需要修改系统时间(CAP_SYS_TIME)的Qt图形界面程序，能够在用户登录后自动启动，并且在程序崩溃或关闭后能自动重启。

核心思路：不依赖任何临时的环境变量(LD_LIBRARY_PATH)，而是将所有配置“固化”到系统中，并使用正确的systemd服务类型。

一、配置程序运行环境

放置程序文件：将编译好的程序（例如 GroundStation_V1）放置在用户主目录下的固定位置，例如 /home/pi/work。

赋予程序特殊权限 (setcap)： 由于程序需要修改系统时间，而我们又希望它以普通用户身份运行，因此不能在运行时通过systemd授予能力。正确的做法是使用setcap命令，将CAP_SYS_TIME能力永久地“绑定”到可执行文件上。

# +ep 表示添加 Effective 和 Permitted 集合中的能力
sudo setcap cap_sys_time+ep /home/pi/work/GroundStation_V1

注意：这个操作是整个流程的关键之一。它会出于安全原因，禁用LD_LIBRARY_PATH环境变量，这也是我们后续必须采用ldconfig方案的原因。由于setcap禁用了LD_LIBRARY_PATH，我们必须使用系统级的方法，将私有的Qt库路径注册到系统的动态链接器缓存中。

创建链接器配置文件：在/etc/ld.so.conf.d/目录下创建一个新的.conf文件。文件名可以自定义。

sudo nano /etc/ld.so.conf.d/qt6-custom.conf

写入库路径：在文件中只写入Qt库的lib目录的绝对路径。

/home/pi/Qt/6.7.3/gcc_arm64/lib
sudo ldconfig

二、创建用户服务

要让一个GUI程序在用户登录后启动，并能正确连接到Wayland桌面，必须使用用户级服务，而不是系统级服务。

创建服务文件目录（如果不存在）： 服务文件应放在个人配置目录中，所有操作均不需要sudo。

 mkdir -p ~/.config/systemd/user

创建并编辑服务文件：

nano ~/.config/systemd/user/GroundStation_V1.service

写入最终的服务配置： 

[Unit]
# 服务描述
Description=Ground Station V1 (User Service)
# 确保在图形会话完全准备好之后再启动
After=graphical-session.target
# 确保服务作为图形会话的一部分，在用户注销时会被一同停止
PartOf=graphical-session.target[Service]
# 直接执行我们的程序。不需要任何脚本或环境变量，因为上一步已全部解决。
ExecStart=/home/pi/work/GroundStation_V1
# 指定工作目录，是个好习惯
WorkingDirectory=/home/pi/work# --- 守护进程逻辑 ---
# 无论何种原因退出，总是尝试重启
Restart=always
# 重启前等待3秒
RestartSec=3[Install]
# 将服务“挂载”到用户的图形会话目标上，实现登录自启
WantedBy=graphical-session.target

三、启动并管理服务

管理用户服务时，所有systemctl命令都需要加上--user标记，并且不需要sudo。

重载配置：让systemd的用户实例读取到我们新的服务文件。

systemctl --user daemon-reload

启用服务：设置服务随用户登录自动启动。

systemctl --user enable GroundStation_V1.service

以下是一些手动控制指令：可以随时手动启动、停止、重启或检查状态。

    systemctl --user start GroundStation_V1.servicesystemctl --user stop GroundStation_V1.servicesystemctl --user restart GroundStation_V1.servicesystemctl --user status GroundStation_V1.service