ADB pelo Wi-Fi: conecte o Android sem cabo

Para usar o ADB pelo Wi-Fi, conecte o celular por USB uma vez, rode adb tcpip 5555, tire o cabo e rode adb connect <ip-do-celular>:5555. O computador e o celular precisam estar na mesma rede. O Android 11 em diante também tem a Depuração por Wi-Fi integrada, que usa um código de pareamento e dispensa o cabo.

Antes de começar

• A Depuração USB precisa estar ativada no celular. Veja como ativar a Depuração USB se ainda não fez isso.
• O computador e o celular precisam estar na mesma rede local. Redes de convidados e alguns Wi-Fi públicos bloqueiam o tráfego entre aparelhos.
• Você precisa do Android platform-tools (adb) no computador para o método por linha de comando.

Método 1: o clássico (adb tcpip)

Funciona em qualquer versão do Android com Depuração USB.

1. Conecte o celular com um cabo USB e confirme que ele está autorizado:

adb devices

1. Mude o daemon ADB do aparelho para o modo TCP/IP na porta 5555:

adb tcpip 5555

Deve aparecer restarting in TCP mode port: 5555.

1. Descubra o endereço IP do celular (veja a próxima seção).
2. Tire o cabo e conecte pela rede:

adb connect 192.168.1.42:5555

Troque pelo endereço do seu celular. Se der certo, aparece connected to 192.168.1.42:5555.

1. Confira:

adb devices

Agora o aparelho aparece como 192.168.1.42:5555. Todos os comandos de sempre funcionam como se ele estivesse no cabo.

Para desconectar, rode adb disconnect 192.168.1.42:5555. O modo TCP não é permanente: ele volta ao normal quando o celular reinicia.

Como descobrir o IP do celular

• No Android puro: Configurações > Sobre o telefone > Informações de status (ou Status) e procure Endereço IP. Outra opção é abrir os detalhes da rede Wi-Fi conectada em Configurações > Rede e Internet > Internet.
• Pelo computador, com o celular ligado por USB:

adb shell ip route

O endereço depois de src na linha wlan0 é o IP do celular.

Os nomes dos menus mudam de uma marca para outra, mas o endereço IP sempre aparece em algum lugar nos detalhes da rede Wi-Fi ou na página de status do celular.

Método 2: Depuração por Wi-Fi (Android 11 em diante)

O Android 11 trouxe um modo com pareamento que não precisa de cabo.

1. Abra Configurações > Sistema > Opções do desenvolvedor e ative Depuração por Wi-Fi (o celular precisa estar no Wi-Fi). Em alguns aparelhos, como os Samsung, o nome é Depuração sem fio.
2. Toque em Depuração por Wi-Fi e depois em Parear o dispositivo com um código de pareamento. O celular mostra um endereço IP, uma porta e um código de seis dígitos.
3. No computador, faça o pareamento usando essa porta de pareamento:

adb pair 192.168.1.42:37123

Digite o código de seis dígitos quando for pedido.

1. De volta à tela principal da Depuração por Wi-Fi, anote o endereço IP e a porta mostrados ali (é uma porta diferente da de pareamento) e conecte:

adb connect 192.168.1.42:41567

A porta muda, então talvez você precise conferir de novo sempre que a opção for desligada e ligada.

Segurança: leia antes de deixar ligado

Atenção: uma porta de ADB por TCP aberta pode ser acessada por qualquer pessoa na mesma rede, e um atacante que chegue nela pode tentar falar com o seu celular. Use só em redes de confiança, como a de casa ou do escritório, nunca em Wi-Fi público.

O Android continua pedindo a autorização da chave RSA na primeira vez que um computador conecta, o que é uma proteção, mas não conte só com ela. Quando terminar:

adb usb

Isso volta o aparelho para o modo USB. Reiniciar o celular também desfaz o modo TCP clássico, e você pode desligar a Depuração por Wi-Fi em Opções do desenvolvedor.

Usando o ADB pelo Wi-Fi no ADBKit

Um navegador não consegue abrir conexões TCP diretas, então sozinho ele não alcança a porta 5555. O ADBKit resolve isso com o agente do ADBKit, um programa pequeno que roda no seu computador e repassa o tráfego. A configuração completa, as opções e a solução de problemas estão na referência do agente do ADBKit.

1. Inicie o agente com o instalador de uma linha (no macOS e no Linux, curl -fsSL https://adbkit.com/install.sh | sh. No Windows PowerShell, irm https://adbkit.com/install.ps1 | iex). Se você já tem Node.js, pode baixar o adbkit-bridge.mjs e rodar node adbkit-bridge.mjs.

1. Conecte o celular por USB no espaço de trabalho do ADBKit e abra a janela Wi-Fi.
2. Clique em Turn on Wi-Fi debugging. O ADBKit roda adb tcpip 5555 para você e mostra o endereço do celular.
3. Conecte digitando o endereço IP (porta 5555) ou use Scan network para encontrar aparelhos.

O agente escuta apenas em 127.0.0.1, só responde a páginas do ADBKit e só conecta a endereços de rede privados, então não é um proxy aberto de uso geral.

Observação: o ADBKit aceita os dois métodos. O clássico adb tcpip 5555 funciona com qualquer versão do agente. O pareamento por código da Depuração por Wi-Fi do Android 11+ (adb pair) funciona pelo agente em Go que o instalador configura. A edição em Node não faz pareamento. Siga Conecte o Android com a Depuração por Wi-Fi pelo navegador para ver os passos, ou adb tcpip vs Depuração por Wi-Fi para escolher um método.

Solução de problemas

• failed to connect ou tempo esgotado. Confirme que os dois aparelhos estão na mesma rede e que o IP está atualizado, já que o roteador pode trocá-lo. Algumas redes isolam os clientes entre si.
• unauthorized depois de conectar. Desbloqueie o celular e aceite o aviso de depuração. Se continuar falhando, revogue as autorizações em Opções do desenvolvedor e tente de novo.
• A conexão cai. Configurações de suspensão do Wi-Fi e sinal fraco interrompem a sessão. Reconecte com adb connect.
• O aparelho está ocupado. Só um programa pode usar uma conexão por vez. Veja como resolver os erros device busy ou unauthorized do ADB.

Se quiser entender por que o navegador precisa de um auxiliar para TCP enquanto o USB funciona direto, leia o que é WebADB.