Прокси в мобильном QA: эмулятор, реальное устройство и adb reverse — пошаговый гайд
Содержание статьи
- Введение: зачем тестировщику свой прокси между приложением и сервером
- Предварительная подготовка: инструменты, доступы и системные требования
- Базовые понятия: как устроен перехват трафика
- Шаг 1: поднимаем перехватывающий прокси на компьютере
- Шаг 2: направляем трафик android-эмулятора через прокси
- Шаг 3: устанавливаем сертификат прокси и решаем проблему доверия
- Шаг 4: подключаем реальное устройство по wi-fi
- Шаг 5: проброс порта через adb reverse — прокси по usb без wi-fi
- Шаг 6: перехватываем и подменяем трафик тестового стенда
- Проверка результата: итоговый чек-лист
- Типичные ошибки и решения
- Дополнительные возможности для продвинутых тестировщиков
- Faq: частые вопросы по настройке прокси в мобильном тестировании
- Заключение
Введение: зачем тестировщику свой прокси между приложением и сервером
Представьте: вы тестируете мобильное приложение, нажимаете кнопку, а на экране появляется абстрактная ошибка "Что-то пошло не так". Разработчик спрашивает: "Какой запрос ушел? Какой ответ пришел? Какой код статуса?". Без прокси вы разводите руками. С прокси — открываете список запросов, копируете тело ответа сервера и прикладываете к багу за тридцать секунд. Это и есть разница между тестировщиком, который "кликает", и тестировщиком, который понимает, что происходит под капотом.
Эта статья намеренно отличается от инструкций для обычных пользователей, где объясняют, как вписать адрес прокси в настройки Wi-Fi телефона. Здесь мы разбираем рабочий процесс QA-инженера: перехватывающий прокси на компьютере, направление в него трафика Android-эмулятора, подключение реального устройства по Wi-Fi и по USB через проброс порта командой adb reverse, а также перехват и подмена трафика тестового стенда. Пользовательская настройка прокси на телефоне — лишь один маленький кирпичик в этом процессе.
Что вы получите в итоге
- Работающий перехватывающий прокси (mitmproxy или Charles), который показывает каждый HTTP- и HTTPS-запрос вашего приложения.
- Эмулятор Android, трафик которого проходит через этот прокси, включая зашифрованный трафик.
- Реальный смартфон, подключенный к прокси двумя способами: по Wi-Fi и по USB-кабелю через adb reverse.
- Понимание, почему приложение "не доверяет" сертификату и как это решается на тестовой сборке.
- Навык подмены ответов тестового стенда, эмуляции медленной сети и ошибок сервера без участия бэкенд-разработчика.
Для кого этот гайд
Для ручных и автоматизирующих тестировщиков мобильных приложений, которые хотят видеть сетевой трафик, а не гадать. Для джуниоров, которым на новой работе сказали "посмотри в Charles", а что это и как — не объяснили. Для разработчиков, которые настраивают тестовое окружение команде.
Что нужно знать заранее
Базовое понимание того, что такое HTTP-запрос, ответ, код статуса 200 и 500. Умение открыть терминал или командную строку и выполнить в ней команду. Опыт установки приложений на Android. Если вы никогда не запускали эмулятор — не страшно, мы пройдем этот путь вместе.
Сколько времени потребуется
При хорошем интернете и уже установленной Android Studio — от полутора до двух часов на весь гайд. Если Android Studio еще нет, добавьте 30-60 минут на скачивание образов системы. После первого прохождения повторная настройка на новом проекте занимает около десяти минут.
Предварительная подготовка: инструменты, доступы и системные требования
Что нужно установить на компьютер
- Android Studio актуальной версии 2025-2026 года. Вместе с ней ставится Android SDK, Android Emulator и утилита adb. Это основной набор инструментов.
- Перехватывающий прокси. В гайде показаны два варианта: бесплатный mitmproxy (работает в терминале и через веб-интерфейс mitmweb) и коммерческий Charles Proxy с бесплатным пробным режимом. Выберите один, второй можно освоить позже. Все инструкции даны для обоих.
- Java не нужна отдельно: Android Studio использует встроенный JDK.
- Тестовая сборка приложения в формате APK. Это должна быть debug-сборка или специальная QA-сборка, а не релиз из магазина. Почему это критично — объясним в разделе про сертификаты.
Системные требования
- Операционная система: Windows 10 или 11 (64-bit), macOS 12 и новее, Linux с поддержкой KVM.
- Оперативная память: минимум 8 ГБ, комфортно — 16 ГБ. Эмулятор сам по себе съедает 2-4 ГБ.
- Свободное место на диске: не менее 20 ГБ. Один образ системы Android весит 1,5-2 ГБ, плюс сама Android Studio.
- Аппаратная виртуализация включена в BIOS/UEFI (Intel VT-x или AMD-V). Без нее эмулятор будет работать мучительно медленно или не запустится.
- Реальное Android-устройство с версией Android 8 и выше и USB-кабель для передачи данных (не только зарядки).
Доступы, которые нужно запросить у команды
- Адрес тестового стенда (например, https://api-stage.example-team.ru) и тестовые учетные данные.
- Debug-сборка приложения или сборка с флагом "QA build". Уточните у разработчиков, доверяет ли она пользовательским сертификатам и отключен ли в ней certificate pinning.
- Если стенд закрыт по IP или требует подключения к корпоративной сети — узнайте у администратора, как к нему подключаться с вашего рабочего компьютера. Мы не рассматриваем никаких способов обхода ограничений: только штатные доступы, выданные вашей командой.
Резервные копии и безопасность
Прокси-настройки в эмуляторе и на устройстве полностью обратимы. Однако перед началом стоит сделать две вещи. Во-первых, если на реальном телефоне уже есть рабочие настройки Wi-Fi или сертификаты, сделайте скриншоты экранов настроек — так вы быстро вернете все как было. Во-вторых, лучше использовать отдельное тестовое устройство, а не личный телефон с банковскими приложениями: корневой сертификат прокси дает его владельцу возможность читать зашифрованный трафик. На тестовом устройстве это норма, на личном — риск.
Внимание: Никогда не устанавливайте корневой сертификат перехватывающего прокси на личное устройство, где есть банковские и платежные приложения, и не передавайте файл приватного ключа прокси коллегам через мессенджеры. Сертификат генерируется локально на вашем компьютере и должен оставаться там.
Базовые понятия: как устроен перехват трафика
Что такое перехватывающий прокси
Обычный прокси — это посредник, который принимает запрос от клиента и пересылает его серверу. Перехватывающий прокси (его еще называют отладочным или man-in-the-middle-прокси) делает то же самое, но при этом сохраняет копию каждого запроса и ответа, показывает их вам в удобном виде и позволяет останавливать, изменять и подменять их. Для тестировщика это как рентген для врача.
Почему HTTPS не виден просто так
Почти весь современный трафик зашифрован по протоколу TLS. Прокси видит, что телефон подключился к серверу api-stage.example-team.ru, но содержимое запросов для него — шифрованный поток. Чтобы расшифровать, прокси генерирует собственный корневой сертификат (CA) и на лету выпускает поддельные сертификаты для каждого сайта. Телефон должен доверять этому корневому сертификату — иначе приложение увидит подмену и разорвет соединение с ошибкой вроде "Trust anchor for certification path not found". Поэтому установка сертификата прокси на устройство — обязательный шаг.
Пользовательские и системные сертификаты в Android
Начиная с Android 7, приложения по умолчанию доверяют только системным сертификатам и игнорируют те, что установил пользователь через настройки. Браузер Chrome — исключение, он доверяет пользовательским. Чтобы ваше приложение доверяло сертификату прокси, у разработчиков есть два легальных пути: либо в debug-сборке добавить файл network_security_config.xml с разрешением доверять пользовательским сертификатам, либо вы устанавливаете сертификат как системный на эмуляторе с правами root. Первый путь проще и правильнее для командной работы.
Certificate pinning
Некоторые приложения дополнительно "пришпиливают" конкретный сертификат сервера и отказываются работать с любым другим, даже доверенным. Это хорошая защита в продакшене, но для тестирования на стенде pinning обычно отключают в debug-сборках. Если после всех настроек приложение все равно не ходит через прокси, спросите у разработчиков именно про pinning.
Как эмулятор видит ваш компьютер
Android-эмулятор — это виртуальная машина со своей сетью. Внутри нее адрес 127.0.0.1 означает сам эмулятор, а не ваш компьютер. Чтобы обратиться к компьютеру, из эмулятора используют специальный адрес 10.0.2.2. Запомните его — он появится в командах ниже.
Что такое adb и adb reverse
adb (Android Debug Bridge) — консольная утилита, которая управляет Android-устройством с компьютера: устанавливает приложения, выполняет команды, пробрасывает порты. Команда adb reverse делает так, что порт на устройстве "смотрит" на порт вашего компьютера. Например, после adb reverse tcp:8080 tcp:8080 приложение на телефоне, обращаясь к localhost:8080, на самом деле попадет на порт 8080 компьютера, где слушает прокси. Это работает по USB, не требует общей Wi-Fi сети и не зависит от корпоративных ограничений точки доступа. Обратная команда, adb forward, работает в другую сторону: порт компьютера ведет на устройство. Не путайте их.
Тестовый стенд
Стенд (stage, staging, dev-окружение) — копия серверной части приложения для тестирования. На стенде можно ломать данные, подменять ответы и смотреть логи. Приложение обычно переключается на стенд либо отдельной сборкой, либо скрытым меню. Весь перехват трафика мы делаем именно со стендом, а не с продакшеном.
Шаг 1: Поднимаем перехватывающий прокси на компьютере
Цель этапа: на компьютере работает прокси, слушает порт (8080 для mitmproxy или 8888 для Charles), и вы знаете IP-адрес компьютера в локальной сети.
Вариант А: mitmproxy
- Скачайте установщик mitmproxy для вашей ОС с официального сайта проекта или установите через пакетный менеджер. На macOS удобно через Homebrew, на Windows — установщик в формате .msi, на Linux — через pipx или бинарный архив.
- Откройте терминал (на Windows — PowerShell или Windows Terminal).
- Запустите веб-версию командой:
В терминале появятся строки о запуске прокси на порту 8080, а в браузере откроется вкладка с веб-интерфейсом по адресу 127.0.0.1:8081. Именно здесь будут появляться запросы.mitmweb --listen-port 8080 - Обратите внимание: интерфейс mitmweb работает на порту 8081, а сам прокси слушает на 8080. В настройках устройств вы всегда указываете 8080.
- При первом запуске mitmproxy создаст папку .mitmproxy в домашнем каталоге пользователя. В ней лежит файл mitmproxy-ca-cert.cer — это и есть корневой сертификат, который мы позже установим на устройства.
Совет: Если хотите работать полностью в терминале без браузера, запускайте команду mitmproxy вместо mitmweb. Интерфейс будет консольным: стрелки для навигации, Enter для открытия запроса, q для возврата. Для автоматизации есть mitmdump, который пишет поток в файл.
Вариант Б: Charles Proxy
- Скачайте Charles с официального сайта, установите и запустите. Появится главное окно с пустым списком слева и вкладками Overview, Contents справа.
- Откройте меню Proxy → Proxy Settings. На вкладке Proxies убедитесь, что порт равен 8888, а галочка "Enable transparent HTTP proxying" снята. Нажмите OK.
- Откройте Proxy → SSL Proxying Settings. Поставьте галочку Enable SSL Proxying. В блок Include нажмите Add и добавьте хост * с портом 443. Так Charles будет расшифровывать весь HTTPS. Позже вы сможете сузить список до домена стенда.
- Если Charles предложит настроить системный прокси macOS или Windows, откажитесь: нам нужен трафик телефона, а не браузера компьютера. Отключить можно через меню Proxy, сняв галочки macOS Proxy или Windows Proxy.
Узнаем IP-адрес компьютера
Для реального устройства по Wi-Fi понадобится адрес компьютера в локальной сети.
- Windows: в PowerShell выполните ipconfig и найдите строку IPv4-адрес у активного адаптера Wi-Fi или Ethernet. Обычно это что-то вроде 192.168.1.45.
- macOS: Системные настройки → Сеть → выберите активное подключение, адрес показан в деталях. Или в терминале ipconfig getifaddr en0.
- Linux: команда ip addr show или hostname -I.
Запишите этот адрес. Далее по тексту мы будем называть его условно 192.168.1.45, подставляйте свой.
Открываем порт в брандмауэре
Windows при первом запуске mitmproxy или Charles спросит, разрешить ли программе принимать подключения. Обязательно разрешите для частных сетей. Если окно не появилось, откройте "Брандмауэр Защитника Windows → Разрешение взаимодействия с приложением" и добавьте программу вручную. На macOS разрешение спрашивается аналогично при первом входящем подключении.
Проверка: Откройте браузер на компьютере, в его настройках временно укажите прокси 127.0.0.1 и порт 8080 (или 8888) и зайдите на любой сайт. В mitmweb или Charles должны появиться строки запросов. После проверки уберите прокси из браузера, чтобы он не мешал. Альтернатива без настройки браузера — команда:
curl -x http://127.0.0.1:8080 -k https://example.comЕсли в интерфейсе прокси появилась строка с example.com — прокси работает.Возможные проблемы на этом этапе
- Порт занят. Сообщение вида "Address already in use". Значит, на 8080 уже что-то слушает — часто это локальный стенд или другой инструмент. Запустите прокси на другом порту, например 8082, и далее везде используйте его.
- mitmweb не открывает браузер. Откройте вручную адрес 127.0.0.1:8081. В терминале будет напечатан адрес с токеном, скопируйте его целиком.
- Charles не показывает HTTPS-содержимое, только заголовки CONNECT. Не включен SSL Proxying или в Include не добавлен хост. Вернитесь к пункту 3 варианта Б.
Шаг 2: Направляем трафик Android-эмулятора через прокси
Цель этапа: запущенный эмулятор отправляет все HTTP- и HTTPS-запросы в ваш прокси, и вы видите их в интерфейсе.
Создаем и запускаем эмулятор
- Откройте Android Studio. Если нет открытого проекта, на стартовом экране выберите More Actions → Virtual Device Manager. Внутри проекта: меню Tools → Device Manager.
- Нажмите кнопку создания устройства (плюс или Create Virtual Device).
- Выберите модель, например Pixel 8, и нажмите Next.
- Выберите образ системы. Важно: для тестирования через прокси удобнее образ с пометкой Google APIs, а не Google Play. У образов Google Play заблокирован root-доступ, и вы не сможете установить системный сертификат, если он понадобится. Для Android 14-16 такие образы называются вроде "Android 15.0 Google APIs x86_64" (на компьютерах с процессорами Apple — arm64-v8a). Если рядом с образом стрелка загрузки — скачайте его, это займет 5-15 минут.
- На последнем экране дайте устройству имя без пробелов, например Pixel_8_QA, и нажмите Finish.
- Запустите эмулятор кнопкой с треугольником. Первый запуск занимает 1-3 минуты.
Способ 1: настройка через панель эмулятора (самый простой)
- В окне запущенного эмулятора найдите вертикальную панель справа. Нажмите три точки внизу — откроется окно Extended Controls.
- В левом меню выберите Settings, затем вкладку Proxy.
- Снимите галочку "Use Android Studio HTTP proxy settings".
- Выберите Manual proxy configuration.
- В поле Host name введите 127.0.0.1. Здесь, в отличие от настроек внутри самого Android, эмулятор применяет прокси на уровне хост-машины, поэтому адрес компьютера указывается как 127.0.0.1.
- В поле Port number введите 8080 (для Charles — 8888).
- Нажмите Apply. Ниже должен появиться статус "Proxy status: Success". Если написано Error — прокси не запущен или указан неверный порт.
Способ 2: настройка через adb (гибкий, подходит для скриптов)
- Откройте терминал. Убедитесь, что adb доступен: команда adb devices должна показать строку вида emulator-5554 device. Если команда не найдена, добавьте в PATH папку platform-tools внутри Android SDK (путь можно посмотреть в Android Studio: Settings → Languages and Frameworks → Android SDK).
- Выполните:
Здесь мы уже находимся "внутри" Android, поэтому компьютер обозначается адресом 10.0.2.2.adb shell settings put global http_proxy 10.0.2.2:8080 - Проверьте, что настройка применилась:
Должно вернуться 10.0.2.2:8080.adb shell settings get global http_proxy - Чтобы отключить прокси, выполните:
adb shell settings put global http_proxy :0
Способ 3: параметр командной строки при запуске
Если вы запускаете эмулятор из терминала (например, в CI или скриптах), добавьте флаг:
emulator -avd Pixel_8_QA -http-proxy http://127.0.0.1:8080Исполняемый файл emulator лежит в папке emulator внутри Android SDK. Прокси применится ко всей сессии эмулятора.
Совет: Сделайте два маленьких скрипта — proxy_on и proxy_off — с командами adb из способа 2. За день тестирования вы будете включать и выключать прокси десятки раз, и лишние клики по меню утомляют.
Проверяем, что трафик пошел
- В эмуляторе откройте браузер Chrome и зайдите на любой сайт по HTTPS.
- В mitmweb или Charles должны появиться запросы. Скорее всего, страница в Chrome покажет ошибку безопасности — это нормально, сертификат мы еще не установили. Главное, что запросы видны как записи с хостом и методом CONNECT.
Проверка: В интерфейсе прокси появляются строки с доменом сайта, который вы открыли в эмуляторе, а команда adb shell settings get global http_proxy возвращает адрес и порт вашего прокси. Если оба условия выполнены — эмулятор направлен в прокси корректно.
Возможные проблемы
- Proxy status: Error в панели эмулятора. Прокси не запущен, либо порт другой. Запустите mitmweb или Charles и нажмите Apply снова.
- Запросы не появляются, хотя статус Success. Приложение может использовать собственный сетевой стек, игнорирующий системный прокси (например, приложения на Flutter по умолчанию). Об этом — в разделе типичных ошибок.
- Эмулятор потерял интернет после отключения прокси. Вы, вероятно, оставили значение http_proxy пустым, а не ":0". Повторите команду отключения с двоеточием и нулем и перезапустите эмулятор.
Шаг 3: Устанавливаем сертификат прокси и решаем проблему доверия
Цель этапа: эмулятор и тестовое приложение доверяют корневому сертификату прокси, и вы видите расшифрованное содержимое HTTPS-запросов: URL, заголовки, тела запросов и ответов.
Устанавливаем сертификат как пользовательский
- Убедитесь, что прокси включен на эмуляторе (Шаг 2).
- В браузере Chrome внутри эмулятора откройте адрес mitm.it (для mitmproxy) или chls.pro/ssl (для Charles). Это специальные адреса, которые прокси перехватывает и отдает страницу загрузки сертификата. Если вместо страницы вы видите обычный сайт или ошибку — трафик не идет через прокси, вернитесь к Шагу 2.
- Для mitmproxy нажмите кнопку Android и скачайте файл mitmproxy-ca-cert.cer. Для Charles файл скачается сразу.
- Откройте на эмуляторе Настройки → Безопасность и конфиденциальность → Другие настройки безопасности → Шифрование и учетные данные → Установка сертификата → Сертификат ЦС (в некоторых версиях путь: Безопасность → Дополнительные настройки → Шифрование и учетные данные). Появится предупреждение о рисках — нажмите "Все равно установить".
- Выберите скачанный файл в папке Downloads. Если эмулятор попросит задать PIN-код экрана, задайте простой, например 1234, и запомните его.
- После установки проверьте: Шифрование и учетные данные → Надежные сертификаты → вкладка Пользователь. Там должна появиться запись mitmproxy или Charles Proxy CA.
Альтернативный способ без браузера — скопировать файл командой adb push и затем выбрать его из файлового менеджера:
adb push ~/.mitmproxy/mitmproxy-ca-cert.cer /sdcard/Download/Теперь Chrome в эмуляторе откроет любой HTTPS-сайт без ошибок, а в прокси вы увидите расшифрованные запросы браузера. Но ваше тестовое приложение, скорее всего, по-прежнему будет падать с ошибкой сети. Переходим к главному.
Почему приложение не доверяет и что просить у разработчиков
Как мы разобрали в базовых понятиях, приложения на Android 7+ игнорируют пользовательские сертификаты. Правильное решение — чтобы debug-сборка содержала файл конфигурации сетевой безопасности. Разработчик добавляет в res/xml/network_security_config.xml примерно такое содержимое:
<network-security-config><debug-overrides><trust-anchors><certificates src='system' /><certificates src='user' /></trust-anchors></debug-overrides></network-security-config>И подключает его в AndroidManifest.xml через атрибут android:networkSecurityConfig. Блок debug-overrides работает только в отладочных сборках, поэтому релиз остается защищенным. Это стандартная практика, и в большинстве команд такой файл уже есть. Скопируйте фрагмент выше в задачу для разработчика, если его нет.
Внимание: Не просите добавить доверие пользовательским сертификатам в базовую конфигурацию без debug-overrides и не соглашайтесь на отключение проверки сертификатов в релизе. Это ослабит защиту реальных пользователей. Все изменения должны касаться только debug- и QA-сборок.
Запасной путь: системный сертификат на эмуляторе с root
Если сборку под вас изменить не могут, на эмуляторе с образом Google APIs (не Google Play) сертификат можно положить в системное хранилище. Тогда любые приложения без pinning будут ему доверять. Кратко порядок действий для Android 14 и новее, где системные сертификаты лежат в разделе apex:
- Запустите эмулятор из терминала с флагом -writable-system.
- Выполните adb root, затем adb remount.
- Вычислите имя файла сертификата в формате hash.0 командой openssl x509 -inform PEM -subject_hash_old -in mitmproxy-ca-cert.cer -noout и переименуйте файл в полученное значение с суффиксом .0 (например, c8750f0d.0).
- Скопируйте файл в системное хранилище сертификатов через adb push в /system/etc/security/cacerts/ и перезагрузите эмулятор. На Android 14+ дополнительно требуется перемонтировать каталог, куда система подгружает сертификаты; в документации mitmproxy есть готовый скрипт для этого.
Этот путь мощнее, но хрупче: после обновления образа все сбрасывается, а на Android 14+ шаги сложнее. Для повседневной работы рекомендуем первый путь с network_security_config.
Устанавливаем тестовое приложение
- Положите APK в удобную папку.
- Выполните adb install -r путь/к/app-debug.apk. Флаг -r переустанавливает поверх существующей версии, сохраняя данные.
- Через 10-30 секунд появится Success, и иконка приложения появится в эмуляторе.
Проверка: Откройте тестовое приложение, авторизуйтесь на стенде. В mitmweb или Charles появились запросы к домену стенда, и при клике на любой из них вы видите вкладки с заголовками, телом запроса в JSON и телом ответа. Если тело ответа читаемо — сертификат установлен и приложение ему доверяет. Это главная контрольная точка всего гайда.
Возможные проблемы
- Chrome открывает сайты, а приложение показывает ошибку сети. Приложение не доверяет пользовательскому сертификату. Нужна сборка с network_security_config или системный сертификат.
- В логах приложения (adb logcat) видно "Certificate pinning failure". Включен pinning. Попросите QA-сборку с отключенным pinning для домена стенда.
- mitm.it показывает страницу "If you can see this, traffic is not passing through mitmproxy". Прокси не применился. Проверьте настройку Шага 2.
Шаг 4: Подключаем реальное устройство по Wi-Fi
Цель этапа: реальный смартфон в той же Wi-Fi сети, что и компьютер, отправляет трафик в прокси.
Это тот способ, который описан в обычных пользовательских инструкциях, но у тестировщика есть свои нюансы: нужно понимать, когда он не сработает, и уметь быстро переключаться. Эмулятор не заменяет реальное устройство: на нем нет реальной камеры, push-уведомления приходят иначе, датчики и энергосбережение ведут себя по-другому. Поэтому проверять сетевые сценарии на реальном телефоне обязательно.
Настраиваем прокси в параметрах Wi-Fi
- Подключите телефон к той же Wi-Fi сети, что и компьютер. Домашний роутер подойдет. Гостевая корпоративная сеть — часто нет, об этом ниже.
- Откройте Настройки → Сеть и интернет → Wi-Fi (на Samsung: Подключения → Wi-Fi).
- Нажмите на шестеренку рядом с текущей сетью или долгим нажатием на имя сети вызовите меню и выберите "Изменить сеть".
- Раскройте "Дополнительно" или "Расширенные настройки".
- В пункте Прокси выберите Вручную.
- Имя хоста прокси: IP-адрес вашего компьютера, например 192.168.1.45. Порт: 8080 или 8888. Поле "Не использовать прокси для" оставьте пустым.
- Сохраните. Телефон переподключится к сети.
Устанавливаем сертификат на телефон
- Откройте Chrome на телефоне и зайдите на mitm.it или chls.pro/ssl. Скачайте сертификат.
- Настройки → Безопасность → Шифрование и учетные данные → Установка сертификата → Сертификат ЦС → выберите файл. Названия пунктов немного отличаются у Samsung, Xiaomi, Huawei, но логика та же: ищите слова "учетные данные" или "сертификат".
- Установите тестовое приложение через adb install или напрямую из файла.
Совет: Присвойте компьютеру постоянный IP-адрес в настройках роутера (резервирование DHCP по MAC-адресу). Иначе после перезагрузки роутера адрес изменится, и все телефоны в команде перестанут ходить через прокси, а вы полчаса будете искать причину.
Когда Wi-Fi способ не работает
- Изоляция клиентов (AP isolation) в корпоративной или гостевой сети. Устройства видят интернет, но не видят друг друга. Симптом: телефон с прокси полностью теряет интернет, а mitm.it не открывается. Проверка: с компьютера выполните ping IP-адреса телефона (его можно посмотреть в свойствах Wi-Fi). Нет ответа — есть изоляция.
- Компьютер и телефон в разных подсетях. Например, ноутбук в проводной сети 10.10.0.x, а телефон в Wi-Fi 192.168.1.x.
- Брандмауэр компьютера блокирует входящие. Особенно частая проблема на Windows с "Общедоступной" сетью. Переключите профиль сети на "Частная".
Во всех этих случаях решение одно — проброс порта по USB, к которому мы переходим.
Проверка: В интерфейсе прокси появились запросы с телефона, а в Charles в колонке Client видно IP телефона, отличный от 127.0.0.1. Откройте тестовое приложение, выполните любое действие — соответствующий запрос к стенду появился в списке с расшифрованным телом.
Шаг 5: Проброс порта через adb reverse — прокси по USB без Wi-Fi
Цель этапа: реальный телефон, подключенный только USB-кабелем, направляет трафик в прокси на компьютере, независимо от Wi-Fi сети.
Это самый надежный способ для офиса, коворкинга и любой сети, где вы не управляете роутером. Идея: командой adb reverse мы делаем так, что порт 8080 на самом телефоне ведет на порт 8080 компьютера. Дальше телефону говорим использовать прокси 127.0.0.1:8080 — то есть "самого себя", а adb незаметно доставляет пакеты на компьютер.
Включаем отладку по USB
- На телефоне откройте Настройки → О телефоне и семь раз нажмите на "Номер сборки". Появится сообщение "Вы стали разработчиком". На Xiaomi нажимать нужно на "Версия MIUI" или "Версия HyperOS".
- Вернитесь в Настройки → Система → Для разработчиков (на Samsung — в корне Настроек). Включите переключатель Отладка по USB.
- Подключите телефон кабелем к компьютеру. На телефоне появится запрос "Разрешить отладку по USB?" с отпечатком компьютера. Поставьте галочку "Всегда разрешать" и нажмите Разрешить.
- На компьютере выполните adb devices. Должна появиться строка с серийным номером и словом device. Если написано unauthorized — посмотрите на экран телефона, там висит запрос. Если offline — переподключите кабель.
Внимание: Используйте кабель, который поддерживает передачу данных. Многие дешевые кабели из комплектов внешних аккумуляторов только заряжают. Если телефон заряжается, но adb devices пуст — первым делом меняйте кабель, а не переустанавливайте драйверы.
Выполняем проброс
- Убедитесь, что прокси на компьютере запущен и слушает порт 8080.
- Выполните команду:
Первое число — порт на телефоне, второе — порт на компьютере. В ответ команда напечатает 8080 или ничего — это нормально.adb reverse tcp:8080 tcp:8080 - Проверьте список активных пробросов:
Должна появиться строка вида host-номер tcp:8080 tcp:8080.adb reverse --list - Если у вас подключено несколько устройств (например, эмулятор и телефон), укажите серийный номер флагом -s:
adb -s R58M1234ABC reverse tcp:8080 tcp:8080
Указываем телефону прокси на localhost
Здесь есть два пути. Первый — через adb, самый быстрый:
adb shell settings put global http_proxy 127.0.0.1:8080Второй — вручную в настройках Wi-Fi телефона, как в Шаге 4, но в поле хоста указать 127.0.0.1, а порт 8080. Второй способ нужен на некоторых прошивках, где глобальная настройка через adb не применяется ко всем приложениям.
Обратите внимание на важный нюанс. Глобальная настройка http_proxy применяется системой к текущему сетевому соединению. Если Wi-Fi выключен и телефон работает через мобильные данные, часть прошивок все равно применяет ее, а часть — нет. Надежнее всего держать Wi-Fi включенным (любая сеть, даже без выхода к компьютеру) и указывать прокси 127.0.0.1 в ее настройках. Трафик через adb reverse пойдет по USB независимо от того, к какой Wi-Fi сети подключен телефон.
Устанавливаем сертификат
Порядок тот же, что раньше: Chrome → mitm.it → скачать → установить как сертификат ЦС. Если сертификат уже установлен на этом телефоне на Шаге 4, повторять не нужно.
Отключаем проброс после работы
- Уберите прокси: adb shell settings put global http_proxy :0 (или "Нет" в настройках Wi-Fi).
- Снимите проброс: adb reverse --remove tcp:8080 или сразу все: adb reverse --remove-all.
- Учтите, что при отключении кабеля пробросы сбрасываются автоматически, а вот настройка прокси на телефоне остается. Если забыть ее убрать, телефон без кабеля останется без интернета. Именно так выглядит самая частая жалоба новичков: "телефон не грузит ничего".
Совет: Напишите себе шпаргалку из трех строк: adb reverse tcp:8080 tcp:8080, adb shell settings put global http_proxy 127.0.0.1:8080, adb shell settings put global http_proxy :0. Этих трех команд достаточно для 90 процентов рабочих ситуаций с реальным устройством.
Проверка: Отключите на компьютере Wi-Fi или используйте телефон в сети, из которой компьютер недоступен. Выполните adb reverse, установите прокси 127.0.0.1:8080, откройте mitm.it в Chrome на телефоне. Страница загрузки сертификата открылась — проброс работает. Затем откройте тестовое приложение и убедитесь, что его запросы появляются в прокси.
Возможные проблемы
- adb reverse выдает "error: closed" или "more than one device". Подключено несколько устройств; укажите -s серийный_номер. Или устройство перешло в offline — переподключите кабель.
- Проброс есть, но mitm.it не открывается. Проверьте, что прокси на компьютере слушает именно на 127.0.0.1 или на всех интерфейсах, а не только на внешнем IP. У mitmproxy по умолчанию все интерфейсы. У Charles тоже.
- После переподключения кабеля трафик пропал. adb reverse сбрасывается при каждом переподключении. Выполните команду еще раз. Настройка прокси на телефоне при этом сохраняется.
Шаг 6: Перехватываем и подменяем трафик тестового стенда
Цель этапа: вы умеете фильтровать запросы к стенду, читать тела запросов и ответов, останавливать запрос на паузу и подменять ответ сервера, эмулировать ошибки и медленную сеть, а также направлять приложение на локальный бэкенд через adb reverse.
Фильтруем только нужное
Приложение шлет десятки фоновых запросов: аналитика, обновление конфигов, проверка версии. Чтобы не утонуть, настройте фильтр по домену стенда.
- В mitmweb в верхнем поле фильтра введите выражение вида ~d api-stage.example-team.ru — останутся только запросы к этому домену. Выражение ~u /orders отфильтрует по части URL, ~c 500 покажет только ответы с кодом 500, а ~m POST — только POST-запросы. Выражения можно объединять через пробел.
- В Charles включите режим Focus: правой кнопкой на хосте стенда → Focus. Остальные хосты свернутся в группу Other Hosts. Дополнительно в нижнем поле Filter можно ввести часть URL.
Читаем запрос и ответ так, чтобы приложить к багу
- Кликните на строку запроса. В mitmweb справа появятся вкладки Request, Response, Detail. В Charles — вкладки Overview, Contents, Summary и внизу переключатели Headers, JSON Text, Raw.
- Скопируйте URL, метод, код ответа и тело ответа в JSON. В mitmweb можно нажать на запрос правой кнопкой и выбрать Export → curl: получится команда, которую разработчик воспроизведет у себя за секунду. В Charles аналогично: правая кнопка → Copy cURL Request.
- Хороший баг-репорт о сетевой ошибке всегда содержит: шаги, URL с методом, код и тело ответа, время запроса (чтобы найти в серверных логах) и идентификатор запроса из заголовков, если бэкенд его возвращает (часто X-Request-Id).
Ставим запрос на паузу и меняем ответ
Классический сценарий: нужно проверить, как приложение отобразит корзину с сотней товаров или отрицательную цену, а на стенде таких данных нет. Подменяем ответ.
- В mitmweb в поле Intercept введите фильтр, например ~u /cart. Теперь все запросы с этим URL будут останавливаться. Выполните действие в приложении. Запрос появится с пометкой intercepted. Кликните на него, нажмите Resume после того, как отредактируете ответ во вкладке Response (значок карандаша). Приложение получит измененные данные.
- В Charles включите Breakpoints: правой кнопкой на запрос → Breakpoints. При следующем таком запросе откроется окно с двумя фазами: сначала Edit Request, затем Edit Response. Измените JSON во вкладке Response и нажмите Execute.
- Учтите, что у приложений есть таймаут, обычно 10-30 секунд. Если вы будете редактировать ответ дольше, приложение покажет ошибку сети, а не ваши данные. Готовьте JSON заранее в текстовом редакторе и вставляйте целиком.
Постоянная подмена ответа: Map Local
Если сценарий повторяется, ручные паузы неудобны. В Charles есть Tools → Map Local: указываете URL и локальный файл с JSON, и каждый такой запрос будет получать содержимое файла вместо ответа стенда. В mitmproxy аналог — опция map_local с указанием шаблона URL и пути к файлу, а также небольшие скрипты на Python с функцией response, которая может менять любые поля. Например, скрипт из пяти строк способен во всех ответах стенда заменять значение поля balance на нужное вам число.
Эмулируем ошибки сервера
Как приложение ведет себя при 500, 401 или пустом ответе? Проверить на стенде сложно, а через прокси — легко. В Charles: Tools → Rewrite → добавьте правило для URL стенда с типом Response Status и значением 500. В mitmproxy: в режиме перехвата поменяйте код статуса в редакторе ответа, либо используйте скрипт с flow.response.status_code = 500. Проверьте, что приложение показывает понятную ошибку, а не крашится и не зависает на бесконечном лоадере.
Эмулируем медленную сеть
В Charles включите Proxy → Throttle Settings, выберите пресет 3G или задайте свои значения: полоса пропускания, задержка, процент потерь. Не забудьте ограничить Throttle только хостом стенда, иначе замедлятся и остальные соединения. Тестируйте загрузку списков, отмену запросов при уходе с экрана и поведение при таймауте. Эмулятор Android также умеет ограничивать сеть: Extended Controls → Cellular → Network type, но прокси дает более тонкий контроль.
Направляем приложение на локальный бэкенд
Частая задача: разработчик поднял сервер на своем ноутбуке на порту 3000 и просит проверить фичу до выкатки на стенд. Приложение на реальном телефоне не видит его localhost. Решение — все тот же adb reverse:
adb reverse tcp:3000 tcp:3000Теперь в приложении (через скрытое меню выбора окружения или настройку base URL в QA-сборке) укажите адрес http://localhost:3000, и запросы уйдут на компьютер. Если одновременно нужен перехват, оставьте прокси включенным: mitmproxy увидит запросы к localhost:3000 как обычные. На эмуляторе вместо adb reverse можно просто использовать адрес http://10.0.2.2:3000.
Совет: Сохраняйте сессии. В Charles — File → Save Session, в mitmproxy — команда mitmdump -w session.mitm или кнопка сохранения в mitmweb. Файл сессии с воспроизведением бага ценнее любого описания: разработчик откроет его и увидит все запросы в том же порядке, в каком они шли у вас.
Проверка: Вы можете: показать только запросы к стенду; скопировать любой запрос как curl; остановить запрос и вернуть приложению измененный JSON, который отобразится на экране; заставить приложение получить код 500 и увидеть его реакцию; замедлить сеть и увидеть индикатор загрузки. Если все пять пунктов получились — вы освоили прокси на уровне уверенного пользователя.
Проверка результата: итоговый чек-лист
Пройдите по списку и отметьте каждый пункт. Все они должны быть выполнены — тогда окружение полностью готово к ежедневной работе.
Прокси на компьютере
- mitmweb или Charles запускается без ошибок и слушает свой порт.
- Команда curl -x http://127.0.0.1:8080 -k https://example.com отображает запрос в интерфейсе.
- Файл корневого сертификата найден и вы знаете, где он лежит.
Эмулятор
- adb devices показывает эмулятор со статусом device.
- adb shell settings get global http_proxy возвращает 10.0.2.2:8080 или в панели Extended Controls статус Success.
- Chrome в эмуляторе открывает HTTPS-сайты без предупреждений.
- Сертификат виден во вкладке Пользователь в настройках безопасности.
- Тестовое приложение работает, его запросы к стенду видны с расшифрованными телами.
Реальное устройство
- Отладка по USB включена, adb devices видит телефон.
- По Wi-Fi: прокси на IP компьютера, mitm.it открывается, запросы приложения видны.
- По USB: adb reverse --list показывает tcp:8080, прокси 127.0.0.1:8080 задан, mitm.it открывается при отключенном Wi-Fi компьютера.
- Вы умеете отключать прокси и проброс, и после отключения телефон нормально выходит в интернет.
Работа со стендом
- Настроен фильтр по домену стенда.
- Выполнена хотя бы одна подмена ответа через паузу или Map Local.
- Проверена реакция приложения на код 500.
- Сохранена сессия с примером трафика.
Тестовый сценарий для самопроверки
- Запустите прокси, эмулятор и включите прокси на эмуляторе.
- Откройте приложение, авторизуйтесь, откройте любой список данных.
- Найдите в прокси запрос, который вернул этот список. Поставьте перехват на его URL.
- Обновите список в приложении, в остановленном ответе удалите половину элементов, отпустите.
- На экране приложения должно отобразиться меньше элементов. Если да — окружение полностью рабочее.
Типичные ошибки и решения
Проблема 1: приложение показывает ошибку сети, а браузер работает
Причина: приложение не доверяет пользовательскому сертификату (поведение Android 7+ по умолчанию) либо включен certificate pinning. Решение: запросите debug-сборку с network_security_config и блоком debug-overrides, либо QA-сборку с отключенным pinning для стенда. Как временный вариант на эмуляторе Google APIs — системный сертификат. Проверить причину помогает adb logcat с фильтром по слову Trust или pinning.
Проблема 2: запросов вообще нет, хотя прокси задан
Причина: приложение использует сетевую библиотеку, игнорирующую системный прокси. Так ведут себя приложения на Flutter (клиент dart:io), некоторые сборки React Native и приложения на gRPC. Решение: для Flutter разработчик добавляет в debug-сборку поддержку системного прокси через пакет для чтения настроек прокси или явно задает findProxy на 10.0.2.2:8080 в отладочном режиме. Это стандартная просьба, разработчики Flutter ее знают. Альтернатива — режим прозрачного прокси, но он сложнее и здесь не рассматривается.
Проблема 3: телефон без интернета после тестирования
Причина: прокси остался в настройках Wi-Fi или в глобальной настройке http_proxy, а прокси-сервер выключен или кабель отключен. Решение: adb shell settings put global http_proxy :0, а в настройках Wi-Fi поставить прокси в положение "Нет". Добавьте это действие в конец своего рабочего ритуала.
Проблема 4: adb не видит устройство
Причина: кабель только для зарядки, не подтвержден запрос отладки, на Windows не установлен драйвер, устройство в режиме "Только зарядка" вместо "Передача файлов". Решение: смените кабель, проверьте экран телефона, переключите режим USB в шторке уведомлений на "Передача файлов", на Windows установите Google USB Driver через SDK Manager или драйвер производителя. Помогает также adb kill-server и затем adb start-server.
Проблема 5: Charles показывает только CONNECT без содержимого
Причина: не включен SSL Proxying или домен не добавлен в Include. Решение: Proxy → SSL Proxying Settings → Enable → Add хост * порт 443. После включения переоткройте приложение: уже установленные соединения не расшифруются задним числом.
Проблема 6: в панели эмулятора Proxy status: Error
Причина: прокси на компьютере не запущен или порт другой. Иногда — Android Studio перехватывает настройки собственным прокси. Решение: запустите прокси, снимите галочку использования настроек Android Studio, нажмите Apply повторно. Если не помогает — задайте прокси через adb командой с адресом 10.0.2.2.
Проблема 7: mitm.it не открывается, но остальной интернет работает
Причина: трафик идет мимо прокси. На реальном устройстве по Wi-Fi часто виновата изоляция клиентов в сети. Решение: проверьте ping до телефона с компьютера. Нет ответа — переходите на adb reverse. Есть ответ — проверьте брандмауэр и порт.
Проблема 8: после обновления Android Studio сертификат пропал
Причина: вы сделали Wipe Data эмулятора или пересоздали его. Решение: пользовательский сертификат ставится за минуту через mitm.it. Чтобы не терять состояние, используйте снимки эмулятора (Snapshots в Extended Controls): сохраните снимок после установки сертификата и приложения.
Проблема 9: несколько устройств и команды применяются не туда
Причина: adb без флага -s при двух и более подключенных устройствах отказывается работать или работает с неожиданным. Решение: всегда используйте adb -s серийный_номер, а серийные номера смотрите через adb devices. Можно задать переменную окружения ANDROID_SERIAL с нужным номером.
Дополнительные возможности для продвинутых тестировщиков
iOS-симулятор и реальный iPhone
Логика та же, инструменты другие. iOS-симулятор использует сетевые настройки macOS, поэтому прокси задается в системных настройках Сети на Mac, а сертификат перетаскивается в окно симулятора и включается в Настройки → Основные → Об этом устройстве → Доверие сертификатам. На реальном iPhone прокси задается в свойствах Wi-Fi, сертификат скачивается через mitm.it и активируется по тому же пути с доверием. Аналога adb reverse для iPhone по USB нет; в закрытых сетях используют раздачу интернета с Mac по кабелю.
Автоматизация с mitmdump и скриптами
mitmdump работает без интерфейса и принимает скрипты на Python. Пример задачи: во всех ответах стенда подменять поле feature_flags, чтобы включить экспериментальную функцию без доступа к админке. Скрипт запускается флагом -s script.py, а трафик пишется в файл флагом -w. Такие скрипты удобно хранить в репозитории тестов рядом с автотестами.
Интеграция с Appium и автотестами
В автотестах прокси включается перед запуском сессии: настройка через adb, затем проверка утверждений не только по UI, но и по трафику. Например, тест нажимает кнопку "Оплатить" и проверяет, что в mitmproxy появился POST на /payments с нужной суммой. Это ловит баги, которые UI не показывает: дублирование запросов, отправку лишних полей, неверный формат дат.
Проверка аналитики и трекинга
Прокси незаменим для тестирования событий аналитики: вы видите, какие события и с какими параметрами приложение отправляет при каждом действии. Фильтр по домену системы аналитики и колонка с телом запроса заменяют долгие ожидания появления событий в дашбордах.
Несколько эмуляторов с разными прокси
Если нужно сравнить поведение при разных ответах стенда, запустите два прокси на портах 8080 и 8090 и два эмулятора, каждый со своим прокси через adb -s. Так удобно проверять A/B-варианты: один эмулятор получает подмененный ответ через Map Local, второй — оригинальный.
Снимки эмулятора как чистое окружение
После настройки прокси, сертификата и приложения сохраните снимок эмулятора. Перед каждым тестовым прогоном загружайте его — и вы получаете идентичное окружение за секунды, без повторной установки.
Разделение окружений и безопасность
Держите отдельные профили Charles или конфигурации mitmproxy для разных проектов. Не включайте перехват всего трафика на компьютере системно — только трафик устройств. И периодически проверяйте, что на тестовых устройствах нет личных учетных записей, ведь весь их трафик виден в прокси.
FAQ: частые вопросы по настройке прокси в мобильном тестировании
Чем отличается adb reverse от adb forward?
adb reverse делает порт на устройстве ведущим на компьютер: приложение на телефоне обращается к localhost и попадает на ПК. adb forward — наоборот: порт компьютера ведет на устройство, так подключаются, например, к отладчику или веб-серверу внутри телефона. Для прокси и локального бэкенда нужен именно reverse.
Обязательно ли устанавливать сертификат, если меня интересуют только URL запросов?
Нет. Без сертификата вы увидите хосты и CONNECT-запросы, но не пути, параметры и тела. Однако приложение при этом будет получать ошибки TLS, так что нормально протестировать его не получится. На практике сертификат ставят всегда.
Почему на эмуляторе адрес компьютера 10.0.2.2, а в панели Extended Controls нужно писать 127.0.0.1?
Панель эмулятора применяет прокси на стороне хост-машины, поэтому там адрес компьютера — это 127.0.0.1. А команда adb shell выполняется внутри Android, где 127.0.0.1 — сам эмулятор, а компьютер доступен по 10.0.2.2. Запомните правило: внутри Android — 10.0.2.2, снаружи — 127.0.0.1.
Можно ли использовать прокси на устройстве без root?
Да. Все, что описано в гайде, кроме установки системного сертификата, работает без root. Ключевое условие — debug-сборка приложения, доверяющая пользовательским сертификатам.
Что делать, если приложение перестало работать через прокси после обновления сборки?
Скорее всего, разработчики включили pinning или убрали debug-overrides. Проверьте adb logcat на ошибки сертификатов и уточните у команды, что изменилось в конфигурации сети. Часто это происходит при переходе на новую библиотеку HTTP-клиента.
Как проверить приложение через прокси при использовании мобильного интернета, а не Wi-Fi?
Используйте adb reverse по USB и глобальную настройку http_proxy 127.0.0.1:8080. На большинстве устройств прокси применится и к мобильным данным. Если нет — тестируйте по Wi-Fi, а сценарии переключения сетей проверяйте отдельно без прокси.
Можно ли перехватывать трафик продакшен-версии из магазина?
Технически релизные сборки не доверяют пользовательским сертификатам и часто содержат pinning, поэтому без модификаций это не работает. И это правильно: защита пользователей важнее удобства тестировщика. Все проверки делайте на тестовых сборках и стенде.
Как понять, что запрос ушел из приложения, а не из фонового сервиса или браузера?
В Charles есть колонка Client Process на macOS, а на устройстве информация о процессе не передается. Практический прием: закройте все другие приложения, отфильтруйте по домену стенда и воспроизводите действие точечно. В спорных случаях смотрите заголовок User-Agent — приложения обычно подставляют свое название и версию.
Как сохранить трафик и передать разработчику?
В Charles — File → Save Session As в формате .chls или Export в формате HAR. В mitmproxy — флаг -w для записи или сохранение из веб-интерфейса. HAR читается почти любым инструментом, включая вкладку Network в браузерных инструментах разработчика.
Сколько времени занимает ежедневная настройка после первого раза?
Запуск прокси, эмулятора из снимка и включение прокси через adb — около минуты. Реальное устройство по USB — две команды и десять секунд. Настройка сертификата повторяется только после сброса устройства.
Заключение
Давайте подведем итог. Вы подняли перехватывающий прокси на компьютере и убедились, что он видит трафик. Направили в него Android-эмулятор тремя разными способами и разобрались с адресами 127.0.0.1 и 10.0.2.2. Установили корневой сертификат и поняли, почему приложение может ему не доверять и что именно просить у разработчиков. Подключили реальное устройство по Wi-Fi, столкнулись с ограничениями офисных сетей и решили их пробросом порта через adb reverse. Научились фильтровать трафик стенда, ставить запросы на паузу, подменять ответы, эмулировать ошибки сервера и медленную сеть, а также направлять приложение на локальный бэкенд коллеги.
Это тот набор навыков, который отличает тестировщика мобильных приложений, способного находить и локализовывать сетевые баги самостоятельно. Ваши баг-репорты станут точнее, а разработчики будут благодарны за готовые curl-команды и файлы сессий.
Что делать дальше
- Повторите настройку на своем рабочем проекте, добейтесь появления расшифрованных запросов к стенду.
- Составьте личную шпаргалку из команд adb и сохраните снимок эмулятора с готовым окружением.
- Проведите один полный тестовый цикл фичи с открытым прокси и посчитайте, сколько багов нашлось благодаря видимости трафика.
Куда развиваться
Следующий уровень — скрипты для mitmproxy на Python, которые подменяют ответы автоматически, интеграция проверок трафика в автотесты на Appium и тестирование API стенда напрямую через Postman или curl параллельно с мобильным клиентом. Полезно изучить основы TLS и структуру сертификатов, чтобы уверенно говорить с разработчиками о pinning и конфигурации сетевой безопасности. И обязательно освойте iOS-часть: команды, которые тестируют оба клиента, ценят специалистов, одинаково уверенно чувствующих себя на обеих платформах. У вас все получится — вы уже сделали самое сложное.