# mitmproxy

Бесплатный прокси с открытым исходным кодом для проверки, изменения, записи и повтора HTTP/S-трафика; доступны интерфейсы командной строки, сценариев и браузера.

> Это Markdown-версия страницы mitmproxy на OpenNavo с теми же сведениями, что и на веб-странице: <https://opennavo.com/ru/apps/mitmproxy>

- **Последняя версия**: `12.3.1`
- **Разработчик**: mitmproxy project and contributors
- **Главная**: <https://mitmproxy.org/>
- **Категории**: [Сеть](https://opennavo.com/ru/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 в каталоге bin для Homebrew; это дистрибутив командной строки, а не обычное графическое приложение, которое можно перетащить в папку. Запустите mitmproxy в терминале или mitmweb, чтобы открыть локальный интерфейс в браузере. Настройте тестовый клиент на использование прослушивающего прокси; в обычном режиме прокси прослушивает порт 8080, а mitmweb использует отдельный веб-интерфейс. Если этот порт уже занят другой локальной службой, измените его.

Для проверки HTTPS тестовый клиент должен доверять центру сертификации mitmproxy, созданному для вашей установки. В официальном руководстве по сертификатам описана настройка доверия на каждой платформе. Чтобы получить подходящий сертификат, браузер может открыть mitm.it через настроенный прокси. Закрепление сертификата или хранилище доверия конкретного приложения всё же могут препятствовать перехвату. По завершении верните настройки прокси и доверия клиента в нужное состояние. Записанный трафик и закрытый ключ центра сертификации в ~/.mitmproxy могут содержать конфиденциальные данные; сохраняйте только то, что необходимо для тестирования.

### Требования и зависимости
Официальные автономные исполняемые файлы содержат самодостаточную среду Python3, OpenSSL и другие зависимости. Для этого cask отдельно устанавливать Python не требуется. В выпуске линии 12.2 среда исполняемых файлов была переведена на Python3.14. Для дополнений, которым нужны дополнительные пакеты Python, может потребоваться отдельная установка через PyPI/uv с этими пакетами, а не изменение замороженного автономного комплекта. Зависимости в выпуске с исполняемыми файлами нельзя обновлять отдельно; чтобы получить более новые включённые зависимости, обновите mitmproxy.

cask предоставляет архивы для Apple Silicon и Intel на macOS и не указывает дополнительных зависимостей формулы. Среди перечисленных платформ macOS — Big Sur и новее, однако в полученном руководстве по установке от разработчиков не указана отдельная числовая минимальная версия macOS; список платформ для cask не гарантирует работу на каждой более старой ОС. Также доступны официальные автономные исполняемые файлы для Linux и установщик/исполняемые файлы для Windows. Для Windows издатель рекомендует Windows Terminal и также поддерживает WSL. Пакеты дистрибутивов Linux поддерживаются сообществом и могут отставать от актуальной версии. В этом каталоге по умолчанию предлагается архив macOS ARM64. Подтверждённый минимум оперативной памяти или места на диске не установлен; использование ресурсов зависит от объёма захвата и сохранённых потоков. Размер скачиваемого архива не равен объёму места, необходимому после установки.

### Конфликты и удаление
Homebrew не указывает именных конфликтов с cask. На работу могут влиять существующие исполняемые файлы с такими же именами, другой прокси на том же порту или маршрутизация через VPN/прокси клиента. mitmproxy не захватывает автоматически трафик каждого процесса: выберите и настройте подходящий режим прокси для проверяемого трафика. Некоторые ошибки TLS связаны с доверием клиента, закреплением сертификата или настройкой сертификатов, а не с ошибкой установки. Необязательная команда Homebrew zap удаляет ~/.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 выпущен 25 октября 2026 г.; это обновление требует Brotli 1.2.1 для включения исправления безопасности декодера, добавляет поддержку Python 3.15 и исправляет обработку cookie и сообщений об ошибках.

**Безопасность**
- Требует Brotli 1.2.1, чтобы включить исправление декодера из upstream для CVE-2026-111497.
- Блокирует запросы OCSP и CRL к хостам отзыва eMudhra и Sectigo, когда включён `--emudhra` или `--emudhra-old`.

**Добавлено**
- mitmproxy теперь поддерживает Python 3.15. Бинарные выпуски по умолчанию поставляются с 3.15.

**Исправлено**
- Сохраняет списки значений, предоставленные вызывающей стороной, при замене параметров запроса или cookie с помощью `set_all()`.
- Обновляет даты истечения срока действия cookie с пустым значением во время server replay.
- Исправляет два сообщения об ошибке, которые были созданы с заполнителями `%s` и никогда не форматировались: поиск атрибутов BiDi и неподдерживаемые типы опций в `OptManager.make_parser`.

## Сведения и источники

- <https://opennavo.com/ru/apps/mitmproxy>
- <https://opennavo.com/ru/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
