使用 proxymock CLI 录制、检查、模拟、回放和生成 API 流量。用于捕获 HTTP/gRPC/数据库流量并创建模拟。
代理mock
功能概述
代理mock是一项面向实际任务的技能,主要用于代理mock通过透明代理获取真实的API和数据库流量,然后使用它创建模拟和测试——不需要代码更改.;Core Workflow.;
核心要点
- Recogard 流量与代理moc。
- 它将相关步骤、工具调用和结果整理方式集中到统一流程中,帮助使用者更快完成目标并减少重复操作。
- 使用时应结合输入条件选择合适的执行方式,核对必要参数、依赖环境与输出内容,并按原始要求处理异常情况。
使用与执行
该技能适合需要稳定复用相关能力的场景,可作为自动化工作流的一部分,也便于后续检查、调整和扩展。从功能定位来看,该技能强调把分散的操作要求整理成清晰、可复用的处理流程,使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数,再依据技能说明逐步执行;
结果检查与注意事项
若输入条件不完整,应先补齐信息或采用保守配置,避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期,并对异常提示、缺失字段和边界情况进行处理;涉及批量任务时,还应保存进度,避免中断后重复操作。
proxymock
proxymock 通过透明代理捕获真实的 API 和数据库流量,并基于这些流量自动生成 Mock 和测试用例——无需修改任何代码。
核心工作流
录制 → 检查 → Mock / 回放
- 录制:使用
proxymock record --捕获流量 - 检查:使用
proxymock inspect查看捕获的 RRPairs - Mock:使用
proxymock mock --对依赖服务进行 Mock - 回放:使用
proxymock 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 服务器
# 启动 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}。
检查(TUI)
proxymock inspect # 当前目录 proxymock inspect --in ./my-recording proxymock inspect --demo # 使用示例数据
注意:inspect 将启动一个终端 UI —— 若在 exec 中运行,请确保设置 pty=true。
基于 OpenAPI 生成 Mock
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
Cloud(企业版)
proxymock cloud push snapshot # 推送快照至 Speedscale Cloud proxymock cloud pull snapshot # 从 Cloud 拉取快照
导入流量
# 从快照文件导入流量 proxymock import snapshot.json proxymock import --in ./snapshots snapshot.tar.gz
MCP 服务器
# 启动模型上下文协议(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 文件
流量以 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。
热门AI工具
相关专题
本专题整理Navicat创建数据库相关教程,介绍新建前的准备、基础设置和创建后的检查方法。内容兼顾入门学习及实际使用需求,帮助用户了解不同数据库类型下的操作差异,为后续建表、保存数据和日常管理提供参考。
0
2026.11.20
本专题整理Navicat入门教程,从认识软件界面到开展数据库操作,介绍初次使用需要了解的知识和方法。内容兼顾连接配置、数据管理及日常使用中的疑问,方便用户按学习进度查阅,为后续实践和独立操作打好基础。
0
2026.11.20
从确认数据库信息到建立可用连接,本专题串联Navicat连接数据库的相关知识和操作方法。既有初次配置时需要了解的基础内容,也有连接后的检查思路,方便用户按实际需求查阅教程,逐步熟悉数据库连接的设置流程。
0
2026.11.20
本专题汇总PHP8.6数组与数据处理教程,涵盖CSV读取和导出、引用遍历删除、array_filter回调模式、配置键名冲突、pathinfo文件名校验、GMP大整数进制转换及UTF-8正则筛选,说明升级兼容变化、输入范围和失败处理方法。
0
2026.11.20
本专题汇总PHP8.6升级迁移与弃用接口改造教程,涵盖反射调用、对象属性赋值、标识符更名、构造函数与__debugInfo调整,以及插件类名检查、常量导出、ArrayIterator排序、SPL和DTO查询参数转换,帮助梳理弃用提示并完成代码兼容改造。
0
2026.11.20
本专题汇总PHP8.6正式版安装部署与FPM运维教程,涵盖Linux并存安装、独立ini配置、扩展重新编译、Nginx切换与回滚、FPM状态监控和慢日志排查,以及环境变量、请求超时、OPcache刷新和预加载配置。
0
2026.11.20
Nginx HTTP/2漏洞该怎么修复?本专题围绕CVE-2026-123007,介绍安全版本升级、模块兼容检查和配置恢复方法,以及日志排查、权限设置等后续加固操作,方便你按实际部署情况查找对应教程。
0
2026.11.20
本专题聚焦GoFrame框架的Web开发,拆解路由注册与匹配规则、请求参数获取、参数校验与中间件执行顺序,说明统一响应、JWT鉴权、文件上传与接口文档生成的落地方式,并补充优雅重启与测试实践。
0
2026.11.17
本专题围绕GoFrame框架的安装与工具链配置展开,讲清Go版本要求、gf命令行的安装方式、代理镜像与依赖准备,说明项目初始化、热编译、交叉编译打包的做法,并整理安装阶段的常见报错与验证步骤。
0
2026.11.17
热门下载
相关下载
精品课程
共6课时 | 12.1万人学习
共79课时 | 162万人学习
共6课时 | 54.8万人学习