Docker运行JMeter报错：X11 DISPLAY变量未设置及连接失败问题求助

报错原因 #

你遇到的问题是因为JMeter默认尝试启动图形界面（GUI），但Docker容器本身没有X11显示环境，不管是否手动设置DISPLAY变量，都无法直接连接到有效的X11服务器。

推荐方案：无头模式运行（无需GUI） #

JMeter压测或执行测试计划根本不需要图形界面，用命令行无头模式是标准用法，完全避开X11依赖问题：

• 挂载本地目录到容器，让容器能读取你的测试计划文件，同时保存结果到本地：

  docker run --rm -v /你的本地测试计划目录:/mnt justb4/jmeter -n -t /mnt/你的测试计划.jmx -l /mnt/测试结果.jtl
  

  参数说明：
  • -n：启用无头模式（不启动GUI）
  • -t：指定要运行的JMeter测试计划文件路径
  • -l：指定测试结果输出文件路径
  • -v：将本地目录挂载到容器的/mnt目录，实现文件共享

可选方案：启用JMeter GUI（仅用于编写/调试测试计划） #

如果一定要用GUI，需要让容器连接宿主机的X11服务器，分两种系统处理：

Linux/macOS宿主机 #

1. 先允许宿主机X11服务器接受本地容器的连接：

   xhost +local:root
   

   （测试完成后记得执行xhost -local:root关闭，避免安全风险）
2. 运行容器时挂载X11套接字并传递DISPLAY变量：

   docker run --rm -e DISPLAY=$DISPLAY -v /tmp/.X11-unix:/tmp/.X11-unix justb4/jmeter
   

Windows Docker Desktop宿主机 #

1. 先安装X11服务器软件（比如VcXsrv），启动时勾选Disable access control选项
2. 查看宿主机的内网IP（比如通过ipconfig找到WLAN的IPv4地址）
3. 运行容器时设置DISPLAY为宿主机IP加:0.0，并挂载X11相关路径：

   docker run --rm -e DISPLAY=192.168.x.x:0.0 -v /tmp/.X11-unix:/tmp/.X11-unix justb4/jmeter
   

   （把192.168.x.x替换成你的宿主机实际内网IP）

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