使用 proxymock CLI 录制、检查、模拟、回放和生成 API 流量。用于捕获 HTTP/gRPC/数据库流量并创建模拟。
代理mock是一项面向实际任务的技能,主要用于代理mock通过透明代理获取真实的API和数据库流量,然后使用它创建模拟和测试——不需要代码更改.;Core Workflow.;
该技能适合需要稳定复用相关能力的场景,可作为自动化工作流的一部分,也便于后续检查、调整和扩展。从功能定位来看,该技能强调把分散的操作要求整理成清晰、可复用的处理流程,使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数,再依据技能说明逐步执行;
若输入条件不完整,应先补齐信息或采用保守配置,避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期,并对异常提示、缺失字段和边界情况进行处理;涉及批量任务时,还应保存进度,避免中断后重复操作。
proxymock 通过透明代理捕获真实的 API 和数据库流量,并基于这些流量自动生成 Mock 和测试用例——无需修改任何代码。
录制 → 检查 → Mock / 回放
proxymock record -- 捕获流量proxymock inspect 查看捕获的 RRPairsproxymock mock -- 对依赖服务进行 Mockproxymock replay --test-against 重放已录制的测试用例# 在子进程模式下运行应用并录制(推荐) proxymock record -- go run . proxymock record -- npm start # 自定义输出目录 proxymock record --out my-recording -- python app.py # 通过反向代理录制数据库流量 proxymock record --map 65432=postgres://localhost:5432 -- ./my-app # 使用自定义应用端口录制 proxymock record --app-port 3000 -- ./my-app
架构说明:入站代理监听于 :4143 → 应用监听于 --app-port(默认为 8080),出站代理监听于 :4140,用于捕获外发流量。
# 启动 Mock 服务器并以子进程方式运行应用 proxymock mock -- go run . # 从指定目录加载 Mock 数据 proxymock mock --in ./my-recordings -- npm start # 快速模式(不模拟延迟) proxymock mock --fast -- ./my-app # 不将观测到的流量写入磁盘 proxymock mock --no-out -- ./my-app # 通过反向代理对数据库进行 Mock proxymock mock --map 65432=localhost:5432 -- ./my-app
在 Mock 模式下,应用通过 :4140 上的代理连接外部服务。匹配成功的请求返回已录制的响应;未匹配的请求则透传至真实后端。
# 针对目标应用回放已录制的测试用例 proxymock replay --test-against http://localhost:8080 # 负载测试:10 个虚拟用户持续 5 分钟 proxymock replay --test-against http://localhost:8080 --vus 10 --for 5m # 运行测试 3 次 proxymock replay --test-against http://localhost:8080 --times 3 # 满足条件时失败(适用于 CI 环境) proxymock replay --test-against http://localhost:8080 --fail-if "requests.failed!=0" --fail-if "latency.p99>100" # 多服务路由 proxymock replay --test-against auth=auth.example.com --test-against frontend=http://localhost:8080 --test-against http://localhost:9000
验证指标包括:latency.{avg,p50,p90,p95,p99,max,min}、requests.{total,succeeded,failed,per-second,per-minute,response-pct,result-match-pct}。
proxymock inspect # 当前目录 proxymock inspect --in ./my-recording proxymock inspect --demo # 使用示例数据
注意:inspect 将启动一个终端 UI —— 若在 exec 中运行,请确保设置 pty=true。
proxymock generate api-spec.yaml proxymock generate --out ./mocks --host api.staging.com api-spec.yaml proxymock generate --tag-filter "users,orders" api-spec.yaml proxymock generate --include-optional --examples-only api-spec.yaml
# 比较两个 RRPair 文件目录的差异 proxymock files compare --in recorded/ --in replayed/ # 在不同格式间转换 proxymock files convert --in proxymock --out-format json # 编辑 RRPairs 后更新 Mock 签名 proxymock files update-mocks --in ./my-mocks
proxymock cloud push snapshot # 推送快照至 Speedscale Cloud proxymock cloud pull snapshot # 从 Cloud 拉取快照
# 从快照文件导入流量 proxymock import snapshot.json proxymock import --in ./snapshots snapshot.tar.gz
# 启动模型上下文协议(MCP)服务器,用于 AI 工具集成 proxymock mcp
proxymock send-one path/to/test.md http://localhost:8080 # 发送单个请求 proxymock init --api-key# 初始化配置 proxymock certs # 管理 TLS 证书 proxymock version # 查看版本信息 proxymock completion bash # 生成 Shell 补全(支持 bash/zsh/fish/powershell)
流量以 RRPair(请求/响应对)Markdown 文件形式存储于 proxymock/ 目录下。每个文件包含以下部分:
### REQUEST (TEST) ### 或 ### REQUEST (MOCK) ### —— 捕获的请求### RESPONSE ### —— 捕获的响应### SIGNATURE ### —— Mock 匹配规则(仅用于 Mock 场景)这些文件对人类和大语言模型(LLM)均友好可读。可直接编辑它们来修改测试数据或 Mock 响应;若更改了影响签名的请求字段,请运行 proxymock files update-mocks 更新签名。
当不使用 -- 子进程模式时,需手动设置代理环境变量:
# HTTP/HTTPS/gRPC export http_proxy=http://localhost:4140 export https_proxy=http://localhost:4140 export grpc_proxy=http://$(hostname):4140 # 数据库(SOCKS) export all_proxy=socks5h://localhost:4140
详见各语言的参考文档以获取语言特定的配置说明。
关于签名匹配机制、架构细节及高级用法,请参阅 references/cli-reference.md。
相关专题
热门下载
相关下载
精品课程
共6课时 | 54.7万人学习
共89课时 | 134.3万人学习
共49课时 | 82.7万人学习