Windows下运行XServer时无法在Docker中启动Qt应用

问题描述 #

主机系统为Windows 10 22H2，Docker新手。已在Windows上安装并启动XServer，但运行命令docker run --rm -it -e -DISPLAY=host.docker.internal:0.0 -e QT_X11_NO_MITSHM=1 myapp后，出现Qt平台插件初始化失败的错误。

错误信息 #

从插件元数据获取密钥("xcb")
QFactoryLoader::QFactoryLoader() 检查目录路径"/home/ws/install/myapp/bin/platforms"...
已加载库"/usr/lib/x86_64-linux-gnu/qt5/plugins/platforms/libqxcb.so"
qt.qpa.xcb: 无法连接到显示器
qt.qpa.plugin: 已找到Qt平台插件"xcb"，但无法加载。
此应用程序无法启动，因为无法初始化Qt平台插件。重新安装应用程序可能会解决此问题。

可用的平台插件有: eglfs, linuxfb, minimal, minimalegl, offscreen, vnc, xcb。

已中止
root@772204fed0fb:/home/ws# exit

问题原因及解决方法 #

1. 环境变量参数错误 #

你运行的命令中，-e -DISPLAY=host.docker.internal:0.0多了一个多余的减号，导致DISPLAY环境变量未被正确设置，这是无法连接显示器的直接原因。

修正后的命令：

docker run --rm -it -e DISPLAY=host.docker.internal:0.0 -e QT_X11_NO_MITSHM=1 myapp

2. XServer访问控制未关闭 #

确保你使用的XServer（如VcXsrv）启动时勾选了Disable access control选项，否则Docker容器会被拒绝连接到XServer。

3. Windows防火墙拦截 #

检查Windows防火墙是否阻止了XServer的默认端口（6000端口对应:0.0），如果有，添加允许规则放行该端口的入站连接。

4. 容器内缺少X11依赖库 #

Qt的xcb插件需要依赖一些X11库，容器内如果缺少这些库，即便找到插件文件也无法加载。以Debian/Ubuntu系统为例，可在容器内执行以下命令安装依赖：

apt-get update && apt-get install -y libxcb-xinerama0 libxcb-cursor0 libxcb-util1

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