mitmproxy 请求拦截实战:如何在控制台修改被拦截请求后再放行(Modify Requests 详解)
mitmproxy 请求拦截实战:如何在控制台修改被拦截请求后再放行(Modify Requests 详解)
导读:本文基于 mitmproxy 官方向导中的 Modify Requests(修改请求)一课,完整还原在 mitmproxy 交互式控制台中将一个被拦截的 HTTP 请求“原地改写”后放行的全过程——从配置 ~u /Dunedin & ~q 拦截规则、用 curl 触发请求,到进入 Flow Details 视图、按 e 编辑 path、最后按 a 恢复请求并验证服务器返回改写后的结果。读完本文,你将掌握 mitmproxy 拦截(Intercept)功能的完整闭环:选择性拦截 → 局部编辑 → 恢复放行,并理解其底层命令与实现原理。
从“拦截不修改”到“拦截并修改”
本教程承接上一篇 Intercept Requests(拦截请求)。mitmproxy 最强大的一点在于:拦截(intercept)本身不是目的,真正的威力在于把请求暂停后、在转发到目标服务器之前对它进行修改。
拦截的完整含义是:一个被拦截(intercepted)的请求会暂停在代理端,用户可以随意修改它,甚至丢弃它(kill),之后才被继续发送到服务器。此前我们只是把拦截下来的请求原封不动地 resume(恢复),没有做任何改动;本课则演示“改完再放行”。
整个过程不需要退出控制台,也不需要写脚本——全部通过 mitmproxy 交互界面按键完成。你可以继续使用上一课已经打开的那个窗口以及已经配置好的拦截规则,在它的基础上直接操作。
本篇对应的终端实录位于 mitmproxy_modify_requests.cast,配套的分步讲解文案见 mitmproxy_modify_requests_instructions.json,建议配合文章边看边练。
第一步:沿用上一课的拦截规则 ~u /Dunedin & ~q
在开始修改请求之前,必须先让目标请求被拦截住。本课继续使用上一课配置的规则:按 i 键会调出命令输入框(命令会被预填充为 set intercept),输入流过滤器表达式:
set intercept ~u /Dunedin & ~q
输入后按 Enter 确认。此时控制台底部会出现拦截状态提示(如 [i:~u /Dunedin & ~q]),表示拦截已按该规则启用。
这条过滤器到底在匹配什么
流过滤器(flow filter)是 mitmproxy 选择请求的“语言”,~u /Dunedin & ~q 由两个表达式用 &(逻辑与)组合而成:
~u <regex>:按 URL 做正则匹配。在 flowfilter.py 中,FUrl对 HTTP 流使用self.re.search(f.request.pretty_url),即对完整 URL 做子串正则搜索;在教程里我们输入的是裸正则/Dunedin,凡是 URL 中包含/Dunedin的请求都会被命中。该文件注释也说明:不带前缀的裸正则等价于~u rex,即默认就是匹配 URL。~q:在 flowfilter.py 中,FReq的定义是“Match request with no response”,其实现为return not f.response,也就是只匹配尚未收到响应的请求。已收到响应的完成流(尤其浏览器后续自动加载的静态资源)不会命中,从而避免界面被海量已完成请求不断打断。
两个条件叠加,就实现了“只拦下发给 wttr.in、路径含 /Dunedin、且仍在等待响应的那一条请求”的精确控制。
拦截规则本身由 addons/intercept.py 这个内置 addon 实现:它声明了 intercept(拦截过滤器表达式,类型 Optional[str],默认 None)与 intercept_active(拦截总开关,bool,默认 False)两个选项;当 intercept 更新时解析过滤器,并在解析成功且表达式非空时自动把 intercept_active 置为 True(intercept.py)。之后每来一个流都会调用 should_intercept 判断是否命中规则,命中则执行 f.intercept() 把流暂停。
为什么不能直接拦截所有请求
拦截“全部”请求通常不是好主意——它会让每次浏览都被强行打断。因此 set intercept 的第一个参数必须是一个流过滤器表达式,用它在海量流量中挑出你真正关心的那部分。控制台默认键位中,i 绑定的是 console.command.set intercept(见 defaultkeys.py),注意大写 I 则是纯开关 set intercept_active toggle(defaultkeys.py),用于不修改表达式、直接启停拦截,二者要区分开。
第二步:在另一个终端用 curl 触发一个请求
拦截规则就绪后,在另一个独立的终端窗口里执行下面的命令,模拟客户端发出一个真实的 HTTP 请求:
curl --proxy http://127.0.0.1:8080 "http://wttr.in/Dunedin?0"
--proxy http://127.0.0.1:8080指定 curl 走本地 mitmproxy 代理端口 8080(mitmproxy 默认监听*:8080);- URL 选择了
wttr.in天气服务,路径里的城市名Dunedin正好命中上面的~u /Dunedin规则; - 末尾的
?0是一个随意构造的查询参数,仅用于演示。
由于该请求命中拦截规则,curl 会一直挂起、无法拿到响应。回到 mitmproxy 窗口,你会看到流量列表(Flows)里新增了一行,处于被拦截(intercepted)状态,例如:
>> 16:40:41 HTTP GET wttr.in /Dunedin?0
行首的 >> 表示该流是当前焦点行(本例中新拦截的流会自动获得焦点),而右侧的拦截标识说明它正被暂停等待你的处置。
第三步:进入 Flow Details 视图并按 e 打开编辑
现在对这个被拦截的流做修改:
- 确认焦点(
>>)落在这条wttr.in /Dunedin流上; - 按
Enter(绑定console.nav.select,见 defaultkeys.py)进入这条流的 Flow Details(详情)视图。顶部会显示请求行,例如2020-09-04 16:40:41 GET http://wttr.in/Dunedin?0,并带有明显的Request intercepted标签,下方是 Host、User-Agent、Accept 等请求头以及 Query 段; - 按
e调用编辑功能。在 defaultkeys.py 中,e在flowlist/flowview上下文绑定的是:
console.choose.cmd "Edit..." console.edit.focus.options
console.edit.focus {choice}
即先弹出部件选择菜单,再把用户的选择传给 console.edit.focus 这个命令执行真正的编辑。
第四步:从部件选择菜单中挑选要修改的部分
按 e 后,mitmproxy 会弹出 “Edit… / Part” 选择框,询问你要修改请求/流量的哪个组成部分。从录制中可以看到,对 HTTP 流它给出的可选项包括:
| 选项 | 含义 |
|---|---|
cookies |
请求 Cookie |
urlencoded form |
URL 编码的表单字段 |
multipart form |
multipart 表单字段 |
path |
URL 路径(会按 / 分段逐个编辑) |
method |
请求方法(GET/POST/…) |
query |
URL 查询参数(Query) |
reason |
响应原因短语 |
request-headers / response-headers |
请求 / 响应头 |
request-body / response-body |
请求 / 响应体 |
status_code |
响应状态码 |
set-cookies |
响应中的 Set-Cookie |
url |
整个 URL(调起外部编辑器) |
comment |
流的备注信息 |
这份菜单正是由 console.edit.focus.options 命令动态生成的。查看其实现 consoleaddons.py:对 http.HTTPFlow 会依次追加 cookies、urlencoded form、multipart form、path、method、query、reason、request-headers、response-headers、request-body、response-body、status_code、set-cookies、url,最后统一追加 comment;对 TCP/UDP/WebSocket 流则提供消息体编辑入口,DNS 流目前会直接报错(提示等待补丁)。
在本例中我们想改动 URL 路径里的城市名,所以用方向键把高亮移到 path,按 Enter 确认。
第五步:path 分段编辑——把 Dunedin 改成 Innsbruck
选中 path 后,mitmproxy 会切换到 “Edit Path Components” 网格编辑器,把路径按 / 切分成一行一个的 Component(路径组件) 逐一列出。对 http://wttr.in/Dunedin?0 来说,路径只有一段,所以列表里只有一行:
Component
Dunedin
接下来:
- 按
Enter进入对Dunedin这一单元格的修改; - 直接输入新文本把它替换为
Innsbruck; - 按
Esc确认本次修改,返回路径组件列表,此时单元格内容已变为Innsbruck。
从源码看,选中 path 后 console.edit.focus 会先调用 flow.backup() 保存当前流的快照(用于之后一键回滚,见 consoleaddons.py),随后通过 self.master.switch_view("edit_focus_path") 切换到对应的网格编辑器视图(consoleaddons.py)。这也解释了为什么在路径组件编辑界面里可以任意增删、改写组件后再确认。
修改 path 只是众多编辑方式之一:当选择 method、status_code、reason 等标量字段时,console.edit.focus 会走 flow.set 命令以交互方式设置新值(consoleaddons.py);而选择 url 或各类 body 时则会在本机调起 $EDITOR 外部编辑器,保存后写回 flow.request.url 或 message.content(consoleaddons.py)。
第六步:回到详情视图,按 a 恢复请求
路径改完后:
- 按
q从路径组件编辑视图返回 Flow Details 视图——此时详情页顶部显示的请求行已经变成了GET http://wttr.in/Innsbruck?0,说明修改实时生效; - 流仍处于
Request intercepted状态,尚未发送到服务器。此时按a执行 resume(恢复放行)。
a 在 flowlist / flowview 两个上下文中都绑定为 flow.resume @focus,语义是“恢复当前焦点这条被拦截的流”(defaultkeys.py)。与之相对,大写 A 绑定 flow.resume @all,用于一次放行所有被拦截的流(defaultkeys.py)。小写 a 更适合本教程这种只拦一条、精准放行一条的演示场景。
如何验证修改确实生效了
按下 a 的瞬间,被暂停的请求会携带着改后的 URL 发往 wttr.in,随后:
- 详情视图里该流的响应侧出现
200 OK text/plain 330b; - 底部 curl 终端同步打印出天气文本,开头正是:
Weather report: Innsbruck
服务器端返回的是 Innsbruck 的天气,而不是原始 URL 里 Dunedin 的天气——这证明请求在到达服务器之前被成功改写。更关键的是,客户端(curl)整个交互过程只发出过一条请求,它甚至不知道自己发出的 URL 已被代理“调包”,这正是渗透测试与调试场景中最核心的能力:让客户端与服务器看到完全不同的请求内容。
修改请求流程速查
把整个 Modify Requests 工作流浓缩为一次可照做的按键序列:
| 步骤 | 按键 / 命令 | 作用 |
|---|---|---|
| 1 | i,输入 ~u /Dunedin & ~q,Enter |
设置并启用拦截规则 |
| 2 | 另一终端执行 curl --proxy http://127.0.0.1:8080 "http://wttr.in/Dunedin?0" |
产生一条命中规则的请求,被暂停 |
| 3 | Enter |
从流量列表进入 Flow Details |
| 4 | e |
弹出 “Edit…” 部件选择菜单 |
| 5 | 方向键选中 path,Enter |
进入路径组件编辑 |
| 6 | Enter 编辑 Dunedin,输入 Innsbruck |
改写路径段 |
| 7 | Esc |
确认单元格修改 |
| 8 | q |
返回 Flow Details |
| 9 | a |
恢复(放行)被拦截流,等待服务器响应 |
需要留意区分几个容易混淆的键:e 编辑、a 恢复当前流、A 恢复全部流、大写 I 仅切换拦截开关而不改规则、小写 i 进入 set intercept 命令设置规则。
背后机制:拦截的完整数据流
从源码角度把整条链路串起来,你会看到一次“拦截 → 修改 → 放行”实际经历的阶段:
- 命中拦截:每个新流经过 intercept.py 时,
should_intercept会同时检查intercept_active开关与解析后的过滤器是否匹配;命中即f.intercept()暂停流。整个过程基于前一课已经配置好的set intercept,修改操作本身并不依赖拦截规则变化——规则在上一课就已生效。 - 可回滚修改:进入
console.edit.focus前先flow.backup()做快照。一旦改坏,可在任意时刻用大写V(绑定flow.revert @focus,见 defaultkeys.py)把流一键还原到修改前状态,这让“随手试验”非常安全。 - 恢复发送:
flow.resume @focus通知流事件循环继续,把已被改动内存中请求对象的请求转发给目标服务器,服务器返回后代理再把响应原样回传给客户端。
值得一提的是,这个教程属于 mitmproxy 官方 CLI 视频教程系列的第 3 课,系列目录位于 docs/src/content/cli-tutorials(入口页 _index.md),前序课程是 User Interface 与 Intercept Requests。如果你从未打开过 mitmproxy 控制台,建议先回到前面两课熟悉界面与拦截规则的基本操作,本课默认你在同一窗口继续练习。
后续:从手动改请求到自动化改写
本课演示的“手动拦截 + 按键修改”适合精细调试验证,但每次请求都要人工操作,效率有限。与它形成互补的自动化路径主要有两条:
- 使用
--set intercept=...之外的--modify-headers/--modify-body等命令行选项做规则化改写,或编写 addons 脚本(仓库的 examples/addons 目录下如 http-modify-query-string.py、http-modify-form.py 都是“不改控制台、纯代码改请求”的直接范例); - 把手动流编辑练熟之后,下一个教程 Replay Requests(回放请求) 将教你把已经产生过的请求原样重放,实现“抓一次、反复用”的测试方式,见 cli-04-replay-requests.md。
拦截配合修改、再配合回放,构成了 mitmproxy 在接口调试与安全测试中最常用的三连操作:Intercept → Modify → Replay。掌握了本课的修改环节,你就可以在完全不碰业务代码的前提下,任意改写客户端发往服务器的 URL、头部、表单与请求体,并第一时间观察服务器对新内容的真实响应。