Docker中XFCE桌面下非root用户无法正常运行QT图形应用

1. 修复QT插件目录权限 #

QT插件加载失败是这类问题的常见原因，直接检查QT核心插件目录的权限：

# 检查QT插件根目录权限
ls -ld /usr/lib/x86_64-linux-gnu/qt5/plugins/
# 重点检查平台插件目录（比如xcb，QT图形渲染依赖它）
ls -l /usr/lib/x86_64-linux-gnu/qt5/plugins/platforms/

如果发现guiuser组/其他用户没有读和执行权限，执行以下命令递归调整：

chmod -R a+rX /usr/lib/x86_64-linux-gnu/qt5/plugins/

注：a+rX会给所有用户读权限，以及对目录的执行权限（保证能进入目录），不修改文件的执行权限（安全）

2. 配置guiuser的QT环境变量 #

XFCE的默认环境变量可能缺少QT所需的路径，在guiuser的启动脚本（比如~/.bashrc或~/.xsessionrc）中添加：

# 指定QT平台插件路径
export QT_QPA_PLATFORM_PLUGIN_PATH=/usr/lib/x86_64-linux-gnu/qt5/plugins/platforms/
# 开启插件调试（可选，用于排查加载失败细节）
export QT_DEBUG_PLUGINS=1
# 确保DISPLAY变量与VNC会话一致
export DISPLAY=:1

保存后重新登录guiuser，再运行应用，查看调试输出确认插件是否正常加载。

3. 提前在Dockerfile中处理应用权限 #

避免后续guiuser需要sudo安装应用，在Dockerfile中以root身份完成安装后，直接将应用目录权限移交guiuser：

# 假设应用安装到/opt/myapp目录
RUN make install
RUN chown -R guiuser:guiuser /opt/myapp/
# 切换到guiuser
USER guiuser

如果应用依赖系统级库，确保安装时就给所有用户读权限（比如用apt-get install -y --no-install-recommends qt5-default，这类包默认权限正确，但自定义编译的库需要手动调整）。

4. 修复XFCE的X11访问权限 #

XFCE对X服务器的权限限制可能比Gnome严格，执行以下命令让guiuser能正常访问X11：

# 以root身份执行，允许guiuser访问本地X服务器
xhost +local:guiuser

也可以把这条命令加到VNC的启动脚本中（比如~/.vnc/xstartup），确保每次启动VNC会话都自动配置。

内容的提问来源于stack exchange，提问作者Omi