跳到正文

mitmproxy

mitmproxy project and contributors · 免费开源代理,可检查、修改、记录和重放 HTTP/S 流量,提供终端、脚本化和浏览器界面。

Cask网络 4.7万
主页
安装命令
brew install --cask mitmproxy
近 30 天安装
11,246
App榜第 39
近一年安装
9.5万
365 天累计
最新版本
12.3.1
下载大小
56MB
gz
更新节奏
每两周
近 30 天 2 个版本

介绍

mitmproxy 是一款免费开源的交互式代理,可用于检查、修改、记录和重放网络流量。开发者、测试人员和网络工程师可在自己控制的环境中调查应用和服务。它包括 mitmproxy(终端界面)、mitmdump(用于脚本化处理的命令行工具)以及 mitmweb(基于浏览器的界面)。

功能

  • 检查 HTTP 和 HTTPS 请求与响应,包括 HTTP/2 和 WebSocket 流量。
  • 拦截并编辑消息,然后恢复请求,以检查应用行为。
  • 记录流量流,进行筛选和注释,并重放客户端或服务器流量。
  • 导出流量以供进一步分析,包括 HAR 工作流。
  • 通过 Python 插件和可配置选项扩展处理能力。
  • 使用适用于不同网络配置的受支持代理模式;协议功能取决于所选模式。

安装和初次使用

安装 brew install --cask mitmproxy(官方推荐的 macOS 安装方式),或下载适用于相应架构的独立压缩包。Homebrew cask 会将 mitmproxy、mitmdump 和 mitmweb 可执行文件链接到 Homebrew 的 bin 目录;它是命令行工具发行包,而不是可拖动安装的传统图形界面应用。请在终端中启动 mitmproxy,或启动 mitmweb 以使用其本地浏览器界面。将测试客户端配置为使用监听代理;常规代理模式通常监听端口8080,而 mitmweb 使用独立的 Web 界面。如果其他本地服务已占用这些端口,请更改端口。

要检查 HTTPS 流量,测试客户端必须信任为你的安装生成的 mitmproxy CA。官方证书指南说明了如何在各个平台上安装信任证书。浏览器可通过已配置的代理访问 mitm.it,以获取相应证书。证书固定或应用专用的信任存储仍可能阻止拦截。完成后,请将客户端代理和信任设置恢复到所需状态。记录的流量以及 ~/.mitmproxy 中的 CA 私钥可能包含敏感材料;仅保留测试工作流所需的内容。

要求和依赖项

官方独立二进制文件包含自包含的 Python3 环境、OpenSSL 和其他依赖项。使用此 cask 无需单独安装 Python。版本12.2 系列的二进制环境已迁移至 Python3.14。需要额外 Python 软件包的插件,可能需要另行通过 PyPI/uv 安装这些软件包,而不是修改冻结的独立软件包。二进制发行版中的依赖项无法单独更新;请更新 mitmproxy 以获取较新的捆绑依赖项。

cask 提供适用于 Apple Silicon 和 Intel Mac 的压缩包,且未声明额外的 formula 依赖项。其列出的 macOS 平台包括 Big Sur 及更新版本,但检索到的上游安装指南未单独给出 macOS 的最低版本号;不要将 cask 平台列表视为对所有较旧操作系统的保证。官方也提供 Linux 独立二进制文件以及 Windows 安装程序/二进制文件。在 Windows 上,发布方推荐使用 Windows Terminal,也支持 WSL。Linux 发行版软件包由社区维护,可能落后于上游版本。本目录默认下载的是 macOS ARM64 压缩包。尚未确认固定的最低内存或磁盘空间要求;捕获流量的数量和已存储的流会影响资源使用。压缩包下载大小不等于安装后占用空间。

冲突和清理

Homebrew 未声明任何具名的 cask 冲突。存在同名可执行文件、其他代理占用同一端口,或客户端 VPN/代理路由,都可能影响运行。mitmproxy 不会自动捕获每个进程:请为想要测试的流量选择并配置合适的代理模式。某些 TLS 错误源于客户端信任、证书固定或证书配置,而非安装错误。可选的 Homebrew zap 会删除 ~/.mitmproxy,包括其中的设置、生成的 CA 材料和保留文件;请先备份所需数据。

账户、费用和许可证

mitmproxy 是采用 MIT 许可证的免费软件,由 mitmproxy 项目及贡献者维护。核心本地使用无需付费订阅或托管服务账户。你连接的第三方服务仍使用各自的凭据并收取相应费用。该项目接受赞助。官方安装文档说明,mitmproxy 不会向外发送数据,也不会自动检查更新。

官方参考资料

基本信息

价格
免费
芯片
Apple 芯片 · Intel
自动更新
否
仓库
开源 · MIT · 2 天前更新★4.7万
开发者
mitmproxy project and contributors
Homebrew
可以安装,由 Homebrew 更新
主页
mitmproxy.org
软件包标识符
mitmproxy

核查日期

12.3.1 更新内容

新版本 · OpenNavo 编辑

mitmproxy 12.3.1 于 2026 年 10 月 25 日发布,本次更新要求 Brotli 1.2.1 以包含解码器安全修复,新增 Python 3.15 支持,并修复 cookie 与错误消息的处理。

安全

  • 要求 Brotli 1.2.1,以包含 upstream 针对 CVE-2026-111497 的解码器修复。
  • 启用 --emudhra 或 --emudhra-old 时,阻止发往 eMudhra 和 Sectigo 吊销主机的 OCSP 和 CRL 请求。

新增

  • mitmproxy 现已支持 Python 3.15。二进制发行版默认附带 3.15。

修复

  • 使用 set_all() 替换查询参数或 cookie 时,保留调用方提供的值列表。
  • 在 server replay 期间,刷新值为空的 cookie 的过期日期。
  • 修复两条使用 %s 占位符构建但从未格式化的错误消息:BiDi 属性查找和 OptManager.make_parser 中不受支持的选项类型。

如何在 Mac 上安装 mitmproxy

不用 Homebrew 安装

按芯片下载 Homebrew 使用的文件: 安装细节

卸载 mitmproxy 与可选的数据清理

卸载命令
brew uninstall --cask mitmproxy

普通卸载会删除应用本身,设置和缓存会保留。

深度清理(可选)
卸载命令
brew uninstall --zap --cask mitmproxy

--zap 还会删除 Homebrew 定义里列出的设置、缓存等文件,其中可能有其他应用共用的数据,删除后无法恢复;它也不保证没有任何残留。请先备份需要保留的数据;如要保留设置和缓存,请不要加 --zap。

关于 mitmproxy 的常见问题

mitmproxy 安全吗?

mitmproxy 收录在 Homebrew 官方软件库中,没有被停用。自 2026 年 9 月起,Homebrew 会停用没有通过 macOS Gatekeeper 检查的应用。安装时,Homebrew 会用 SHA-256 校验值核对来自 downloads.mitmproxy.org 的安装包。过去 30 天,它通过 Homebrew 安装了 11,246 次。

mitmproxy 免费吗?

是的,mitmproxy 可以免费使用。来源:www.mitmproxy.org,核查于 2026年10月25日。

mitmproxy 是开源软件吗?

mitmproxy 的源代码公开在 GitHub 上(mitmproxy/mitmproxy),使用 MIT 许可证。

怎样在 Mac 上彻底卸载 mitmproxy?

运行 brew uninstall --cask mitmproxy。要连设置和缓存一起删除,运行 brew uninstall --zap --cask mitmproxy。--zap 还会删除 Homebrew 定义里列出的设置、缓存等文件,其中可能有其他应用共用的数据,删除后无法恢复;它也不保证没有任何残留。请先备份需要保留的数据;如要保留设置和缓存,请不要加 --zap。这会同时删除 ~/.mitmproxy。

mitmproxy 支持 Apple 芯片(M1 及更新)的 Mac 吗?

支持。Homebrew 会为 Apple 芯片和 Intel 芯片的 Mac 分别下载不同的安装包。

mitmproxy 的设置和数据保存在哪里?

数据保存在 ~/.mitmproxy。这些位置来自 Homebrew 的清理清单。

mitmproxy 的最新版本是多少?

最新版本是 12.3.1,Homebrew 收录于 2026年10月26日。运行 brew upgrade --cask mitmproxy 即可更新。

安装 mitmproxy 还会装上什么?

还会装上 3 个命令行工具:mitmdump、mitmproxy和mitmweb。

相似应用

  • ngrok通过安全的公共端点公开本地和私有服务,并提供流量策略、检查和请求重放,用于开发与连接。
  • Tailscale通过基于 WireGuard 的网络连接设备,设置访问策略、子网路由,查看定价,并排查设置问题。
  • Wireshark使用过滤器、统计信息和配套命令行工具检查网络数据包、捕获流量并分析协议。
  • Windows AppMicrosoft 远程访问客户端,适用于 Windows PC、云桌面和管理员提供的 Windows 应用程序。
查看更多