Proxyman Breakpoint(断点)
使用 Proxyman Breakpoint 暂停 HTTP 请求和响应,并在其继续传输之前实时编辑 URL、Headers、状态码或 Body。
1. 这是什么?
Breakpoint 是一款实用工具,可帮助开发者实时编辑请求和响应的内容。
可对请求、响应或两者同时设置断点。

创建 Breakpoint 规则
信息
如果正在使用 Atlantis Framework,则无法使用 Breakpoint。请改用普通代理。
视频
2. 主要功能
Breakpoint 工具会暂停发出的请求或收到的响应,方便修改其数据。
- 修改请求 URL,包括 Scheme、Host、Path、Port 和 HTTP Method
- 修改请求/响应的 HTTP Headers
- 修改请求中的 Query 或 Form 条目。
- 修改 Authorization、Cookie 和 Set-Cookie Headers。
- 修改请求/响应的 HTTP Body
- 修改响应的 HTTP 状态码。

修改 Headers、URL、状态码和 Body
原始 HTTP 消息
从 Proxyman macOS 6.12.0 开始,可切换到 Raw 标签页修改请求/响应的 HTTP 消息,并在同一处编辑所有数据。

编辑原始 HTTP 消息
Breakpoint 操作
| 操作 | 说明 |
|---|---|
| Continue Original (⌘.) | 忽略修改,并使用原始数据继续请求/响应 |
| Drop Connection (⌘\) | 中止断点并停止连接。点击旁边的箭头 -> Abort Mode,可改为返回 429 或 503 状态码 |
| Apply & Execute (⌘⏎) | 使用修改后的数据发送请求/响应 |
信息
查看 Breakpoint 教程:使用 Breakpoint 拦截并编辑 iOS 应用中的请求和响应
3. 通过 Scripting 工具使用 Breakpoint ✅
如果希望自动修改请求,可以使用 Scripting 工具。它能达到与 Breakpoint 相同的效果,而且通过编写 JavaScript 代码的方式更灵活。
请参阅 Scripting 代码片段,了解如何使用 Scripting 实现 Breakpoint。
4. 对 GraphQL 请求使用 Breakpoint
从 Proxyman 2.27.0 起,Breakpoint 可以通过特定的 QueryName 处理 GraphQL 请求。请参阅以下 GraphQL 文档。
5. 使用方法
可按以下方式创建 Breakpoint 规则:
- 首先确保 Proxyman 能够抓取 HTTPS 请求。
- 右键点击请求 -> Tools -> Breakpoint…
- Proxyman 会打开 Breakpoint 规则窗口,并自动填入匹配规则。
- 选择对 Request、Response 或两者设置 Breakpoint。
- 点击 Add 创建规则。
- 再次发送该请求。Proxyman 会打开 Breakpoint 窗口,此时可以修改数据。
- 点击 Apply & Execute 发送请求/响应。