Команда adb connect возвращает ошибку «connection refused», хотя телефон и компьютер подключены к одной сети — типичная ситуация при первой настройке отладки по Wi-Fi. Причина чаще всего кроется в том, что беспроводная отладка не активирована на устройстве, либо порт ADB не прослушивается. Без кабеля отлаживать приложения удобнее: устройство остаётся на зарядке или в док-станции, а разработчик свободно перемещается по комнате.
Отладка по Wi-Fi — это способ подключения инструментов разработчика (прежде всего ADB — Android Debug Bridge) к смартфону или планшету через локальную сеть вместо USB-кабеля. В этой статье разберём, как включить беспроводную отладку на современных версиях Android, как выполнить сопряжение и подключение, какие ошибки встречаются чаще всего и как их устранить безопасными методами.
Что такое отладка по Wi-Fi и когда она нужна
Беспроводная отладка позволяет устанавливать приложения, снимать логи через adb logcat, выполнять команды оболочки и профилировать производительность без физического подключения устройства. Это особенно полезно, когда USB-порт занят, кабель неисправен или тестируется сценарий работы устройства в движении — например, поведение приложения при слабом сигнале.
Начиная с Android 11, в систему встроена штатная функция «Беспроводная отладка» (Wireless debugging) с сопряжением по QR-коду или коду из шести цифр. На более ранних версиях Android требовалось первичное подключение по USB для перевода демона adbd в сетевой режим командой adb tcpip. Учитывайте версию системы: процедура для Android 10 и ниже отличается от современной.
Кроме мобильной разработки, отладка по сети применяется во встраиваемых системах и IoT-устройствах, где физический доступ к плате затруднён. Принцип тот же: отладочный агент на устройстве слушает сетевой порт, а инструменты на компьютере подключаются к нему по TCP/IP.
Подготовка: что нужно проверить перед настройкой
Прежде чем включать беспроводную отладку, убедитесь, что выполнены базовые условия. Их несоблюдение — самая частая причина неудачного подключения.
- 📶 Оба устройства подключены к одной и той же Wi-Fi сети (один роутер, один диапазон предпочтительно)
- 🔓 На роутере отключена изоляция клиентов (AP Isolation / Client Isolation), иначе устройства не видят друг друга
- 🛠️ На компьютере установлены Android SDK Platform-Tools актуальной версии
- 🔋 Смартфон достаточно заряжен — при разряде беспроводная отладка может отключаться системой
- 🚫 VPN на телефоне или компьютере временно отключён, так как он меняет маршрутизацию трафика
Проверьте также, что компьютер «видит» телефон в сети. Узнайте IP-адрес смартфона в настройках Wi-Fi (обычно путь Настройки → Wi-Fi → сведения о сети) и выполните с компьютера команду:
ping 192.168.1.45Подставьте реальный адрес вашего устройства. Если пакеты не проходят — проблема на уровне сети, а не ADB, и настраивать отладку пока бессмысленно.
Включение беспроводной отладки на Android 11 и новее
Сначала активируйте режим разработчика. Откройте Настройки → О телефоне и несколько раз нажмите на пункт «Номер сборки» до появления сообщения о том, что вы стали разработчиком. Точное название пункта может отличаться в зависимости от оболочки производителя — сверьтесь с документацией вашей модели, если пункт не находится.
Затем перейдите в Настройки → Система → Для разработчиков и включите переключатель «Беспроводная отладка». Система может показать предупреждение о безопасности — подтвердите действие, находясь в доверенной домашней сети.
☑️ Включение беспроводной отладки
Сопряжение по коду
В разделе беспроводной отладки нажмите «Сопряжение устройства с кодом». На экране появятся код из шести цифр, IP-адрес и порт сопряжения. На компьютере выполните:
adb pair 192.168.1.45:37129Введите код с экрана телефона. Обратите внимание: порт сопряжения и порт подключения — разные. После успешного сопряжения посмотрите порт подключения на главном экране раздела «Беспроводная отладка» и выполните:
adb connect 192.168.1.45:40377Проверьте результат командой adb devices — устройство должно отображаться со статусом device. Если статус unauthorized, подтвердите запрос на отладку на экране смартфона.
⚠️ Внимание: порт беспроводной отладки на Android 11+ генерируется случайно при каждом включении функции. Не сохраняйте старые команды подключения в скрипты без проверки актуального порта — это частая причина ошибки «connection refused».
Отладка по Wi-Fi на Android 10 и старше
На старых версиях системы штатной беспроводной отладки нет, поэтому первичная настройка выполняется через USB-кабель. Подключите устройство к компьютеру, убедитесь, что adb devices его видит, и переведите демон в сетевой режим:
adb tcpip 5555После этого кабель можно отключить и подключиться по сети:
adb connect 192.168.1.45:5555Порт 5555 — стандартный для этого режима. Учтите ограничение: после перезагрузки смартфона сетевой режим сбрасывается, и процедуру с кабелем придётся повторить. Это нормальное поведение системы, а не неисправность.
Типичные ошибки и их устранение
Даже при правильной настройке беспроводное подключение иногда обрывается или не устанавливается. Ниже — наиболее распространённые симптомы и безопасные способы диагностики.
| Ошибка | Вероятная причина | Что проверить |
|---|---|---|
| connection refused | Неверный порт или отладка выключена | Актуальный порт в разделе «Беспроводная отладка» |
| connection timed out | Устройства в разных сетях или изоляция клиентов | SSID сети, настройки роутера, ping до телефона |
| unauthorized | Не подтверждён запрос на отладку | Диалог разрешения на экране телефона, отзыв старых ключей |
| offline | Завис сеанс ADB | Перезапуск сервера: adb kill-server, затем adb start-server |
| failed to pair | Истёк код сопряжения или неверный порт | Новый код сопряжения на телефоне, точность ввода порта |
Если подключение периодически обрывается, возможная причина — энергосбережение Wi-Fi на смартфоне. Проверьте в настройках Wi-Fi пункт вроде «Не отключать Wi-Fi в спящем режиме», если он предусмотрен вашей прошивкой. Также нестабильность вызывает слабый сигнал или перегруженная сеть: попробуйте диапазон 5 ГГц, если роутер его поддерживает.
Когда ничего не помогает, сбросьте состояние с двух сторон: отключите и заново включите беспроводную отладку на телефоне, а на компьютере перезапустите ADB-сервер. В разделе для разработчиков есть пункт «Отозвать доступ для отладки по USB» (название может отличаться) — он очищает сохранённые ключи авторизации, после чего сопряжение выполняется заново.
⚠️ Внимание: не включайте беспроводную отладку в общедоступных сетях (кафе, аэропорты). Открытый порт ADB без авторизации — реальный вектор атаки. Используйте функцию только в доверенной домашней или рабочей сети и выключайте её после завершения работы.
Как узнать, какие устройства подключены к ADB
Выполните команду adb devices -l — она покажет список подключённых устройств с указанием способа подключения (USB или сетевой адрес с портом), модели и статуса. Если устройство отображается дважды (по кабелю и по сети), указывайте конкретное через флаг -s с серийным номером или адресом.
Безопасность при беспроводной отладке
ADB предоставляет практически полный контроль над устройством: установку и удаление приложений, чтение логов, выполнение команд оболочки. Поэтому беспроводной режим требует осознанного подхода к безопасности.
- 🔒 Включайте отладку только на время работы и выключайте сразу после
- 🏠 Используйте функцию только в сетях, которым доверяете
- 🔑 Не подтверждайте запросы на авторизацию, если не инициировали подключение сами
- 🧹 Периодически отзывайте старые ключи отладки в настройках разработчика
На Android 11 и новее система дополнительно защищает соединение: сопряжение требует одноразового кода, а соединение шифруется. На старых версиях с ручным режимом adb tcpip такой защиты нет — там порт 5555 открыт для всей локальной сети, поэтому завершайте сеанс командой adb usb, возвращающей демон в USB-режим.
Альтернативные сценарии: эмуляторы и IoT
Отладка по сети применима не только к физическим смартфонам. Эмуляторы Android подключаются к ADB через локальный порт автоматически, а для встраиваемых устройств на базе Linux нередко используется связка gdbserver на устройстве и GDB на компьютере — принцип аналогичен: агент слушает TCP-порт, отладчик подключается по сети.
Для устройств без экрана (платы, телевизионные приставки, умные колонки) сетевой режим часто оказывается единственным способом отладки. Порядок включения зависит от конкретной прошивки — ищите раздел для разработчиков в настройках устройства или сверяйтесь с документацией производителя, поскольку универсальной процедуры здесь не существует.
Часто задаваемые вопросы
Почему порт беспроводной отладки каждый раз разный?
Это штатное поведение Android 11 и новее: при каждом включении функции система выбирает случайный свободный порт в целях безопасности. Актуальный порт всегда отображается в разделе «Беспроводная отладка» в настройках разработчика.
Можно ли отлаживать по Wi-Fi вообще без USB-кабеля?
На Android 11 и новее — да, сопряжение выполняется полностью по сети через код или QR-код. На Android 10 и старше первичный перевод в сетевой режим требует однократного подключения по кабелю.
Работает ли беспроводная отладка через мобильный интернет?
Нет, стандартный механизм рассчитан на локальную сеть. Теоретически возможны обходные варианты с VPN-туннелями, но они небезопасны и не рекомендуются. Для удалённой отладки используйте специализированные инструменты с шифрованием.
Что делать, если устройство пропадает из списка adb devices?
Проверьте, не выключилась ли беспроводная отладка из-за блокировки экрана или экономии заряда. Затем перезапустите ADB-сервер командами adb kill-server и adb start-server и подключитесь заново с актуальным портом.
Влияет ли отладка по Wi-Fi на скорость работы приложения?
Само по себе подключение ADB практически не нагружает устройство, однако активная запись логов через adb logcat и профилирование создают дополнительную нагрузку. Для замеров производительности учитывайте этот фактор и по возможности тестируйте без активного отладочного сеанса.