如何配置远程服务器Docker容器以在本地运行GUI应用？

本地笔记本（X11客户端）设置 #

Linux/macOS 本地 #

1. 打开终端，直接运行命令允许服务器访问本地X11显示：

   xhost +local:
   

   macOS用户注意：得先装XQuartz，启动后去偏好设置的「安全性」里勾选「允许来自网络的客户端连接」，再跑上面的命令。

Windows 本地 #

1. 安装Xming或者VcXsrv这类X11服务器软件，启动时选「Multiple windows」，下一步勾上「Disable access control」，完成启动即可。

Linux服务器端操作 #

1. 登录服务器后，先查看当前的DISPLAY变量：

   echo $DISPLAY
   

   输出一般是:0或者localhost:10.0，记好这个值。

启动Docker容器的正确命令 #

启动容器时必须挂载X11的socket，同时传递DISPLAY环境变量，执行以下命令：

docker run -it \
  -e DISPLAY=$DISPLAY \
  -v /tmp/.X11-unix:/tmp/.X11-unix \
  --privileged \
  你的镜像名称 /bin/bash

• 参数说明：
  • -e DISPLAY=$DISPLAY：把服务器的DISPLAY变量传递给容器
  • -v /tmp/.X11-unix:/tmp/.X11-unix：挂载X11的Unix socket，让容器能访问本地X11服务
  • --privileged：赋予容器足够权限访问X11，部分环境可能不需要，但加上更稳妥

VSCode连接容器后的验证步骤 #

1. 在VSCode的容器终端里，先确认DISPLAY变量是否正确：

   echo $DISPLAY
   

   输出要和服务器上的一致。
2. 容器未安装gedit的话先安装：

   apt update && apt install gedit -y
   

3. 直接运行gedit，本地笔记本应该会弹出gedit窗口。

踩坑提醒 #

• 要是无法连接，先检查本地X11服务是否正常运行，服务器的DISPLAY变量是否正确传递到容器。
• macOS用户启动XQuartz后需重启终端再执行xhost +local:，否则可能无效。
• 使用完毕后记得执行xhost -local:恢复安全设置，不要长期开放权限。

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