在Docker容器中开启Perl Tk图形界面显示的问题

报错原因 #

容器内的Perl Tk程序需要X11显示服务器渲染图形界面，但Docker容器默认没有独立的X环境，也无法自动访问主机的X服务器，因此出现couldn't connect to display ":0"错误。

解决方案 #

1. 配置主机X服务器权限（Linux） #

先允许本地容器访问主机的X服务器：

xhost +local:

注：操作完成后可执行xhost -local:恢复安全限制，避免非授权程序访问X服务器。

2. 正确运行容器 #

执行容器时，需要挂载主机的X11套接字并传递DISPLAY环境变量：

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

参数说明：

• -v /tmp/.X11-unix:/tmp/.X11-unix：将主机的X11套接字挂载到容器内，让容器程序能连接到主机的X服务器
• -e DISPLAY=$DISPLAY：把主机当前的DISPLAY环境变量传给容器，指定程序使用的X显示端口

3. macOS用户额外操作 #

如果是macOS主机，需要先安装XQuartz：

1. 安装XQuartz后，打开偏好设置的「安全性」，勾选「允许来自网络客户端的连接」
2. 重启XQuartz，执行命令开放权限：

xhost +localhost

3. 运行容器时调整DISPLAY变量：

docker run -it --rm \
  -v /tmp/.X11-unix:/tmp/.X11-unix \
  -e DISPLAY=host.docker.internal:0 \
  你的镜像名称

验证 #

运行上述命令后，容器内的Perl Tk脚本会正常弹出「Hello World」窗口，点击「Done」按钮即可退出程序。

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