Основные проблемы с настройкой Charles Proxy

  Трудности бесплатной версии

В официальной (бесплатной/триальной) версии Charles Proxy предусмотрены следующие ограничения:

• После запуска бесплатная сессия длится ровно 30 минут, по истечении этого времени Charles автоматически останавливается и требует перезапуска.

• При старте программы добавляется задержка около 5–10 секунд.

• При активном использовании периодически всплывает окно триала на 5–10 секунд.

Если вы используете Charles регулярно, особенно для длительных сессий, имеет смысл приобрести лицензию — тогда эти ограничения исчезают.

Если у вас ничего не работает — вы не одиноки. Основная причина в том, что у современных систем часто слишком много разных маршрутов трафика. Вот типичная ситуация:

• Вся система использует системный прокси.
• Firefox настроен на свой отдельный прокси и игнорирует системные настройки.
• Chrome работает через VPN.
• Терминал (curl, wget и т. д.) использует Cloudflare WARP или другие сетевые драйверы.

Charles подключается к локальному прокси (обычно 127.0.0.1:8888), и если ваше приложение идёт мимо этой точки — вы не увидите ни одного запроса.

Что делать?

• Отключите временно VPN, Cloudflare WARP и другие прокси.
• Проверьте настройки прокси в браузере. Особенно в Firefox — он использует собственные настройки.
• В Charles включите: Proxy → macOS Proxy или Windows Proxy в зависимости от ОС.
• Если используете терминал — установите переменные среды:

  export http_proxy=http://127.0.0.1:8888  
  export https_proxy=http://127.0.0.1:8888

 Полезный совет

Для начала тестируйте Charles на простом кейсе: откройте сайт в браузере без VPN и посмотрите, появился ли трафик. Если да — значит проблема была в маршрутах. Если нет — проверьте, запущен ли прокси и не блокирует ли его firewall или антивирус.
Также проверьте все Tools и фильтры в Charles, иногда они блокируют трафик.

Разрешения(extensions)

Иногда трафик из браузера не отображается в Charles Proxy из-за установленных расширений (extensions), которые могут блокировать или перенаправлять сетевые запросы. Например, VPN-расширения, блокировщики рекламы, трекеров или расширения для повышения конфиденциальности могут мешать корректной передаче трафика через прокси-сервер Charles. В таких случаях запросы либо вовсе не проходят через Charles, либо искажаются. Чтобы устранить проблему, стоит временно отключить подобные расширения и проверить, начал ли отображаться трафик.

Проблемы с SSL в Charles Proxy

Если вы видите в Charles пустые ответы или ошибку SSL Proxying not enabled, значит зашифрованный трафик (HTTPS) не расшифровывается. Для этого Charles должен подменить сертификат, а система и браузер — доверять ему.

1. Включите SSL Proxying в Charles

   • Откройте Proxy → SSL Proxying Settings.
   • Поставьте галочку Enable SSL Proxying.
   • Добавьте домены, которые хотите расшифровывать (например, *:443 — для всех HTTPS-сайтов).
     
     Без этого Charles будет видеть только домен, но не путь, заголовки и тело запроса.

2. Установите сертификат Charles в систему

   На macOS

   • Help → SSL Proxying → Install Charles Root Certificate.
   • Откроется Keychain Access (Связка ключей).
   • Найдите сертификат Charles Proxy CA.
   • Откройте его (двойной клик), раскройте Trust и выберите Always Trust.

   На Windows

   • Help → SSL Proxying → Install Charles Root Certificate.
   • Подтвердите установку в хранилище доверенных корневых центров сертификации.

3. Установите сертификат в браузер

   Некоторые браузеры (например, Firefox) не доверяют системным сертификатам и требуют ручной установки.

   Firefox

   1. Откройте about:preferences#privacy → Просмотр сертификатов....
   2. Во вкладке Центры сертификации нажмите Импортировать.
   3. Выберите сертификат Charles (его можно экспортировать из Help → SSL Proxying → Save Charles Root Certificate).
   4. Поставьте галочку Доверять при идентификации веб-сайтов.

4. Перезапустите Charles и браузер

   После установки и доверия к сертификату перезапустите Charles и браузер — изменения не применяются мгновенно.

🐞 Частые ошибки

• Браузер пишет "Подключение не защищено" (SSL_ERROR_UNKNOWN_CA) — не установлен или не доверен сертификат.
• В Charles вместо тела запроса написано "SSL Proxying not enabled" — вы забыли включить SSL Proxying в настройках.
• Firefox работает, но Chrome — нет — Chrome использует системные сертификаты, Firefox — свои.

 Проверка

Перейдите на любой HTTPS-сайт (например, https://jsonplaceholder.typicode.com) и убедитесь, что Charles показывает тело ответа. Если всё работает — значит SSL-прокси настроен правильно. Если виден только домен — вы забыли включить или настроить SSL Proxying.

 Советы

• Сертификат Charles временный — после переустановки приложения или системы его нужно установить заново.
• Никогда не используйте Charles-сертификат в продуктивной среде — это манипуляция трафиком, доверяйте только на время отладки.

 Charles не запускается или вылетает

Иногда Charles может не запускаться или неожиданно завершать работу, особенно на Linux или macOS.

Решение:

• Убедитесь, что у вас установлена последняя версия Java. Charles требует Java для работы. Скачайте и установите Java с официального сайта.
• Проверьте наличие прав доступа. На Linux или macOS выполните команду для запуска Charles с правами администратора:

• sudo /usr/bin/charles

 Медленная работа или зависания

Charles может работать медленно, особенно при перехвате большого объёма трафика.

Решение:

• Ограничьте перехват трафика: в Proxy → Recording Settings настройте фильтры, чтобы перехватывать только нужные домены.
• Отключите ненужные функции, такие как Breakpoints или Throttling, если они не используются.
• Увеличьте выделенную память для Charles. На macOS или Linux отредактируйте файл charles.ini и добавьте параметр, например: -Xmx2g для выделения 2 ГБ памяти.

Если вы не нашли решения своей проблемы

Обратитесь к официальной документации или задайте вопрос на форумах, таких как Stack Overflow, указав точное описание проблемы и вашу операционную систему.