Introducción

Las características remotas de Level (control remoto, terminal, servicios, procesos, etc.) utilizan una conexión basada en WebRTC entre su navegador y el dispositivo de destino. Cuando esa conexión no puede ser directa, recurre a servidores de relé. Si las sesiones remotas son lentas, no se pueden conectar o ve "conectando..." indefinidamente, esta guía lo ayuda a determinar dónde está la falla.

Cómo Level establece conexiones remotas

Level intenta conectarse en este orden, deteniéndose tan pronto como uno tiene éxito:

P2P directo — su navegador se conecta directamente al dispositivo. Latencia más baja, sin intermediario.
STUN — utiliza global.stun.twilio.com para atravesar NAT y descubrir una ruta directa.
TURN sobre UDP (puerto 3478) — el tráfico se retransmite a través de global.turn.twilio.com.
TURN sobre TCP (puerto 3478) — mismo relé, TCP en lugar de UDP para cortafuegos más estrictos.
TURN sobre TLS (puerto 5349) — último recurso; relé cifrado para los entornos más restrictivos.

Todas las conexiones se inician salientes desde el navegador y el agente. No debería necesitar reglas de cortafuegos entrantes.

ℹ️ NOTA: Las conexiones de relé (TURN) agregan latencia en comparación con P2P. Si está constantemente en relé, la sesión funcionará pero puede sentirse más lenta. El objetivo de esta guía es llevarlo a P2P o al menos confirmar que el relé está funcionando correctamente.

Pruebe su conexión

Prueba de red de Twilio

Ejecute esto desde el navegador en la máquina que usa para acceder a Level (el lado técnico, no el punto final): Prueba de red de Twilio

Esto prueba si su navegador puede alcanzar los servidores STUN y TURN que utiliza Level. Si las pruebas TURN fallan aquí, las sesiones remotas fallarán o agotarán el tiempo desde su ubicación.

Prueba de hielo de Trickle

La herramienta Trickle ICE prueba si se pueden recopilar candidatos ICE válidos para una conexión WebRTC: Hielo de Trickle

Utilice estos valores:

Servidor STUN: stun:global.stun.twilio.com:3478
Servidor TURN: turn:global.turn.twilio.com:3478

Si no aparecen candidatos srflx, STUN está bloqueado. Si no aparecen candidatos relay, TURN está bloqueado. Cualquiera de los resultados significa que se necesitan cambios de cortafuegos en el lado técnico.

Causas comunes y soluciones

Las sesiones remotas no se conectan en absoluto:

El navegador del lado técnico no puede alcanzar los servidores TURN. Ejecute la prueba de red de Twilio desde su navegador para confirmar. Si falla, su red corporativa o VPN puede estar bloqueando UDP 3478 o TCP 3478 saliente.
La red del lado del agente bloquea lo mismo. Consulte los requisitos de red en Solución de problemas sin conexión y confirme que el dispositivo puede alcanzar global.turn.twilio.com saliente en 3478.

Las sesiones remotas se conectan pero son lentas o se desconectan frecuentemente:

La conexión está en relé (TURN) en lugar de P2P. Esto se espera en redes altamente enrutadas o cortafuegos. Relé agrega latencia de viaje redondo — si ambos lados tienen acceso a Internet, relé TURN aún debería ser utilizable.
Verifique la pérdida de paquetes entre el agente y global.turn.twilio.com usando una ruta de rastreo o ping.

Las sesiones funcionan desde algunas redes pero no desde otras:

El problema es específico de la configuración del cortafuegos de esa red. Utilice Trickle ICE desde esa red para confirmar qué candidatos están bloqueados.

Acceso de red requerido

Para que funcionen las conexiones remotas, su navegador y el dispositivo de destino necesitan acceso saliente a:

Punto final	Puerto	Protocolo	Propósito
`global.stun.twilio.com`	3478	UDP	STUN — Traversal NAT
`global.turn.twilio.com`	3478	TCP y UDP	Relé TURN
`global.turn.twilio.com`	5349	TCP	TURN TLS (último recurso)

💡 CONSEJO: Comience con UDP 3478 saliente. La mayoría de las redes que necesitan TURN en absoluto pueden usarlo en UDP 3478 sin abrir nada más. Solo cambie a TCP 3478 o 5349 si UDP está bloqueado.

Verificar si una sesión es P2P o relé

Level muestra el tipo de conexión directamente en la interfaz de usuario — no se necesita captura de paquetes.

Control remoto — busque la insignia de conexión en la esquina superior izquierda de la barra de herramientas de sesión. Muestra P2P o Relé.
Gestión en segundo plano (Terminal, Explorador de archivos, Procesos, Servicios) — busque la insignia en la esquina superior derecha de la barra de herramientas de sesión. Muestra Conectado: P2P o Conectado: Relé.

Pase el ratón sobre la insignia para ver qué lado está en relé — indicará si el problema está en el lado técnico (su navegador), el lado del dispositivo (el agente) o ambos. Eso le indica exactamente dónde concentrar la investigación de red.

Preguntas frecuentes

El control remoto se conecta pero se siente lento. ¿Es un problema de relé? Podría ser, pero hay muchos factores que afectan el rendimiento de la sesión. Comience verificando la insignia de conexión — si muestra P2P, el tipo de conexión no es el problema y algo más está causando la lentitud. Si muestra Relé, pase el ratón sobre la insignia para ver qué lado está en relé, luego trabaje a través de los requisitos de red para ese lado.
La prueba de red de Twilio pasa pero las sesiones remotas aún fallan. La prueba se ejecuta desde su navegador. El lado del dispositivo también necesita acceso saliente a los mismos puntos finales TURN. Ejecute --check en el dispositivo (ver Solución de problemas de problemas del agente) y busque fallas relacionadas con TURN. Si el dispositivo está en una red más restrictiva que su navegador, es posible que no pueda alcanzar global.turn.twilio.com.
¿Necesito abrir puertos de cortafuegos entrantes para el acceso remoto de Level? No. Todas las conexiones se originan salientes desde el navegador y el agente. No necesita reglas entrantes.
La insignia dice relé. ¿Cómo hago que funcione P2P? Primero pase el ratón sobre la insignia — le dirá qué lado está en relé. Si es el lado del dispositivo, verifique que el dispositivo pueda alcanzar global.stun.twilio.com y global.turn.twilio.com saliente en UDP 3478. Si es el lado técnico (su navegador), ejecute la prueba de red de Twilio desde esa red. Si ambos lados muestran relé, verifique ambos. En entornos muy restrictivos (filtrado de salida estricto, NAT de nivel de operador), relé puede ser simplemente el modo permanente — las sesiones aún funcionarán, solo con latencia agregada.

Solución de problemas de relé/P2P