pablopablopablo/locust-m11

M11 loadtest Docker镜像文档

镜像概述

M11 loadtest是一款轻量级负载测试工具的Docker化实现，旨在提供便捷的性能压力测试解决方案。通过容器化部署，用户可快速启动测试环境，无需复杂的本地配置，即可对各类网络服务、Web应用及API接口进行高并发负载测试，评估系统在不同压力条件下的性能表现。

核心功能与特性

• 多协议支持：兼容HTTP/HTTPS、TCP、WebSocket等多种网络协议，满足Web服务、接口及底层网络服务的测试需求。
• 灵活负载配置：支持自定义并发用户数、请求频率、测试持续时间及请求间隔，可模拟真实业务场景下的动态负载变化。
• 实时性能监控：测试过程中实时展示关键指标，包括平均响应时间、吞吐量（RPS）、错误率、95%/99%分位响应时间等。
• 报告生成功能：测试结束后自动生成可视化性能报告，支持HTML格式输出，包含详细数据统计与趋势图表，便于结果分析。
• 轻量级部署：镜像体积小巧（<100MB），启动速度快，支持在Docker、Kubernetes等容器环境中无缝运行。

使用场景

• Web应用性能验证：针对电商平台、门户网站等Web应用，测试高并发用户访问下的页面加载速度与系统稳定性。
• API接口压力测试：对RESTful API、GraphQL接口等进行压力测试，验证接口在大量请求下的处理能力及错误容忍度。
• 系统容量评估：通过逐步增加并发用户数，确定系统的最大承载阈值，为服务器扩容、资源分配提供数据依据。
• 版本迭代验证：在系统升级或代码优化后，通过对比测试结果，验证性能优化效果或排查性能退化问题。

使用方法

基础使用命令

通过docker run命令可直接启动测试，基础语法如下：

bash
docker run --rm -it m11/loadtest [测试参数]

示例1：HTTP接口基础测试

对目标API发起100并发用户、持续60秒的GET请求测试：

bash
docker run --rm -it m11/loadtest \
  --target "https://api.example.com/v1/health" \
  --concurrency 100 \
  --duration 60 \
  --method GET

示例2：带请求体的POST测试

对用户注册接口发起50并发用户的POST请求，包含JSON格式请求体：

bash
docker run --rm -it m11/loadtest \
  --target "https://api.example.com/v1/register" \
  --concurrency 50 \
  --duration 120 \
  --method POST \
  --payload '{"username":"test_user","email":"test@example.com","password":"P@ssw0rd"}'

核心参数说明

环境变量配置

通过环境变量预设常用配置，减少重复参数输入，优先级低于命令行参数：

• M11_TARGET：默认测试目标地址
• M11_CONCURRENCY：默认并发用户数
• M11_REPORT_PATH：默认报告输出路径

示例：通过环境变量配置默认目标

bash
docker run --rm -it \
  -e M11_TARGET="https://api.example.com/v1/health" \
  -e M11_CONCURRENCY=200 \
  m11/loadtest --duration 180

测试报告保存

如需持久化保存测试报告，需通过-v参数挂载宿主机目录至容器内报告路径：

bash
docker run --rm -it \
  -v $(pwd)/reports:/app/reports \
  m11/loadtest \
  --target "https://api.example.com/v1/health" \
  --concurrency 150 \
  --duration 120 \
  --output /app/reports/20240520_test.html

执行完成后，宿主机./reports目录下将生成20240520_test.html报告文件，包含响应时间分布、吞吐量趋势等可视化图表。

注意事项

• 网络权限：确保容器网络可访问目标服务（需开放宿主机防火墙端口或配置容器网络模式为host）。
• 资源限制：高并发测试（>500用户）时，建议通过--memory和--cpus限制容器资源，避免影响宿主机性能：

  bash
  docker run --rm -it \
    --memory 2G --cpus 1.5 \
    m11/loadtest --target "https://api.example.com" --concurrency 1000
  

• HTTPS证书：测试自签名HTTPS服务时，需添加--insecure参数跳过证书验证：

  bash
  docker run --rm -it m11/loadtest --target "[***]" --insecure