# mitmproxy

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

> 这是 OpenNavo 上 mitmproxy 页面的 Markdown 版本，内容与网页相同： <https://opennavo.com/zh/apps/mitmproxy>

- **最新版本**: `12.3.1`
- **开发者**: mitmproxy project and contributors
- **主页**: <https://mitmproxy.org/>
- **分类**: [网络](https://opennavo.com/zh/categories/network)
- **安装**: `brew install --cask mitmproxy`
- **近 30 天安装**: 11,246
- **Homebrew**: 可以安装，由 Homebrew 更新
- **下载地址**: <https://downloads.mitmproxy.org/12.3.1/mitmproxy-12.3.1-macos-arm64.tar.gz>
- **SHA-256**: `9b7f7a8e3fd1b1544089c937c579ef1f0f503f0ea598c25bda9eab077c735b93`
- **附带命令**: mitmdump, mitmproxy, mitmweb

SHA-256 只用来核对下载的文件是否完整，不代表安全认证。

## 安装与卸载内容

```json
[
  {
    "declaration": {
      "binary": [
        "mitmproxy.app/Contents/MacOS/mitmdump"
      ],
      "target": "$HOMEBREW_PREFIX/bin/mitmdump"
    },
    "phase": "install",
    "sources": [
      "mitmproxy.app/Contents/MacOS/mitmdump"
    ],
    "target": "$HOMEBREW_PREFIX/bin/mitmdump",
    "type": "binary"
  },
  {
    "declaration": {
      "binary": [
        "mitmproxy.app/Contents/MacOS/mitmproxy"
      ],
      "target": "$HOMEBREW_PREFIX/bin/mitmproxy"
    },
    "phase": "install",
    "sources": [
      "mitmproxy.app/Contents/MacOS/mitmproxy"
    ],
    "target": "$HOMEBREW_PREFIX/bin/mitmproxy",
    "type": "binary"
  },
  {
    "declaration": {
      "binary": [
        "mitmproxy.app/Contents/MacOS/mitmweb"
      ],
      "target": "$HOMEBREW_PREFIX/bin/mitmweb"
    },
    "phase": "install",
    "sources": [
      "mitmproxy.app/Contents/MacOS/mitmweb"
    ],
    "target": "$HOMEBREW_PREFIX/bin/mitmweb",
    "type": "binary"
  },
  {
    "declaration": {
      "zap": [
        {
          "trash": "~/.mitmproxy"
        }
      ]
    },
    "phase": "cleanup",
    "sources": [],
    "type": "zap"
  }
]
```

## 介绍

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 不会向外发送数据，也不会自动检查更新。

### 官方参考资料
- [安装和捆绑依赖项](https://docs.mitmproxy.org/stable/overview/installation/)
- [证书](https://docs.mitmproxy.org/stable/concepts/certificates/)
- [官方下载](https://mitmproxy.org/downloads/)
- [源代码和 MIT 许可证](https://github.com/mitmproxy/mitmproxy/tree/v12.2.3)
- [特定版本的变更日志](https://github.com/mitmproxy/mitmproxy/blob/v12.2.3/CHANGELOG.md)

## 系统要求

- 适用于 macOS 27, 26, 15, 14, 13, 12, 11 的版本 · 应用版本: 12.3.1 · Intel · <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/m/mitmproxy.rb> · 核查于 2026-11-21
  - <https://downloads.mitmproxy.org/12.3.1/mitmproxy-12.3.1-macos-x86_64.tar.gz>
  - SHA-256: `f4cf5e563e7068af297a27be97686f58917760d3c0dcc6a997ca83f6f5ffb3db`
- 适用于 macOS 27, 26, 15, 14, 13, 12, 11 的版本 · 应用版本: 12.3.1 · Apple 芯片 · <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/m/mitmproxy.rb> · 核查于 2026-11-21
  - <https://downloads.mitmproxy.org/12.3.1/mitmproxy-12.3.1-macos-arm64.tar.gz>
  - SHA-256: `9b7f7a8e3fd1b1544089c937c579ef1f0f503f0ea598c25bda9eab077c735b93`

## mitmproxy 的安全事实

这里只列可以核验的事实，并注明来源和日期，不是安全认证。要检查你下载的文件，可以用 OpenNavo 在本机扫描。

- <https://github.com/mitmproxy/mitmproxy> · 是否开源: 是 — <https://github.com/mitmproxy/mitmproxy> · 核查于 2026-11-13

## 卸载

- `brew uninstall --cask mitmproxy`

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

### 深度清理（可选）

- `brew uninstall --zap --cask mitmproxy`

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

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

- 文件和文件夹: `~/.mitmproxy` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/m/mitmproxy.rb> · 以上条目来自 Homebrew 定义，核查于 2026-11-21；它们只说明定义声明会删除什么，不代表你的 Mac 上都有。

## 最新版本说明

### 12.3.1 (2026-10-25)

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` 中不受支持的选项类型。

## 资料与来源

- <https://opennavo.com/zh/apps/mitmproxy>
- <https://opennavo.com/zh/apps/mitmproxy/versions>
- <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/m/mitmproxy.rb> · 核查于 2026-11-21
- <https://formulae.brew.sh/cask/mitmproxy>
- <https://github.com/mitmproxy/mitmproxy> · 核查于 2026-11-13
