如何在Docker Ubuntu中运行xeyes？X11转发执行报错求助

问题描述 #

目标是实现X11转发，第一步验证xeyes能否正常运行，但执行时出现报错：

执行命令及报错 #

(base) jason@Jasons-Mac-mini darkmark-docker-web % docker run -it --rm --net=host -e DISPLAY -v $HOME/.Xauthority:/root/.Xauthority  my-xeyes
Error: Can't open display: /private/tmp/com.apple.launchd.abcde/org.xquartz:0

使用的Dockerfile #

FROM debian:latest
RUN apt-get update && apt-get install -y \
      x11-apps \
      && rm -rf /usr/share/doc/* && \
      rm -rf /usr/share/info/* && \
      rm -rf /tmp/* && \
      rm -rf /var/tmp/*

RUN useradd -ms /bin/bash user
USER user
CMD xeyes

问题原因 #

1. 权限路径不匹配：宿主机的.Xauthority被挂载到容器的/root/.Xauthority，但容器实际运行的是普通用户user，该用户无法读取root目录下的权限文件。
2. macOS XQuartz限制：XQuartz默认禁止网络客户端连接，Docker容器属于外部客户端，无法直接访问X服务。

解决步骤 #

1. 修正挂载路径与用户环境 #

修改运行命令，将.Xauthority挂载到普通用户的家目录，并指定用户的HOME环境变量：

docker run -it --rm --net=host -e DISPLAY -v $HOME/.Xauthority:/home/user/.Xauthority -e HOME=/home/user my-xeyes

2. 配置XQuartz允许网络连接 #

• 打开XQuartz，进入「偏好设置」→「安全性」，勾选「允许来自网络客户端的连接」。
• 重启XQuartz使设置生效。

3. 可选：优化Dockerfile（规范配置） #

在Dockerfile中直接指定用户HOME环境变量，避免运行时重复设置：

FROM debian:latest
RUN apt-get update && apt-get install -y x11-apps \
    && rm -rf /usr/share/doc/* /usr/share/info/* /tmp/* /var/tmp/*

RUN useradd -ms /bin/bash user
USER user
ENV HOME /home/user
CMD xeyes

4. 备选方案：显式指定DISPLAY地址 #

如果上述方法无效，可尝试将DISPLAY变量指定为Docker内部可访问的宿主机地址：

docker run -it --rm -e DISPLAY=host.docker.internal:0 -v $HOME/.Xauthority:/home/user/.Xauthority -e HOME=/home/user my-xeyes

内容的提问来源于stack exchange，提问作者Jason Rich Darmawan