1. 为什么你需要掌握mitmproxy作为一个经常和网络请求打交道的开发者我发现自己越来越离不开mitmproxy这个工具。它就像网络世界的显微镜能让你看清每一个HTTP/HTTPS请求的细节。想象一下当你调试一个复杂的API调用时能够实时看到请求头、响应体、状态码甚至修改这些内容这能节省多少调试时间mitmproxy本质上是一个中间人代理工具但它比Fiddler或Charles更强大之处在于完全开源、支持脚本扩展。我在实际项目中用它做过很多事测试移动端API、分析第三方服务接口、模拟网络异常、自动化测试等等。最让我惊喜的是它的Python脚本支持这意味着你可以用代码来自定义任何处理逻辑。2. 从零开始安装mitmproxy2.1 跨平台安装指南虽然原始文章提到Windows不支持mitmproxy的命令行界面但其实通过WSL2可以完美解决这个问题。我建议的安装流程是这样的# 对于Linux/macOS/WSL2用户 pip install --user mitmproxy # 或者使用pipx推荐可以避免依赖冲突 python -m pip install --user pipx python -m pipx ensurepath pipx install mitmproxyWindows原生环境确实无法使用mitmproxy命令但mitmweb和mitmdump都是可用的。如果你坚持要用完整功能建议安装Windows Terminal WSL2 Ubuntu组合这是我实测最稳定的方案。2.2 验证安装是否成功安装完成后试试这几个命令mitmproxy --version mitmdump --version mitmweb --version如果都能输出版本号说明基础组件安装正确。我遇到过有些同学的环境变量配置有问题这时候可以尝试用绝对路径调用~/.local/bin/mitmproxy --version3. 配置你的抓包环境3.1 浏览器代理设置很多人卡在第一步的代理配置上。我推荐使用Chrome插件SwitchyOmega但更简单的方法是直接使用系统代理设置# 启动mitmproxy并监听8080端口 mitmweb -p 8080然后在系统网络设置中配置HTTP和HTTPS代理为127.0.0.1:8080。移动设备则需要确保和电脑在同一局域网然后配置代理指向电脑的IP地址。3.2 HTTPS证书安装要点抓取HTTPS流量必须安装CA证书这是很多新手容易忽略的步骤。除了原始文章提到的mitm.it方法外证书文件其实就存放在~/.mitmproxy/mitmproxy-ca-cert.pem双击这个文件就能安装。iOS设备需要额外步骤安装证书后还需要到设置-通用-关于本机-证书信任设置中启用对mitmproxy证书的完全信任。4. mitmproxy三大组件的实战用法4.1 mitmweb可视化调试利器启动mitmweb后浏览器会自动打开http://localhost:8081。这里分享几个实用技巧右键请求可以快速Replay用于重复测试使用顶部的Filter输入框过滤请求例如~u baidu.com点击请求详情中的Response选项卡可以查看格式化后的JSON数据我经常用这个界面来调试微信小程序因为小程序开发者工具的网络面板功能有限。4.2 mitmdump自动化处理神器mitmdump的强大之处在于可以配合Python脚本。创建一个script.pydef response(flow): if api.example.com in flow.request.url: flow.response.content flow.response.content.replace( bsuccess:false, bsuccess:true )然后运行mitmdump -s script.py这个脚本会把所有api.example.com接口返回的success字段改为true。我在测试环境经常用这种方式模拟各种接口返回。4.3 mitmproxy命令行高手之选虽然Windows不支持但在Linux/macOS下mitmproxy的命令行界面效率极高。常用快捷键q返回上级f过滤请求例如输入~u baidu.come编辑请求/响应r重放请求5. 高级应用场景解析5.1 请求录制与回放录制电商网站购物流程# 录制 mitmdump -w shopping_flow.mitm # 过滤只保留关键API mitmdump -nr shopping_flow.mitm -w checkout.mitm ~u /api/checkout # 回放测试 mitmdump -nC checkout.mitm这个流程可以用来做自动化回归测试我团队用它来验证每次发布前的核心业务流程。5.2 性能测试与限速模拟通过脚本模拟弱网环境from mitmproxy import http import random def request(flow: http.HTTPFlow) - None: if random.random() 0.3: # 30%概率延迟 flow.delay 2 # 延迟2秒运行时会随机给请求添加延迟非常适合测试应用的弱网兼容性。5.3 移动端调试实战Android设备配置代理后经常遇到抓不到包的情况。这时候需要确保手机和电脑在同一WiFi在手机WiFi设置中手动配置代理访问http://mitm.it下载证书对于Android 7还需要将证书移动到系统证书目录我写过一个自动化脚本帮助团队配置测试手机节省了大量重复劳动。6. 常见问题排坑指南证书问题如果遇到您的连接不是私密连接错误通常是证书没装对。可以尝试# 删除旧证书重新生成 rm -rf ~/.mitmproxy mitmproxy抓不到包检查防火墙设置确保8080端口开放。在Linux上可能需要sudo ufw allow 8080脚本不生效确保脚本中的函数名正确request/response并且没有语法错误。可以加调试输出print(fProcessing: {flow.request.url})7. 安全使用建议虽然mitmproxy很强大但需要注意不要在公共网络开启mitmproxy测试完成后及时关闭代理不要在生产环境使用敏感数据记得从录制文件中删除我习惯在测试完成后运行这个命令清理录制文件find . -name *.mitm -exec shred -zu {} \;mitmproxy的学习曲线确实有点陡峭但一旦掌握它就会成为你开发调试的超级武器。从最简单的抓包开始逐步尝试编写处理脚本你会发现越来越多的使用场景。我到现在还在不断发现它的新用法这也是技术工具的魅力所在。