Keploy 快速上手3 步把真实流量变成可重放的 API 测试【免费下载链接】keployOpen-source platform for creating safe, isolated production sandboxes for API, integration, and E2E testing.项目地址: https://gitcode.com/GitHub_Trending/ke/keploy夜里发布上线前你不敢跑集成测试——怕它打到线上数据库白天写代码时你又懒得为每个接口手搓 mock 数据。如果有一样东西能在你正常跑一遍应用后自动把 API 调用、数据库查询、消息事件都存下来之后随时离线重放测试就不会再被外部依赖卡住。这就是 Keploy 做的事一款基于 eBPF 的 API 与集成测试工具自动从真实流量中生成测试用例和数据 mock全程无需改一行代码。 先说结论维度说明适合谁想给现有应用快速补测试、又被外部依赖数据库/消息队列/第三方 API拖慢测试节奏的开发者预计耗时约 3 分钟完成安装并跑通第一条记录—重放流程你将得到可直接重放的 API 测试用例 数据库与消息的确定性 mock测试从此离线可跑✅ 开始之前确认你的环境操作系统Linuxx86_64 或 aarch64或 macOSWindows 用户请先装好 WSL2权限系统级安装需要 sudo想装在用户目录则完全不需要依赖bash、curl以及一个你平时就能跑起来的应用Python、Node、Go 均可 三步实操从克隆到第一条测试第 1 步克隆仓库并执行一键安装脚本git clone https://gitcode.com/GitHub_Trending/ke/keploy cd keploy chmod x keploy.sh ./keploy.sh # 自动识别系统架构下载、解压、配置 PATH脚本会自己完成选包、安装和别名配置结束时还会顺手跑一遍示例验证。如果环境特殊加参数即可./keploy.sh -noRoot # 不占用 root安装到 ~/.keploy/bin ./keploy.sh -v v2.0.0 # 锁定指定版本 ./keploy.sh -isCI # CI 环境专用模式第 2 步记录一次真实流量用keploy record包裹你平时启动应用的命令。你照常点接口、跑流程Keploy 在背后把每个 API 请求、SQL 查询、Kafka 消息都捕获成测试资产keploy record -c python3 main.py # -c 后跟你的应用启动命令跑完后当前目录会多出记录下来的测试用例和 mock 数据。第 3 步离线重放测试现在换到keploy test同样的命令再跑一遍。这一次所有外部依赖都由本地 mock 应答不碰任何真实环境keploy test -c python3 main.py --delay 10 # 用 mock 重放--delay 给应用留启动时间输出与录制时一致说明你的改动没有破坏既有行为。 幕后一瞥它凭什么不改代码Keploy 的抓包不靠在你的代码里埋点而是下沉到操作系统的网络层——借助 eBPF 在流量经过时抄一份底。打个比方这相当于在小区门口装了一台快递分拣记录仪它不拆开、也不改动任何包裹只是把每天进出的每一件快递HTTP 请求、数据库读写、队列消息登记归档。第二天你要复查时直接从档案柜里按原样调取就行。正因为拦在网络层Go、Java、Python、Node 乃至任何语言的运行时都天然兼容这也是它零 SDK、零侵入的底气。✔️ 快速自检装好了没你看到的现象说明终端输入keploy能打印帮助信息二进制已安装且 PATH 生效keploy record结束后目录里出现测试用例与 mock 文件录制链路正常工作keploy test期间应用没有访问真实数据库/外部 API响应与录制一致重放与 mock 命中正常keploy example完整跑通示例流程环境就绪可投入真实项目️ 踩坑速查问题可能原因处理keploy: command not found安装后 PATH 未在当前终端生效新开一个终端或重新 source 你的 shell 配置文件安装时报权限错误当前用户无写入系统目录的权限改用./keploy.sh -noRoot装到用户目录提示 Unsupported architecture机器架构既非 x86_64 也非 aarch64用uname -m确认架构或用 Docker 容器跑下载长时间无响应网络波动导致二进制拉取失败重跑脚本即可它会重新下载并继续Windows 下脚本直接退出Keploy 依赖 Linux 内核能力安装 WSL2在其中执行上述步骤 延伸探索README.md项目全貌与能力清单keploy.sh一键安装脚本源码想看进度条怎么画的就在这里docs/env-vars.md环境变量参考进阶调参用cli/README.mdCLI 子命令的组织方式pkg/proxy/integrations/HTTP、MySQL、gRPC 等集成的实现入口docs/explanation/mock-lifetimes.md理解 mock 的生命周期DEBUG.md遇到问题时的排障指南装好之后挑一个你最熟的小应用把keploy record和keploy test各跑一遍——十分钟之内你就拥有一套别人手搓好几天才攒得出的 API 测试资产。现在就去试吧。【免费下载链接】keployOpen-source platform for creating safe, isolated production sandboxes for API, integration, and E2E testing.项目地址: https://gitcode.com/GitHub_Trending/ke/keploy创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考