Docker容器无法连接DISPLAY：运行AbiWord GUI程序失败求助

核心问题 #

报错No DISPLAY主要源于两个原因：容器缺少X11/GUI运行依赖库，或用户权限不匹配导致X服务器拒绝连接。

步骤1：补全Dockerfile的依赖 #

默认Ubuntu镜像仅包含最小化环境，缺少AbiWord运行所需的GTK和X11基础库。修改Dockerfile如下：

FROM ubuntu:20.04
RUN apt update && apt install -y abiword libx11-6 libgtk-3-0 libglib2.0-0
CMD abiword

重新构建镜像：

docker build -t abiword .

步骤2：正确传递DISPLAY变量 #

先在宿主机确认当前DISPLAY值：

echo $DISPLAY

根据输出（比如:1，对应你目录里的X1），运行容器时明确传递该变量：

docker run -e DISPLAY=$DISPLAY -v /tmp/.X11-unix:/tmp/.X11-unix abiword

步骤3：匹配用户权限 #

X服务器会验证客户端用户ID，容器默认以root用户运行可能被拒绝。指定容器使用宿主机当前用户的UID/GID启动：

docker run -e DISPLAY=$DISPLAY -v /tmp/.X11-unix:/tmp/.X11-unix \
  --user $(id -u):$(id -g) \
  abiword

步骤4：确认xhost授权 #

重新执行授权命令确保local:docker被允许访问X服务器：

xhost +local:docker

执行xhost检查输出，确认列表中包含LOCAL:docker条目。

完成以上步骤后，重新启动容器即可正常打开AbiWord的GUI界面。

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