mitmdump addon 断点调试:用 Python 启动器内嵌调用 mitmdump([...]) 启动,-s 脚本即可在 IDE 下断点
tools/burp · verified
一句话结论
直接用 mitmdump -s enc.py 从命令行启动时,addon 脚本运行在另一个解释器进程里,IDE 调试器附着的进程不是它,断点不会命中;改为写一个 Python 启动器,先 sys.path.append 脚本目录,再在当前进程内调用 mitmproxy.tools.main.mitmdump([...]),addon 的 request/response 钩子就会加载进调试器所在进程,可以在 enc.py/dec.py 里正常下断点单步调试。
原理
mitmdump命令行本身只是mitmproxy.tools.main的入口封装:解析参数后由ScriptLoader在进程内 exec 加载-s指定的 addon 脚本,再启动代理事件循环。- 从终端敲
mitmdump时,操作系统创建的是一个新的 Python 解释器进程;IDE 的调试器只 attach 到自己启动的那个进程,所以即使-s指向当前打开的项目文件,断点也落不到运行中的 mitmdump 进程里。 - 在启动器脚本中直接
from mitmproxy.tools.main import mitmdump并调用mitmdump([...]),等于把 CLI 的解析与代理启动逻辑放在当前解释器进程内执行;addon 脚本随后被同一进程加载,IDE 断点自然生效。 sys.path.append(os.path.dirname(os.path.abspath(__file__)))把启动器所在目录加入模块搜索路径,保证-s enc.py的相对路径和 addon 内部的import都能解析。- 上游、下游两个代理各写一个启动器即可分别调试;启动器里的参数列表与命令行完全等价(
-p、-s、--mode upstream:...、--ssl-insecure)。
触发条件
- 正在开发或排查 mitmproxy/mitmdump addon(
request/response钩子里做解密、加密、签名重算等),需要单步调试而不是只靠ctx.log.info打日志。 - 使用 PyCharm、VS Code(debugpy)等能调试“自己启动的 Python 进程”的 IDE。
- addon 脚本与启动器在同一目录,或显式把脚本目录加入
sys.path。 - 环境已安装 mitmproxy 对应版本,端口、上游代理与 CA 证书配置就绪。
利用步骤
- 正常编写 addon 脚本(如
enc.py、dec.py):定义处理类(request/response方法)并保留addons = [Mimit(),]。 - 在同目录创建上游启动器
run_enc.py:from mitmproxy.tools.main import mitmdump,追加脚本目录到sys.path,再调用mitmdump(['-s', 'enc.py', '-p', '9091', '--ssl-insecure'])。 - 下游启动器同理,参数换成
['-s', 'dec.py', '-p', '7071', '--mode', 'upstream:http://127.0.0.1:8080']。 - 在 addon 的
request/response函数内下断点,用 IDE 的 Debug 模式运行启动器;触发一次代理流量,断点命中后可看到调用栈从 mitmproxy 的事件分发进入 addon 方法(trigger_event/ScriptLoader帧)。 - 调试完成后,恢复用
mitmdump -p ... -s ...命令行方式跑批量或长期运行,避免调试器暂停阻塞流量处理。
PoC
上游 addon 调试启动器:
import sys
import os
from mitmproxy.tools.main import mitmdump
sys.path.append(os.path.dirname(os.path.abspath(__file__)))
print(os.path.dirname(os.path.abspath(__file__)))
mitmdump(['-s', 'enc.py', '-p', str(9091)])
下游 addon 调试启动器(带上游代理模式):
import sys
import os
from mitmproxy.tools.main import mitmdump
sys.path.append(os.path.dirname(os.path.abspath(__file__)))
print(os.path.dirname(os.path.abspath(__file__)))
mitmdump(['-s', 'dec.py', '-p', str(7071), '--mode', 'upstream:http://127.0.0.1:8080'])
说明:在 IDE 中以调试模式运行上述启动器(而非直接运行 mitmdump 命令),再在 enc.py/dec.py 的钩子函数内下断点;断点命中后即可单步查看 flow 对象、修改加解密逻辑。仅在自有测试环境使用。
变体与关联
- 完整代理链场景:上游/下游两个 mitmdump 与 Burp 串联的加解密链路见 [[tools-burp-mitmproxy-dual-chain-aes-cbc-yakit-hotload-phone-bruteforce]](四钩子 +
--mode upstream+ 白名单)与 [[tools-burp-encrypted-api-proxy-decrypt-resign]](透明解密/重签与防重放字段重算);本卡是开发这两类 addon 时的调试配套技巧。 - 变体:只调一个代理时只写一个启动器;需要同时调上下游时两个启动器分别在 IDE 的不同运行配置中启动,参数中的
--mode upstream:指向 Burp 或另一层代理。 - 边界:启动器只解决“断点附错进程”的问题;证书错误、端口占用、上游代理不通属于运行配置问题,仍要按
--ssl-insecure、--mode upstream:...与 CA 信任逐一排查。 - 替代:不方便用调试器时,可在钩子里临时加
ctx.log.info打印flow.request.url、字段值与加解密中间结果,效果接近但无法单步。
检测与防御
- 本卡是开发/测试侧技巧,对目标服务端没有额外行为特征;断点暂停代理会阻塞流量,批量测试或长期挂代理时不要开启调试模式。
- 服务端视角与普通 mitmproxy 代理一致,防御仍依赖证书固定、双向认证与请求签名等既有手段,不因客户端调试方式改变。
- 仅限授权测试环境使用
--ssl-insecure(会跳过上游证书校验),不要在含敏感流量的生产网络中长期开启。