# mitmproxy

HTTP/Sトラフィックを調査、変更、記録、再生できる無料のオープンソースプロキシ。ターミナル、スクリプト、ブラウザーの各インターフェースを搭載。

> これは OpenNavo の mitmproxy ページの Markdown 版で、内容はウェブページと同じです： <https://opennavo.com/ja/apps/mitmproxy>

- **最新バージョン**: `12.3.1`
- **開発元**: mitmproxy project and contributors
- **ホームページ**: <https://mitmproxy.org/>
- **カテゴリ**: [ネットワーク](https://opennavo.com/ja/categories/network)
- **インストール**: `brew install --cask mitmproxy`
- **過去 30 日間のインストール数**: 11,246
- **Homebrew**: インストール可能、Homebrew で更新
- **ダウンロードURL**: <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アドオンと設定可能なオプションで処理を拡張できます。
- さまざまなネットワーク構成に対応したプロキシモードを利用できます。プロトコル機能は選択したモードによって異なります。

### インストールと初回使用
公式に推奨されているmacOSでの方法である`brew install --cask mitmproxy`をインストールするか、アーキテクチャ別のスタンドアロンアーカイブをダウンロードします。Homebrewのcaskはmitmproxy、mitmdump、mitmwebの実行ファイルをHomebrewのbinディレクトリにリンクします。これはコマンドラインツールの配布形態であり、ドラッグして使う従来型のGUIアプリケーションではありません。ターミナルでmitmproxyを起動するか、ローカルのブラウザーUIを使う場合は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向けのmacOSアーカイブを提供し、追加のformula依存関係は宣言していません。掲載されているmacOSプラットフォームにはBig Sur以降が含まれますが、取得した上流のインストールガイドには、独立した数値でのmacOS最小要件は記載されていません。caskのプラットフォーム一覧を、より古いすべてのOSでの動作保証とみなさないでください。公式のLinuxスタンドアロンバイナリとWindowsインストーラー／バイナリも利用できます。Windowsでは、提供元はWindows Terminalを推奨し、WSLにも対応しています。Linuxディストリビューションのパッケージはコミュニティが保守しており、上流版より遅れることがあります。このカタログの既定のダウンロードは、macOS ARM64アーカイブです。固定のRAMまたはディスク容量の最小要件は確認できていません。リソース使用量は、キャプチャ量と保存するフローによって変わります。アーカイブのダウンロードサイズは、インストール後の容量ではありません。

### 競合とクリーンアップ
Homebrewは、名称が指定されたcask競合を宣言していません。同名の実行ファイル、同じポートを使う別のプロキシ、クライアントのVPN／プロキシ経路設定は、動作に影響する場合があります。mitmproxyはすべてのプロセスを自動的にキャプチャするわけではありません。テストするトラフィックに適したプロキシモードを選択して設定してください。一部のTLSエラーは、インストールの問題ではなく、クライアントの信頼設定、ピンニング、証明書設定に起因します。任意のHomebrew zapは、設定、生成済みCA関連データ、そこに保持されているファイルを含め、~/.mitmproxyを削除します。必要なデータは事前にバックアップしてください。

### アカウント、費用、ライセンス
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 を使ってお使いの Mac 上でスキャンできます。

- <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 とエラーメッセージの処理が修正されました。

**セキュリティ**
- CVE-2026-111497 に対する upstream のデコーダー修正を含めるため、Brotli 1.2.1 が必要です。
- `--emudhra` または `--emudhra-old` が有効な場合、eMudhra および Sectigo の失効ホストへの OCSP および CRL リクエストをブロックします。

**追加**
- mitmproxy は Python 3.15 をサポートするようになりました。バイナリリリースにはデフォルトで 3.15 が同梱されます。

**修正**
- `set_all()` でクエリパラメータまたは Cookie を置き換える際に、呼び出し元が提供した値リストを保持します。
- server replay 中に、値が空の Cookie の有効期限を更新します。
- `%s` プレースホルダーで構築され、一度もフォーマットされなかった 2 つのエラーメッセージを修正します：BiDi 属性の検索と、`OptManager.make_parser` におけるサポートされていないオプション型。

## 情報と出典

- <https://opennavo.com/ja/apps/mitmproxy>
- <https://opennavo.com/ja/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 に確認
