在 Ubuntu 上部署 Apache JMeter 的完整步骤
一 准备环境
- 安装 Java(JMeter 为 Java 应用)。推荐 OpenJDK 11 或 OpenJDK 17:
- 更新索引并安装:sudo apt update && sudo apt install -y openjdk-11-jdk
- 验证版本:java -version
- 说明:JMeter 5.x 需 Java 8+;在无图形环境优先使用 非 GUI 模式运行测试。
二 安装 JMeter
- 方式一 手动安装(推荐,便于多版本管理与升级)
- 前往官网页面复制下载链接并使用 wget 获取压缩包(示例为 5.6.3,可按需替换为最新稳定版):
- wget https://dlcdn.apache.org/jmeter/binaries/apache-jmeter-5.6.3.tgz
- 解压至系统目录(如 /opt):
- sudo tar -zxvf apache-jmeter-5.6.3.tgz -C /opt/
- 配置环境变量(将 JMeter 的 bin 目录加入 PATH):
- echo ‘export PATH=$PATH:/opt/apache-jmeter-5.6.3/bin’ >> ~/.bashrc
- source ~/.bashrc
- 验证安装:
- 方式二 APT 安装(便捷,版本可能滞后)
- 安装:sudo apt install -y jmeter
- 启动:jmeter
- 提示:手动安装更灵活,适合需要特定版本或同时保留多版本的场景。
三 运行与测试执行
- 图形界面(仅在有桌面环境的 Ubuntu 上使用,远程服务器不建议):
- 非 GUI 模式(服务器/CI 推荐):
- 基本执行:jmeter -n -t /path/to/testplan.jmx -l /path/to/results.jtl
- 生成 HTML 报告:jmeter -n -t /path/to/testplan.jmx -l /path/to/results.jtl -e -o /path/to/report
- 常用选项:
- -n 非 GUI 模式
- -t 指定测试计划文件(.jmx)
- -l 保存结果日志(.jtl)
- -e 测试结束后生成报告
- -o 指定报告输出目录(需为空目录)
四 插件与扩展
- 安装插件管理器(JMeter Plugins Manager):
- 下载 plugins-manager.jar,放入 JMETER_HOME/lib/ext,重启 JMeter 后在 “Options → Plugins Manager” 中在线安装所需插件。
- 手动安装插件 JAR:
- 将插件 JAR 放入 lib/ext,重启 JMeter 生效。
- 示例(WebSocket 相关报错时的依赖):
- 若出现如 NoClassDefFoundError(org.eclipse.jetty.util.ssl.SslContextFactory 等),将对应版本的依赖 JAR(如 jetty-http、jetty-util、jetty-io、websocket-*.jar)放入 lib/ext。
五 常见问题与优化
- Java 版本不匹配:
- 确认 java -version 输出为 Java 8/11/17;若不符,安装合适版本并重新验证 jmeter -v。
- 权限问题:
- 确保 JMeter 脚本与输出目录对当前用户可写;必要时使用 chmod/chown 调整。
- 分布式测试准备:
- 在控制机配置 jmeter.properties,并在从节点准备并启动 jmeter-server,用于远程执行与扩展负载。