Ubuntu22.04 Docker容器运行Scrimmage任务遇vtkXOpenGLRenderWindow连接错误求助

问题描述 #

我正尝试在Ubuntu 22.04系统的Docker容器中运行Scrimmage任务，使用以下脚本启动容器：

xhost +local:root
docker run -it \
    --ipc=host \
    --name $2 \
    --env="DISPLAY" \
    --env="QT_X11_NO_MITSHM=1" \
    --volume="/tmp/.X11-unix:/tmp/.X11-unix:rw" \
    --privileged \
    $1
xhost -local:root

进入容器运行任务时，出现VTK相关的X11连接错误：

ERROR: In /build/vtk7-yd0MKW/vtk7-7.1.1+dfsg2/Rendering/OpenGL2/vtkXOpenGLRenderWindow.cxx, line 300
vtkXOpenGLRenderWindow (0x5590cbbf87d0): bad X server connection. DISPLAY=:1. Aborting.

Aborted

怀疑是X11转发配置问题，已参考两篇Docker GUI显示相关文章，但仍未解决，求排查和解决建议。

解决建议 #

1. 确保DISPLAY变量正确传递 #

• 宿主机终端执行 echo $DISPLAY，确认输出为:0或标准格式
• 修改启动脚本，将--env="DISPLAY"替换为--env="DISPLAY=$DISPLAY"，强制容器继承宿主机的DISPLAY值，避免容器内出现:1这类错误值

2. 调整X11权限设置 #

• 执行 xhost + 临时开放X11访问权限（仅用于测试），重启容器验证是否解决问题
• 若有效，改用更安全的权限设置：xhost +local:docker，开放local域下docker用户组的X11访问权限，替代xhost +local:root

3. 验证X11套接字挂载状态 #

• 宿主机执行 ls -ld /tmp/.X11-unix，确认目录权限为drwxrwxrwt，其他用户有读写权限
• 进入容器后执行 ls /tmp/.X11-unix，检查是否存在与宿主机一致的X0等套接字文件，确保挂载正常

4. 确认MIT-SHM禁用配置生效 #

• 进入容器执行 echo $QT_X11_NO_MITSHM，确认输出为1，保证该环境变量正确设置
• VTK部分版本对MIT-SHM共享内存支持不佳，此设置可规避连接异常

5. 检查容器内X11依赖 #

• 安装容器内缺失的X11依赖：apt update && apt install -y x11-apps libx11-dev libgl1-mesa-glx
• 执行 xeyes 或 xclock 测试基础X11转发，若工具能正常显示，说明X11基础配置无问题，问题出在Scrimmage/VTK的特定配置

6. 优化Docker启动参数 #

• 移除--privileged参数，多数GUI场景无需特权模式，过度权限可能引发异常
• 添加--net=host参数，让容器使用宿主机网络，避免网络隔离导致X11连接失败

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