ADB por Wi-Fi: conecta tu Android sin cable

Para usar ADB por Wi-Fi, conecta el celular por USB una vez, ejecuta adb tcpip 5555, desconecta el cable y luego ejecuta adb connect <ip-del-celular>:5555. La computadora y el celular tienen que estar en la misma red. Android 11 y versiones posteriores también traen la Depuración inalámbrica, que usa un código de vinculación y no necesita cable en ningún momento.

Antes de empezar

• La Depuración USB tiene que estar activada en el celular. Si todavía no lo hiciste, consulta cómo activar la Depuración USB.
• La computadora y el celular tienen que estar en la misma red local. Las redes de invitados y algunas Wi-Fi públicas bloquean el tráfico entre dispositivos.
• Para el método por línea de comandos necesitas Android platform-tools (adb) en tu computadora.

Método 1: el método clásico (adb tcpip)

Funciona en cualquier versión de Android con Depuración USB.

1. Conecta el celular con un cable USB y confirma que está autorizado:

adb devices

1. Cambia el daemon ADB del dispositivo a modo TCP/IP en el puerto 5555:

adb tcpip 5555

Deberías ver restarting in TCP mode port: 5555.

1. Busca la dirección IP del celular (mira la siguiente sección).
2. Desconecta el cable y conéctate por la red:

adb connect 192.168.1.42:5555

Cambia la dirección por la de tu celular. Si todo sale bien verás connected to 192.168.1.42:5555.

1. Compruébalo:

adb devices

Ahora el dispositivo aparece como 192.168.1.42:5555. Todos los comandos de siempre funcionan igual que si estuviera conectado por cable.

Para desconectarte, ejecuta adb disconnect 192.168.1.42:5555. El modo TCP no es permanente y se apaga cuando el celular se reinicia.

Cómo encontrar la dirección IP del celular

• En Android puro: Ajustes › Acerca del teléfono › Información de estado (o Estado) y busca Dirección IP. También puedes abrir los detalles de la red Wi-Fi conectada en Ajustes › Redes e Internet › Internet.
• Desde la computadora, con el celular conectado por USB:

adb shell ip route

La dirección que aparece después de src en la línea de wlan0 es la IP del celular.

Los nombres de los menús cambian según el fabricante, pero la dirección IP siempre aparece en algún lugar de los detalles de la red Wi-Fi o en la página de estado del celular.

Método 2: Depuración inalámbrica (Android 11 y posteriores)

Android 11 agregó un modo con vinculación que no necesita cable.

1. Abre Ajustes › Sistema › Opciones de desarrollador y activa Depuración inalámbrica (Wireless debugging). El celular tiene que estar conectado al Wi-Fi.
2. Toca Depuración inalámbrica y luego Vincular dispositivo con código de vinculación. El celular muestra una dirección IP, un puerto y un código de seis dígitos.
3. En la computadora, vincula usando ese puerto de vinculación:

adb pair 192.168.1.42:37123

Escribe el código de seis dígitos cuando te lo pida.

1. De vuelta en la pantalla principal de Depuración inalámbrica, anota la dirección IP y el puerto que aparecen ahí (es un puerto distinto al de vinculación) y conéctate:

adb connect 192.168.1.42:41567

El puerto cambia, así que puede que tengas que revisarlo cada vez que actives la opción.

Seguridad: lee esto antes de dejarlo activado

Advertencia: cualquier persona en la misma red puede llegar a un puerto ADB por TCP abierto, y un atacante que llegue a él puede intentar comunicarse con tu celular. Úsalo solo en redes de confianza, como la de tu casa o tu oficina, nunca en Wi-Fi públicas.

Android sigue pidiendo autorizar la clave RSA la primera vez que se conecta una computadora, lo cual es una protección, pero no deberías confiar solo en eso. Cuando termines:

adb usb

Esto regresa el dispositivo al modo USB. Reiniciar el celular también apaga el modo TCP clásico, y puedes desactivar la Depuración inalámbrica en Opciones de desarrollador.

Usar ADB por Wi-Fi en ADBKit

Un navegador web no puede abrir conexiones TCP directas, así que no puede llegar al puerto 5555 por sí solo. ADBKit lo resuelve con el agente de ADBKit, un pequeño programa que corre en tu computadora y retransmite el tráfico. La configuración completa, las opciones y la solución de problemas están en la referencia del agente de ADBKit.

1. Inicia el agente con el instalador de una sola línea (en macOS y Linux, curl -fsSL https://adbkit.com/install.sh | sh. En Windows PowerShell, irm https://adbkit.com/install.ps1 | iex). Si ya tienes Node.js, puedes descargar adbkit-bridge.mjs y ejecutar node adbkit-bridge.mjs.

1. Conecta el celular por USB en el espacio de trabajo de ADBKit y abre el diálogo Wi-Fi.
2. Presiona Turn on Wi-Fi debugging. ADBKit ejecuta adb tcpip 5555 por ti y muestra la dirección del celular.
3. Conéctate escribiendo la dirección IP (puerto 5555), o usa Scan network para buscar dispositivos.

El agente solo escucha en 127.0.0.1, solo responde a páginas de ADBKit y solo se conecta a direcciones de redes privadas, así que no es un proxy abierto de uso general.

Nota: ADBKit admite los dos métodos. El método clásico adb tcpip 5555 funciona con cualquiera de las dos versiones del agente. La vinculación con código de la Depuración inalámbrica de Android 11+ (adb pair) funciona con el agente en Go que instala el instalador. La edición para Node no puede vincular. Sigue Conectar Android con Depuración inalámbrica desde el navegador para ver los pasos, o adb tcpip vs Depuración inalámbrica para elegir un método.

Solución de problemas

• failed to connect o tiempo agotado. Confirma que los dos dispositivos están en la misma red y que la dirección IP sigue siendo la misma, porque el router puede cambiarla. Algunas redes aíslan a los clientes entre sí.
• unauthorized después de conectarte. Desbloquea el celular y acepta el aviso de depuración. Si sigue fallando, revoca las autorizaciones en Opciones de desarrollador y vuelve a intentar.
• La conexión se corta. La suspensión del Wi-Fi y la señal débil interrumpen las sesiones. Vuelve a conectarte con adb connect.
• El dispositivo está ocupado. Solo un programa a la vez puede usar una conexión. Consulta cómo solucionar los errores de dispositivo ADB ocupado o no autorizado.

Si quieres entender por qué los navegadores necesitan un ayudante para TCP mientras que USB funciona directo, lee qué es WebADB.