ReqRes：macOS 网络调试代理

项目简介

ReqRes 是一款面向 macOS 的 HTTP 与 HTTPS 调试代理。抓包只由一个按钮控制：抓包运行时，网络扩展会把 Mac 的系统代理指向 ReqRes；停止抓包后，macOS 会自动收回该系统代理设置。它用在你自己的 Mac 上生成的证书解密 HTTPS，显示每个请求是哪个 App 发出的，并支持通过规则和断点修改流量。内置的 MCP 服务器让 Claude Code、Cursor 或其他 MCP 客户端读取这些流量并提议改动，默认情况下，代理的改动需要你确认后才会生效。

主要功能

• 一键抓包：工具栏按钮、⌘⇧C、菜单栏项或 start_capture 工具都可以启动抓包。读取 macOS 系统代理的 App 会自动被捕获，无需逐个设置。
• HTTPS 解密：首次运行时生成自有的证书颁发机构（每台 Mac 各不相同），在 设置 ▸ 证书 中安装并信任后即可解密；在此之前，HTTPS 以每条连接一行的形式原样转发。明文 HTTP 无需证书，任意端口均可。
• 一条请求一行：显示 Code、Method、URL、目的国家、时间和耗时；App 列显示进程名，悬停可看 pid 与路径。慢请求和流在运行中就列出，失败、中止、超时的请求会说明原因。列表在内存中保留最近 5000 条请求。
• Inspector：请求分为 Summary、Body、Headers、Metrics、cURL 标签页；响应分为 Summary、Body、Headers、Metrics，并按需提供 Events、Messages、RPC。内容体支持 gzip、deflate、brotli、zstd 解码，JSON 渲染、正文内搜索和图片预览。
• 带 token 的搜索：支持自由文本以及 host:、method:、status:、path:、app:、pid:、country:、outcome:、grpc:、proto:。
• 规则：Override、Extend 与 Map Local。带 body 的 Override 或 Map Local 文件由 ReqRes 直接应答，不再到达服务器；Extend 则转发请求并增改 header、状态或 body。
• 断点：在请求到达服务器前将其拦住，可查看、编辑 header 或 body、放行或中止；60 秒后自动原样放行。仅支持请求断点。
• 协议支持：WebSocket 双向消息、SSE 与 NDJSON 流、gRPC-Web 与 Connect（无需 schema）可直接抓取；HTTP/2 与原生 gRPC 为 beta。
• 其他：保存会话、HAR 1.2 导出、重放与 diff（以 MCP 工具形式提供）、Destinations 世界地图统计、排除主机与 SSL Pinning App 处理、内置帮助与 Diagnose Setup 检查。

安装与使用

要求 macOS 14.6 或更高，通用二进制支持 Apple silicon 与 Intel（Intel 机器未定期测试）。ReqRes 必须放在 /Applications 运行。

1. 从 最新 release 下载 DMG，把 ReqRes 移到 /Applications。
2. 打开后点击 Continue with Free Version，macOS 会提示需要批准系统扩展。
3. 在 系统设置 ▸ 通用 ▸ 登录项与扩展 ▸ 网络扩展 中点 ⓘ 按钮，把 ReqRes 打开（macOS 14 在 隐私与安全性 ▸ 扩展）。
4. 允许 macOS 询问添加的 VPN 配置（仅用于设置系统代理，不涉及 VPN 服务器）。
5. 在 设置 ▸ 证书 中于 Keychain 行安装证书，再于 Trust 行信任证书。
6. 开始抓包：HTTP 请求立即出现，HTTPS 在证书被信任后以解密请求显示。

无需账号，免费版无需许可证；未上架 App Store，通过 Sparkle 自动更新。

注意事项

• 第 3 步的开关在 ⓘ 按钮后面，容易漏掉。
• 若提示 Restart your Mac to finish，需要重启一次 Mac，只重启 ReqRes 不会加载新扩展；没有数据时可运行 Capture ▸ Diagnose Setup…。
• 忽略系统代理的工具（curl、git、Claude Code CLI、node、Go、Rust、Docker 容器内的进程）不会被捕获，需在 设置 ▸ 捕获 中导出 reqres-ca.pem 并用环境变量把工具指向 ReqRes。
• HTTP/3（QUIC）走 UDP，不经过代理，无法捕获；可在浏览器关闭 QUIC。
• 需要客户端证书（mTLS）的服务器无法捕获，请求会以 502 失败并说明原因。
• 删除 App 不会移除证书及其信任，可在 设置 ▸ 证书 的 ? 按钮按指纹移除。

本作品整理自 GitHub 开源项目 teologov/ReqRes，原作者 @teologov。中文介绍由 AI 根据项目 README 整理，以原仓库为准。