Win10下如何配置MobXterm X服务器实现Docker GUI应用正常显示并规避报错

步骤1：配置MobaXterm X服务器权限 #

• 打开MobaXterm，点击顶部菜单栏「Settings」→「Configuration」
• 切换到「X11」选项卡，将X11 remote access参数设置为full
• 取消勾选「X11 access control」选项，避免容器访问被拦截
• 保存配置后重启MobaXterm，确认X服务正常启动（MobaXterm右上角会显示X服务运行状态）

步骤2：获取Windows本地IP地址 #

• 按下Win+R组合键，输入cmd打开命令提示符
• 执行命令ipconfig，找到当前在用网络（WiFi/以太网）对应的IPv4地址，示例为192.168.1.10，后续替换为自己的实际IP即可

步骤3：配置Docker容器DISPLAY环境变量 #

方式一：启动容器时直接传入参数 #

执行启动命令时添加环境变量参数：

docker run -it -e DISPLAY=你的WindowsIP:0.0 镜像名 /bin/bash

示例：

docker run -it -e DISPLAY=192.168.1.10:0.0 ubuntu:22.04 /bin/bash

方式二：已运行容器手动配置 #

进入容器后执行命令配置临时环境变量：

export DISPLAY=你的WindowsIP:0.0

执行echo $DISPLAY确认参数生效即可。
如果使用WSL2后端的Docker，可直接用host.docker.internal:0.0代替手动查询的Windows IP，无需每次修改地址

步骤4：验证配置有效性 #

以Debian/Ubuntu系镜像为例，先安装X11测试工具：

apt update && apt install x11-apps -y

执行xclock命令，若MobaXterm弹出图形化时钟窗口，则配置生效，此时运行tkinter类GUI程序不会再出现_tkinter.TclError: no display name and no $DISPLAY environment variable报错。

常见问题排查 #

• 无法显示时优先检查Windows防火墙是否放行MobaXterm的入站规则，确认6000端口（X服务默认端口）未被其他程序占用
• X服务依赖MobaXterm运行，使用容器GUI程序时不要关闭MobaXterm

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