timothyclarke/wptagent

wptagent

跨平台WebPageTest代理镜像，用于执行网页性能测试任务。

镜像概述

wptagent是一款跨平台的WebPageTest代理工具，支持Linux、Windows、OSX及Android等平台，兼容多种浏览器，可完成网页加载测试、脚本执行、视频捕获、流量整形等操作，帮助用户全面分析网页性能表现。

核心功能

支持的平台与浏览器

• Linux（带显示或Xvfb无头模式）：Chrome（稳定版/测试版/不稳定版）、Firefox（稳定版/nightly版）、Opera（稳定版/测试版/开发者版）
• Windows：Chrome（稳定版/测试版/Dev版/Canary版）、Firefox（稳定版/ESR/开发者版/测试版/nightly版）、Microsoft Edge、Internet Explorer、Opera（稳定版/测试版/开发者版）
• OSX：Chrome（稳定版/Canary版）、Firefox（稳定版/nightly版）
• Android（需 tethered主机，推荐树莓派）：Chrome（稳定版/测试版/Dev版/Canary版）；部分浏览器支持黑盒测试（单页加载/视觉指标）：Opera、Opera Mini、UC Browser、UC Mini、Samsung Browser、Firefox（稳定版/测试版）

主要功能

• 基础网页加载测试、脚本执行、视频捕获
• 流量整形（支持多种方式）
• CPU节流（Linux平台）
• Android设备测试（需反向 tethering）
• 支持导航、阻塞请求、设置头信息等多种脚本命令

使用场景

1. 网页性能基准测试：评估不同浏览器下的加载速度
2. 多平台兼容性测试：验证网页在不同系统/浏览器中的表现
3. 网络受限场景测试：模拟不同带宽条件下的性能
4. 移动端网页测试：分析Android设备上的网页体验

配置说明

基础代理配置

• -v：提高日志详细度（多次指定可升级，-vvvv为全debug）
• --name：代理名称（默认机器hostname）
• --exit：指定分钟后退出（用于定期维护）
• --dockerized：标记容器内运行
• --log：写入关键错误日志到指定文件

服务器/位置配置

• --server（必填）：WebPageTest工作URL（如[***]
• --location（必填）：位置ID（与服务器locations.ini一致）
• --key：位置密钥（若服务器配置需要）

Docker部署示例

基础运行命令

bash
docker run docker.xuanyuan.run/timothyclarke/wptagent \
  --server http://your-wpt-server/work/ \
  --location your-location-id \
  --name my-agent \
  --dockerized

带流量整形的运行命令（Linux）

bash
docker run --privileged docker.xuanyuan.run/timothyclarke/wptagent \
  --server http://your-wpt-server/work/ \
  --location your-location-id \
  --shaper netem,eth0 \
  --dockerized

（注：流量整形需容器以特权模式运行）