手机上的某个 App,你没点任何东西,通知栏却弹出了广告;你想知道它刚才到底往哪个地址发了什么,可 Wireshark 只能给你一串加密后的乱码。这时候需要的是中间人代理:把手机流量引到电脑上,解开 HTTPS 给你看明文。mitmproxy 把这件事简化成一条 pip 命令加一个代理端口,今晚就能跑通。
项目名片
| 条目 | 内容 |
|---|---|
| 仓库 | mitmproxy/mitmproxy |
| 数据 | 47,121 star / 5,004 fork / 565 open issue(2026-11-22 抓取) |
| 技术栈 | Python |
| 许可证 | MIT(LICENSE 原文确认) |
| 最新版本 | v12.3.1(2026-10-25 发布) |
| 默认端口 | 代理 8080,mitmweb 界面 8081 |
| 最近提交 | 2026-11-19(三天前仍在活跃更新) |
它解决什么问题
后端联调时,对方说「我传的是这个字段」,你拿到的报文却对不上号;写爬虫前想摸清一个网页到底用了哪些参数;物联网设备的固件往云端发了什么,文档里只字未提。这类问题都卡在同一个地方:HTTPS 把内容包起来了,你看不见。
mitmproxy 在中间当一道可读的关口:你的程序把代理指到它那里,它替你和真实服务器各建一条加密连接,中间这一段以明文展示,还能改。它可以在某些场景替代 Charles、Fiddler 这类商业抓包工具的日常用法,替不掉的是对界面深度依赖的团队协作功能和移动端的一键配置体验。
核心机制
- 启动后在本机开一个 HTTP 代理端口(默认 8080),手机或程序把代理指过去,流量就从它手里过一遍。(推断:它对每个域名动态签发证书,客户端信任了证书,才肯交出明文。)
- 首次运行会在用户目录下生成一套 CA 证书,README 明确要求:必须手动安装 mitmproxy-ca-cert.pem,否则 HTTPS 流量只会显示为加密连接。
- 一套内核配三种外壳:mitmproxy 是终端交互界面,mitmweb 开一个网页控制台,mitmdump 完全无界面、专为挂脚本设计。(推断:重复性的改包验证用脚本钩子比手点界面省事得多。)
- 提供 Python 事件钩子,可以在请求发出前改参数、在响应回来后改内容,用来构造边界情况验证程序行为。
跑起来
Linux 或 macOS 上推荐用 pipx 装成独立环境,不污染系统包:
pip3 install pipx
pipx install mitmproxy
装完即可启动,网页版对新手最友好:
mitmweb --listen-port 8080
想录一段流量事后分析,用无界面版落盘:
mitmdump -w flows.dump
回放刚才录的文件:
mitmdump -r flows.dump
从零到能用
- 电脑上执行 mitmweb --listen-port 8080,浏览器打开 8081 端口的控制台页面。
- 手机连到和电脑相同的 Wi-Fi,把手动代理指向「你的电脑IP」,端口 8080。
- 手机浏览器访问 mitm.it,按系统点对应按钮下载并安装根证书,Android 装完记得在设置里信任用户证书。
- 随便打开一个网站,回到控制台,请求流会实时滚出来,域名和路径一目了然。
- 点开任意一条请求,在 Request 和 Response 标签之间切换,能看到完整明文。
- 选中一条请求点 Replay,把它原样再发一次,对照服务器的反应排查时序问题。
适合谁用 / 别用
适合:客户端和后端联调接口、想亲眼看看 HTTPS 之下到底传了什么的网络初学者、动手写爬虫之前先摸清参数来源的人。装一遍证书、看一眼明文,对理解 HTTPS 握手比看十篇科普都直观。
别用:目标 App 做了证书固定,或者走的是私有二进制协议,mitmproxy 解不开也不该硬去解;排查生产环境流量请走网关日志和链路追踪,抓包只适合小范围的定点验证。
三个真实的坑
- Chrome 自带证书固定,部分域名的请求装了证书也抓不到明文。issue #1097(Chrome/Chromium and certificate pinning)记录了这个现象,官方文档建议这类场景换 Firefox 配合代理。
- Android 14 起系统收紧了证书目录,用户装的 CA 默认不再被应用信任,装完还是解不开。issue #6498(Android 14 System Certificate Issue)里有讨论,想抓就得把证书写进系统证书目录,通常需要 root。
- 用 mitmdump 抓 WebSocket 长连接时,默认会丢弃没有交互的空闲历史帧,录下来的连接像缺了一段。issue #8519(Discard unused WebSocket history by default in mitmdump)确认了这个默认行为,抓长连接前要留意。
小结
回到开头那则来路不明的推送广告:把手机代理指过去、装一张证书,两分钟就能看到它背后请求了什么。mitmproxy 四万七千个 star 不是白来的,它是把「看不见」变成「看得见」的最短路径。装上它,你对自己手机每天发出的流量,会有完全不同的判断。
参考资料
- 仓库:https://github.com/mitmproxy/mitmproxy
- README(证书安装说明):https://github.com/mitmproxy/mitmproxy#readme
- 最新发布:https://github.com/mitmproxy/mitmproxy/releases/tag/v12.3.1
- issue #1097:https://github.com/mitmproxy/mitmproxy/issues/1097
- issue #6498:https://github.com/mitmproxy/mitmproxy/issues/6498
- issue #8519:https://github.com/mitmproxy/mitmproxy/issues/8519
默认评论
Halo系统提供的评论