Introducción

Las funciones 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 retransmisión. Si las sesiones remotas son lentas, no logran conectarse o ve «conectando...» indefinidamente, esta guía le ayuda a identificar dónde se produce el fallo.

Cómo establece Level las conexiones remotas

Level intenta conectarse en este orden y se detiene en cuanto uno tiene éxito:

P2P directo — su navegador se conecta directamente al dispositivo. La menor latencia, sin intermediarios.
STUN — utiliza global.stun.twilio.com para atravesar el 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) — la misma retransmisión, TCP en lugar de UDP para cortafuegos más estrictos.
TURN sobre TLS (puerto 5349) — último recurso; retransmisión cifrada para los entornos más restrictivos.

Todas las conexiones se inician de forma saliente tanto desde el navegador como desde el agente. No debería necesitar reglas de cortafuegos entrantes.

ℹ️ NOTA: Las conexiones de retransmisión (TURN) añaden latencia en comparación con P2P. Si utiliza retransmisión de forma constante, la sesión funcionará pero puede sentirse más lenta. El objetivo de esta guía es llevarle a P2P o, al menos, confirmar que la retransmisión funciona 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 del técnico, no el del endpoint): Prueba de red de Twilio

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

Prueba con Trickle ICE

La herramienta Trickle ICE comprueba si su navegador puede obtener un candidato reflexivo de servidor (srflx) a través del servidor STUN de Level.

Use este valor:

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

Si srflx no aparece ningún candidato, es posible que STUN esté bloqueado en el lado del técnico.

⚠️ ADVERTENCIA: No agregue turn:global.turn.twilio.com:3478 a Trickle ICE sin credenciales. El navegador rechazará la entrada con un error de nombre de usuario o contraseña de TURN. Utilice la Prueba de red de Twilio indicada anteriormente para probar la conectividad TURN de Level sobre UDP, TCP y TLS.

Causas comunes y soluciones

Las sesiones remotas no logran conectarse en absoluto:

El navegador del lado del técnico no puede alcanzar los servidores TURN. Ejecute la Prueba de red de Twilio desde su navegador para confirmarlo. Si falla, su red corporativa o VPN puede estar bloqueando UDP 3478 o TCP 3478 saliente.
La red del lado del agente está bloqueando 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 el puerto 3478.

Las sesiones remotas se conectan pero son lentas o se interrumpen con frecuencia:

La conexión utiliza retransmisión (TURN) en lugar de P2P. Esto es esperado en redes con NAT restrictivo o cortafuegos. La retransmisión añade latencia de ida y vuelta — si ambos lados tienen acceso a internet, la retransmisión TURN debería seguir siendo utilizable.
Compruebe si hay pérdida de paquetes entre el agente y global.turn.twilio.com mediante un traceroute 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. Use Trickle ICE desde esa red para confirmar qué candidatos están bloqueados.

Acceso de red requerido

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

Endpoint	Puerto	Protocolo	Propósito
`global.stun.twilio.com`	3478	UDP	STUN — traversal de NAT
`global.turn.twilio.com`	3478	TCP & UDP	Retransmisión 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 pueden usarlo en UDP 3478 sin abrir nada más. Solo pase a TCP 3478 o 5349 si UDP está bloqueado.

Cómo verificar si una sesión es P2P o retransmisión

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

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

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

Preguntas frecuentes

El control remoto se conecta pero se siente lento. ¿Es un problema de retransmisión? Podría serlo, pero hay muchos factores que afectan el rendimiento de la sesión. Empiece comprobando el indicador de conexión — si muestra P2P, el tipo de conexión no es el problema y algo más está causando el retraso. Si muestra Retransmisión, pase el cursor sobre el indicador para ver qué lado está en retransmisión y luego revise los requisitos de red para ese lado.
La Prueba de red de Twilio pasa, pero las sesiones remotas siguen fallando. La prueba se ejecuta desde su navegador. El lado del dispositivo también necesita acceso saliente a los mismos endpoints TURN. Ejecute --check en el dispositivo (véase Solución de problemas del agente) y busque fallos relacionados 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 de forma saliente tanto desde el navegador como desde el agente. No necesita reglas entrantes.
¿Qué puertos utiliza una sesión P2P directa? El descubrimiento STUN utiliza UDP 3478, pero el tráfico WebRTC directo se negocia entre su navegador y el dispositivo sobre puertos UDP seleccionados dinámicamente. No existe un único puerto P2P fijo ni un rango de puertos universal de Level para incluir en la lista de permitidos. Para permitir P2P, habilite UDP saliente entre pares con tráfico de retorno con seguimiento de estado. Si su política de red bloquea el tráfico directo entre pares, Level puede recurrir a la retransmisión TURN siempre que los endpoints y puertos indicados en Acceso de red requerido están disponibles. Aun así, no necesita una regla entrante no solicitada.
El indicador muestra Retransmisión. ¿Cómo consigo que funcione P2P? Pase el cursor sobre el indicador primero — le indicará qué lado está en retransmisión. Si es el lado del dispositivo, verifique que el dispositivo puede alcanzar global.stun.twilio.com y global.turn.twilio.com saliente en UDP 3478. Si es el lado del técnico (su navegador), ejecute la Prueba de red de Twilio desde esa red. Si ambos lados muestran retransmisión, compruebe ambos. En entornos muy restringidos (filtrado de tráfico saliente estricto, NAT de grado de operador), la retransmisión puede ser simplemente el modo permanente — las sesiones seguirán funcionando, aunque con mayor latencia.

Solución de problemas de Relay/P2P