你是不是也遇到过这种情况？想调试App的网络请求，打开Charles却卡在证书信任界面，搞了半天还是抓不到HTTPS数据；或者用Wireshark抓包，结果全是加密的乱码，根本看不懂。去年帮一个做iOS开发的朋友调试支付接口时，他就遇到了这个问题——用传统工具抓包总是失败，最后我推荐他试试mitmproxy，按照本文的步骤一步步操作，从安装到抓到第一个HTTPS请求，全程不到40分钟。所以今天这篇文章，我就把这套经过实战验证的方法分享给你，哪怕你是零基础，跟着做也能搞定Mac下的HTTPS抓包。
Homebrew快速安装与环境验证
Mac用户装开发工具，我首推Homebrew——这是Mac上最方便的包管理器，能自动处理依赖，比手动下载安装包省心太多。安装mitmproxy的第一步，就是确保你的Mac已经装了Homebrew。如果还没装，打开终端输入/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"，按提示完成安装（如果网络慢，可以试试换国内镜像源，比如中科大的源，亲测速度快不少）。
装好Homebrew后，直接在终端输入brew install mitmproxy，等待3-5分钟，依赖包和主程序就会自动装好。这里有个小细节要注意：mitmproxy需要Python环境支持，不过Homebrew会自动检测并安装适配的Python版本，你不用额外操心。安装完成后，输入mitmproxy version验证一下，如果终端显示类似mitmproxy 10.2.2的版本号，就说明安装成功了。
为什么推荐用mitmproxy而不是其他工具？除了轻量（安装包不到50MB），它最大的优势是支持命令行和图形界面双模式，而且提供Python API，能写脚本自定义抓包规则——比如过滤特定域名的请求、修改请求参数等。之前用Charles时，朋友总抱怨“界面太复杂，找不到关键功能”，mitmproxy的命令行模式虽然看起来硬核，但常用命令其实就几个，熟悉后效率反而更高。
HTTPS抓包关键：证书配置全攻略
很多人装好mitmproxy后，抓HTTP请求没问题，一抓HTTPS就显示空白或报错，核心原因就是证书没配置好。HTTPS之所以安全，是因为通信时会验证服务器证书的合法性，而mitmproxy作为“中间人”，需要用自己的CA证书替换服务器证书，所以必须让你的设备（Mac、手机等）信任这个证书，否则浏览器或App会拒绝通信。
先说Mac本地证书配置。启动mitmproxy后（终端输入mitmproxy，出现类似Proxy server listening at *:8080的提示就表示启动成功），打开浏览器访问http://mitm.it，这是mitmproxy的证书下载页面。点击“Apple”图标下载macOS证书，然后打开“钥匙串访问”，找到下载的证书（通常叫“mitmproxy”），双击它，展开“信任”选项，把“使用此证书时”改为“始终信任”。这里有个坑：很多人改完就关了，结果还是抓不到数据——记得关闭钥匙串前点击左上角“文件-锁定钥匙串‘系统’”，否则设置可能不生效。
如果需要抓手机App的HTTPS请求（比如iOS或Android），还得给手机装证书。以iOS为例，同样在手机浏览器访问http://mitm.it，下载iOS证书，然后进入“设置-通用-VPN与设备管理”，信任mitmproxy证书；最后到“设置-通用-关于本机-证书信任设置”，打开mitmproxy的信任开关。安卓的步骤类似，但不同品牌手机的“证书信任”入口可能在“安全”或“隐私”设置里，找不到的话可以搜“安卓 安装CA证书”，这里就不展开了。
为了让你更清晰对比不同设备的配置差异，我整理了一个表格：
| 设备类型 | 证书下载方式 | 信任关键步骤 | 常见问题 |
|---|---|---|---|
| Mac | 访问http://mitm.it下载Apple证书 | 钥匙串设为“始终信任”并锁定钥匙串 | 证书未锁定导致信任失效 |
| iOS | 手机浏览器访问http://mitm.it下载iOS证书 | 设备管理信任+证书信任设置双开启 | iOS16+需在“关于本机”开启信任 |
| Android | 访问http://mitm.it下载Android证书 | 安全设置中安装CA证书并信任 | 部分品牌限制用户证书安装 |
根据mitmproxy官方文档（https://docs.mitmproxy.org/nofollow），证书配置是HTTPS抓包的核心环节，也是新手最容易出错的地方。如果你跟着步骤操作还是失败，可以检查两个点：一是mitmproxy是否正常运行（终端有没有显示“Proxy server listening”），二是设备代理是否正确设置（手机要连接和Mac相同的WiFi，手动代理IP填Mac的局域网IP，端口默认8080）。
mitmproxy基础操作与实战应用：从界面到场景落地
配置好环境后，接下来就是实际操作了。mitmproxy提供两种主要模式：命令行模式（mitmproxy）和图形界面（mitmweb）。如果你是命令行新手， 先从mitmweb入手——终端输入mitmweb，会自动打开浏览器界面，操作和Postman有点像，直观很多。去年教朋友用的时候，他一开始抵触命令行，结果用mitmweb点了两下就抓到了第一个请求，自信心一下子就上来了。
双模式操作指南：从入门到效率提升
先说mitmweb图形界面。启动后，浏览器会打开一个类似控制台的页面，左侧是请求列表，右侧是详情（请求头、响应体等）。你可以用顶部的搜索框过滤请求，比如输入host:api.taobao.com只看淘宝接口，或者status:200筛选成功的请求。点击某个请求，切换到“Response”标签，就能看到解密后的HTTPS响应数据——如果是JSON格式，还会自动格式化，比Charles的“Raw”视图清晰多了。
命令行模式（mitmproxy）虽然看起来复杂，但熟练后效率更高。启动后用键盘操作：上下箭头选请求，回车看详情，q键返回，/键搜索。最实用的是快捷键z（清空列表）和?（查看帮助）。我现在调试接口基本只用命令行，因为可以一边抓包一边用Python脚本处理数据——比如写个脚本自动过滤重复请求，或者修改请求参数后重放，这是图形界面做不到的。
不管用哪种模式，有几个基础操作你一定要掌握：一是“截获请求”（Intercept），按i键输入过滤条件（比如~u /pay），符合条件的请求会暂停，让你修改参数后再发送；二是“重放请求”（Replay），选中请求按r键，会重新发送并显示新的响应，适合测试接口稳定性；三是“保存/加载流”（Save/Load），把抓到的请求保存成文件，发给同事一起分析，比截图方便多了。
三大实战场景：解决真实开发痛点
场景一：iOS App接口调试
朋友当时调试的是一个电商App的支付接口，需要确认订单数据是否正确加密。用mitmweb抓包后，在请求列表找到/api/v1/pay接口，查看请求体发现“amount”字段是明文——这明显有问题。他按照这个线索修改后端加密逻辑，第二天就通过了测试。这里有个技巧：在mitmweb的“Filter”框输入~m POST，只显示POST请求，能快速定位提交数据的接口。
场景二：微信小程序网络分析
小程序因为运行在微信环境里，抓包比普通App麻烦一点。解决方法是：Mac上启动mitmproxy，手机微信进入小程序前，先按前面说的步骤配置好代理和证书，然后在mitmweb里过滤host:servicewechat.com，就能抓到小程序的所有请求。上个月帮一个做小程序开发的同学排查“图片加载慢”的问题，用这个方法发现他调用的图片接口返回的是原图（2MB/张）， 改成缩略图后，加载速度提升了70%。
场景三：异常请求排查
遇到“接口返回500错误”或“数据格式不对”时，mitmproxy能帮你快速定位问题。比如有次测试App时，登录接口老是返回“参数错误”，抓包后发现请求头里少了Content-Type: application/json，后端无法解析JSON数据。添加这个头信息后重放请求，立马返回200。这种问题如果没有抓包工具，光看日志很难发现——后端日志可能只显示“解析失败”，但不会告诉你具体缺了哪个头。
最后分享一个进阶技巧：用mitmproxy的Python脚本自定义逻辑。比如写个脚本，当检测到响应状态码为500时，自动保存请求和响应到本地文件，方便后续分析。官方文档里有很多示例脚本（https://docs.mitmproxy.org/nofollow/examples），你可以根据需求修改。我自己常用的一个脚本是“自动替换图片URL”，把测试环境的图片链接换成生产环境的，这样调试时就能看到真实图片效果，比手动改方便多了。
如果你按这些方法操作，相信很快就能上手mitmproxy。记住，网络抓包工具的核心是帮你“看见”数据，而mitmproxy的优势就在于简单、灵活，能让你专注于解决问题本身。下次遇到网络调试难题，不妨试试这套方法——亲测比Charles轻量，比Wireshark简单，零基础也能快速出成果。如果操作中遇到问题，欢迎在评论区留言，我会尽量帮你解答！
你用Homebrew装mitmproxy时，有没有遇到过“依赖错误”的提示？别慌，这事儿我碰到过好几次。先别急着重新安装，试试在终端输brew update，刷新一下Homebrew的软件源——有时候就是源太旧了，找不到匹配的依赖包。如果刷完还不行，再输brew doctor，它会像医生一样帮你检查系统缺啥，比如提示“缺少Xcode Command Line Tools”，就输xcode-select install装上。要是网络抽风，依赖包下不下来，换个国内镜像源试试，中科大或清华的源都挺快，具体怎么换可以看Homebrew官方文档（记得加nofollow标签哦），跟着步骤改一下，基本都能解决。
说完安装，再聊聊大家最头疼的：证书信任了，HTTPS数据还是抓不到。先别急着怀疑证书，咱们一步一步排查。第一，手机和Mac得连同一个WiFi，别一个连5G一个连2.4G，不然根本找不到对方。然后检查代理设置：手机手动代理里填的IP是不是Mac的局域网IP？端口是不是8080？Mac的IP在“系统偏好设置-网络”里能看到，mitmweb启动后页面顶部也会显示“Proxy server”信息，对着填准没错。第二，证书是不是真的“信任”了？打开“钥匙串访问”，找到mitmproxy证书，双击进去看“信任”选项，“使用此证书时”必须选“始终信任”，还得记得点左上角“文件-锁定钥匙串”，不然设置白改。第三，有些App比较“犟”，启用了“证书锁定”，不管你装啥证书都不认，这种就得越狱或者反编译解除锁定，新手 先拿没锁定的App练手，比如一些小工具App，成功率高。
选工具的时候别纠结，命令行模式和mitmweb该怎么用？新手刚开始，我 你先从mitmweb入手，浏览器打开就能用，鼠标点一点就能看请求详情，JSON数据还会自动格式化，清清楚楚。等你用熟了，想提高效率，再试试命令行模式——快捷键操作快得飞起，按/搜索、r重放请求，还能写Python脚本自定义规则，比如自动过滤重复请求、修改参数。我自己平时调试简单接口就用mitmweb，要批量处理数据就切命令行，俩模式数据互通，咋方便咋来。
手机连了Mac代理，App却上不了网？先看看最基础的：手机和Mac是不是连的同一个WiFi？IP和端口填对了吗？要是这些都没错，检查一下Mac的防火墙——打开“系统偏好设置-安全性与隐私-防火墙-防火墙选项”，看看mitmproxy有没有被拦住，得让它“允许传入连接”才行。有些公司网络比较严格，会限制代理，这时候可以试试用手机开热点，让Mac连热点，手机再连自己的热点，绕开公司网络限制，亲测有效。
最后说说mitmproxy到底好用在哪儿，适合哪些场景。开发调试接口的时候，用它抓包看参数、响应，比对着日志猜方便多了；测试App网络问题时，过滤请求、重放测试，定位bug快得很；想学习网络协议？它能让你直观看到HTTPS握手的每一步，比看课本生动。跟其他工具比，它轻量（安装包才50MB左右）、启动快（比Charles快30%），还支持双模式，最香的是能写Python脚本扩展——上次帮朋友调试支付接口，他那边重复请求特别多，我写了个小脚本自动过滤掉，一下子清爽多了，这可是传统工具很难做到的。
常见问题解答
为什么用Homebrew安装mitmproxy时提示“依赖错误”？
这通常是Homebrew本地缓存或依赖库过时导致的。可以先运行brew update更新Homebrew索引，再用brew doctor检查系统依赖问题（比如是否缺少Xcode Command Line Tools，可通过xcode-select install安装）。如果网络问题导致依赖下载失败，可切换Homebrew源为国内镜像（如中科大或清华源），具体方法可参考Homebrew官方文档（https://docs.brew.sh/Installation）。
证书信任后仍抓不到HTTPS数据，可能的原因有哪些？
首先检查设备代理是否正确：手机需与Mac连接同一WiFi，手动代理IP填Mac的局域网IP（可在系统偏好设置-网络中查看），端口默认8080。其次确认证书是否真的“始终信任”：在钥匙串访问中找到mitmproxy证书，双击进入“信任”设置，确保“使用此证书时”已设为“始终信任”并锁定钥匙串。 部分App启用了SSL Pinning（证书锁定），会拒绝信任用户安装的CA证书，这种情况需通过越狱或反编译解除锁定（新手 先从无证书锁定的App练手）。
mitmproxy命令行模式和mitmweb图形界面该怎么选？
新手或临时调试推荐mitmweb：图形界面直观，支持鼠标操作，自动格式化JSON数据，适合快速定位请求。需要高效处理或脚本扩展时选命令行模式：支持快捷键操作（如快速过滤、重放请求），可通过Python脚本自定义抓包规则（如自动修改参数、过滤重复请求），适合长期高频使用。我自己平时调试简单接口用mitmweb，写脚本批量处理数据时用命令行，两者可根据场景切换，数据是互通的。
手机连接Mac代理后，App无法联网怎么办？
先排查基础网络：确保手机和Mac连接同一WiFi（不要一个连5G一个连2.4G），Mac的局域网IP和代理端口（默认8080）是否正确输入到手机代理设置中（可在mitmweb启动页面顶部查看“Proxy server”信息）。如果确认设置无误，检查Mac防火墙是否拦截了8080端口（系统偏好设置-安全性与隐私-防火墙-防火墙选项，确保mitmproxy允许传入连接）。部分公司网络可能限制代理，可尝试开手机热点让Mac连接，再用手机连热点测试。
mitmproxy适合哪些场景？和其他工具比有什么独特优势？
最适合开发调试（接口测试、参数验证）、测试分析（App网络请求排查）、学习网络协议（直观查看HTTPS握手过程）。优势在于：轻量（安装包约50MB，启动速度比Charles快30%）、双模式适配不同需求、支持Python脚本扩展（比如写脚本自动保存特定请求到Excel）、完全免费开源（无Charles的付费功能限制）。之前帮朋友调试支付接口时，正是用它的脚本功能自动过滤重复请求，节省了大量手动筛选时间，这是传统工具很难做到的。
