guitarrapc/jmeter-gui

docker-jmeter-gui

在Docker容器中运行Apache JMeter GUI，并通过浏览器连接访问。

可在https://hub.docker.com/r/guitarrapc/jmeter-gui%E8%8E%B7%E5%8F%96%E9%95%9C%E5%83%8F%E3%80%82

主要标签

• https://github.com/guitarrapc/docker-jmeter-gui/blob/5.6.3/src/ubuntu24.04/Dockerfile%E3%80%81https://github.com/guitarrapc/docker-jmeter-gui/blob/5.6.3/src/ubuntu24.04/Dockerfile%E3%80%81https://github.com/guitarrapc/docker-jmeter-gui/blob/5.6.3/src/ubuntu24.04/Dockerfile%E3%80%81https://github.com/guitarrapc/docker-jmeter-gui/blob/5.6.3/src/ubuntu24.04/Dockerfile%EF%BC%88%E5%9F%BA%E4%BA%8EUbuntu 24.04）
  • docker pull guitarrapc/jmeter-gui:5.6.3
• https://github.com/guitarrapc/docker-jmeter-gui/blob/5.6.3/src/alpine3.23/Dockerfile%E3%80%81https://github.com/guitarrapc/docker-jmeter-gui/blob/5.6.3/src/alpine3.23/Dockerfile%E3%80%81https://github.com/guitarrapc/docker-jmeter-gui/blob/5.6.3/src/alpine3.23/Dockerfile%EF%BC%88%E5%9F%BA%E4%BA%8EAlpine 3.23）
  • docker pull guitarrapc/jmeter-gui:5.6.3-alpine3.23
• https://github.com/guitarrapc/docker-jmeter-gui/blob/5.3/Dockerfile%EF%BC%88%E5%9F%BA%E4%BA%8EAlpine%E7%9A%84%E6%97%A7%E7%89%88%E6%9C%AC%EF%BC%8C%E9%9C%80%E8%A6%81VNC%E6%88%96RDP%E5%AE%A2%E6%88%B7%E7%AB%AF%EF%BC%89
  • docker pull guitarrapc/jmeter-gui:5.3

设计背景

Apache JMeter是一款基于GUI的性能测试工具，但搭建其运行环境存在挑战：

• Java依赖：需要特定JDK版本和环境配置
• 平台差异：不同操作系统上的行为可能不一致
• 安装开销：可能不想在主机直接安装JMeter

本Docker镜像通过在容器化环境中提供JMeter GUI并支持浏览器访问，解决了这些问题：

• 基于浏览器操作：使用KasmVNC直接通过Web浏览器访问JMeter GUI，无需安装VNC/RDP客户端
• 零客户端配置：仅需Web浏览器即可在任何操作系统上操作JMeter GUI
• 跨平台支持：提供基于Ubuntu 24.04和Alpine 3.23的镜像版本
• 文件共享便捷：挂载主机目录可创建和保存.jmx场景文件
• 环境清洁：无需在主机安装Java或JMeter，保持系统清洁
• 行为一致性：确保在不同平台上的操作行为一致

使用方法

使用Docker Run

挂载场景目录运行容器：

shell
docker run -itd --rm -v ${WORK_DIR}/:/root/jmeter/ -p 8080:8080 guitarrapc/jmeter-gui:latest

• 端口8080：用于浏览器访问
• 可用版本：
  • guitarrapc/jmeter-gui:5.6（基于Ubuntu 24.04）
  • guitarrapc/jmeter-gui:5.6.3-alpine3.23（基于Alpine 3.23）

使用Docker Compose

完整示例见samples目录：

shell
cd samples
docker compose up

连接JMeter GUI

本镜像使用KasmVNC（Ubuntu版本）或noVNC（Alpine版本）实现浏览器访问：

1. 使用Docker run或Docker Compose启动容器
2. 打开Web浏览器
3. 访问：http://localhost:8080
4. JMeter GUI将直接在浏览器中可用

此方法适用于任何操作系统（Windows、macOS、Linux），无需额外软件。

JMeter使用

容器启动时会自动启动JMeter GUI。

通过GUI配置测试场景，将场景文件（.jmx）保存到挂载卷（容器内/root/jmeter目录），即可从主机访问这些文件。

构建

本地构建Docker镜像：

shell
docker build -t jmeter-gui:5.6.3-ubuntu24.04 -f ./src/ubuntu24.04/Dockerfile src/ubuntu24.04/
docker build -t jmeter-gui:5.6.3-alpine3.23 -f ./src/alpine3.23/Dockerfile src/alpine3.23/

运行本地构建的镜像：

shell
docker run -it --rm -v ${PWD}/scenarios:/root/jmeter/ -p 8080:8080 jmeter-gui:5.6.3-ubuntu24.04
docker run -it --rm -v ${PWD}/scenarios:/root/jmeter/ -p 8080:8080 jmeter-gui:5.6.3-alpine3.23

版本信息

• 基础镜像：Ubuntu 24.04、Alpine 3.23
• JMeter：5.6.3
• JMeter Plugins Manager：1.10

许可证

本项目采用MIT许可证。