ADB подключение по Wi-Fi: полное руководство по настройке беспроводной отладки

Команда adb connect 192.168.1.50:5555 возвращает ошибку «unable to connect» — это самый частый симптом, с которым сталкиваются при первой попытке настроить ADB подключение по Wi-Fi. Причина обычно проста: на устройстве не включён режим беспроводной отладки, либо смартфон и компьютер находятся в разных подсетях. Разберём оба сценария и покажем рабочую настройку.

Беспроводная отладка избавляет от USB-кабеля при установке APK, снятии логов и тестировании приложений. Способ подключения зависит от версии Android: на Android 11 и новее есть штатная функция «Беспроводная отладка», а на более старых версиях сначала потребуется одно подключение по USB для активации TCP-режима.

Что нужно подготовить перед подключением

Прежде чем вводить команды, проверьте базовые условия. Без них соединение не установится независимо от правильности синтаксиса.

  • 💻 На компьютере установлен Android SDK Platform-Tools — пакет с утилитой adb, который скачивается с официального сайта разработчиков Android.
  • 📱 На смартфоне включён режим разработчика: обычно для этого нужно несколько раз нажать на пункт «Номер сборки» в разделе «О телефоне» (точный путь может отличаться в зависимости от оболочки).
  • 📡 Оба устройства подключены к одной Wi-Fi сети — и это критично: гостевые сети с изоляцией клиентов не подойдут.
  • 🔓 На телефоне активирована отладка по USB в меню разработчика — она нужна как базовое условие даже для беспроводного режима.
⚠️ Внимание: если роутер использует функцию изоляции клиентов (AP Isolation, Client Isolation), устройства в одной сети не смогут видеть друг друга. Проверьте настройки роутера, если ping до смартфона не проходит.

Подключение на Android 11 и новее: без USB-кабеля

Начиная с Android 11, в системе появилась штатная «Беспроводная отладка» (Wireless debugging). Она работает по протоколу mDNS и не требует первоначального подключения кабелем.

Откройте Настройки → Для разработчиков → Беспроводная отладка и включите переключатель. Внутри раздела есть два способа сопряжения: по QR-коду и по коду сопряжения. Для ручного подключения нажмите «Сопряжение устройства с помощью кода» — система покажет IP-адрес, порт и шестизначный код.

На компьютере выполните сопряжение:

adb pair 192.168.1.50:37109

Введите код с экрана телефона. Обратите внимание: порт для сопряжения и порт для подключения — разные. После успешного сопряжения посмотрите основной порт на странице «Беспроводная отладка» и подключитесь:

adb connect 192.168.1.50:43517

Проверить результат можно командой adb devices — в списке должно появиться устройство со статусом device, а не unauthorized или offline.

Подключение на Android 10 и старше: через первичный USB

На устройствах без штатной беспроводной отладки TCP-режим активируется командой. Для этого один раз понадобится кабель.

Подключите смартфон по USB, разрешите отладку в диалоге на экране и выполните:

adb tcpip 5555

Команда переключает демон adbd в режим прослушивания TCP-порта 5555. После этого кабель можно отключить и подключиться по сети:

adb connect 192.168.1.50:5555

IP-адрес телефона смотрите в настройках Wi-Fi, нажав на активную сеть, либо в разделе «О телефоне → Статус» — расположение зависит от оболочки. После перезагрузки устройства TCP-режим сбрасывается, и процедуру с кабелем придётся повторить.

☑️ Чек-лист подключения ADB по Wi-Fi

Выполнено: 0 / 5

Сравнение способов подключения

Выбор метода зависит от версии системы и того, есть ли под рукой кабель. Таблица поможет быстро определиться:

КритерийAndroid 11+ (беспроводная отладка)Android 10 и ниже (adb tcpip)
Нужен ли USB-кабельНетДа, один раз для активации
Порт подключенияСлучайный, меняетсяФиксированный 5555
Сохранение после перезагрузкиТребует повторного включенияСбрасывается, нужен кабель
СопряжениеПо коду или QRЧерез USB-диалог доверия
📊 Какой способ ADB по Wi-Fi вы используете?
Штатная беспроводная отладка (Android 11+)
Через adb tcpip 5555
Сторонние приложения для ADB по сети
Только подключаю по USB

Типичные ошибки и их решение

Ошибка unable to connect to ...: Connection refused означает, что порт на устройстве закрыт: либо не выполнена команда adb tcpip 5555, либо беспроводная отладка выключена. Проверьте состояние функции на телефоне и повторите активацию.

Ошибка Connection timed out указывает на сетевую проблему: устройства в разных подсетях, работает изоляция клиентов на роутере или брандмауэр компьютера блокирует исходящее соединение. Проверьте доступность телефона командой ping 192.168.1.50.

Статус unauthorized в выводе adb devices говорит о том, что на телефоне не подтверждён диалог доверия. Заблокируйте и разблокируйте экран, отзовите разрешения отладки в настройках разработчика и подключитесь заново.

⚠️ Внимание: не оставляйте TCP-порт 5555 открытым в общедоступных сетях (кафе, отели). Любой участник такой сети теоретически может попытаться подключиться к вашему устройству. Отключайте отладку после завершения работы.
Как отключить ADB по сети

Выполните adb usb — демон вернётся в USB-режим, либо выключите «Беспроводную отладку» и «Отладку по USB» в настройках разработчика. Перезагрузка устройства также сбрасывает TCP-режим.

Безопасность и ограничения метода

Беспроводная отладка даёт полный доступ к устройству — установка приложений, чтение данных, выполнение shell-команд. Поэтому включайте её только в доверенной домашней сети и отключайте сразу после работы.

Скорость передачи по Wi-Fi ниже, чем по USB, особенно при установке крупных APK. Для прошивки разделов, работы в fastboot и восстановления устройства беспроводной режим не подходит — там нужен кабель. Также учитывайте, что некоторые оболочки (например, отдельные версии MIUI или ColorOS) могут самостоятельно отключать отладку при бездействии — это штатное поведение защиты, а не сбой.

Часто задаваемые вопросы

Работает ли ADB по Wi-Fi без root-прав?

Да. Штатная беспроводная отладка на Android 11+ и метод adb tcpip 5555 работают на стоковых устройствах без root. Root требуется только некоторым сторонним приложениям, которые включают сетевой ADB без кабеля на старых версиях системы.

Почему соединение разрывается через несколько минут?

Возможные причины: энергосбережение переводит Wi-Fi модуль в сон, оболочка отключает отладку при бездействии, либо сменился порт после переподключения функции. Проверьте настройки энергосбережения для Wi-Fi и актуальный порт в меню разработчика.

Можно ли подключиться к нескольким устройствам одновременно?

Да. Выполните adb connect для каждого устройства с его IP и портом, затем выбирайте цель командой adb -s 192.168.1.50:5555 shell или через adb devices с указанием серийного номера.

Что делать, если телефон не виден в сети?

Проверьте ping до IP-адреса телефона с компьютера. Если пинга нет — устройства в разных подсетях или на роутере включена изоляция клиентов. Подключите оба устройства к одной основной сети (не гостевой) и повторите попытку.

Нужно ли платить за приложения для ADB по Wi-Fi?

Нет, встроенных средств системы достаточно. Сторонние приложения лишь автоматизируют включение TCP-режима на старых версиях Android, и многие из них требуют root. На современных устройствах они не нужны.