Saltearse al contenido

Problemas conocidos de Ubiquiti UniFi

El portal cautivo no aparece

Síntoma: Después de conectarse a la red WiFi de invitados, la página de inicio de sesión del portal cautivo no aparece.

Solución: UniFi puede fallar ocasionalmente al aplicar la nueva configuración después de realizar cambios. Si el portal cautivo no aparece, intente los siguientes pasos en orden.

1. Desactivar y volver a activar el Hotspot

Apague el Hotspot, espere 30 segundos y vuelva a encenderlo. Esto obliga a los puntos de acceso a tomar la nueva configuración sin necesidad de un reinicio completo.

2. Reiniciar el Punto de Acceso

Los puntos de acceso a veces pueden fallar al aprovisionarse inmediatamente después de realizar un cambio de configuración. Reiniciar el AP lo obliga a recargar la configuración y puede resolver el problema de inmediato.

3. Restablecer la configuración del Hotspot a los valores predeterminados y volver a aplicarla manualmente

Vaya a Clients y abra la pestaña Hotspot. Navegue a Landing Page Settings, cambie cualquier valor y el botón Restore Default Settings aparecerá en la parte inferior de la página, cerca de los botones Save y Cancel.

HotspotReApply

Haga clic en Restore Default Settings, luego vuelva a aplicar manualmente la configuración correcta siguiendo la guía de configuración de Social WiFi.

Retraso en la autenticación

Síntoma: Cuando los invitados se conectan a una red WiFi gestionada por Social WiFi, a menudo experimentan un retraso significativo después de hacer clic en “Connect”. En algunos casos, el proceso de autorización nunca se completa.

Solución: Este problema suele ocurrir cuando el controlador UniFi está alojado fuera de la red local, por ejemplo, en un VPS o en la nube. Se recomienda utilizar un controlador local, como un UniFi Cloud Gateway Ultra.

Comportamiento con un controlador local

Cuando el controlador se despliega dentro de la red local, los puntos de acceso (APs) de UniFi se comunican con él casi instantáneamente, lo que permite una autorización inmediata de los invitados.

26052025-1218.jpg

  1. El teléfono envía una solicitud al controlador a través del Punto de Acceso.
  2. El usuario es autorizado en el controlador.
  3. El controlador envía instantáneamente una respuesta confirmando la autorización.
  4. El usuario está autorizado y puede navegar por internet.

Comportamiento con un controlador alojado externamente

Con controladores alojados externamente, los APs de UniFi envían un paquete “inform” aproximadamente cada 30 segundos. Como resultado, el controlador puede tardar hasta 30 segundos en notificar al AP que un invitado ha sido autorizado. Este retraso resulta en una mala experiencia de inicio de sesión para el invitado.

26052025-1218-2.jpg

  1. El teléfono envía una solicitud al controlador a través del Punto de Acceso.
  2. La solicitud se enruta al controlador fuera de la red local.
  3. El usuario es autorizado, pero la información no se puede enviar de vuelta al Punto de Acceso instantáneamente.
  4. El Punto de Acceso verifica las actualizaciones de configuración con el controlador cada 30 segundos.
  5. Cuando el Punto de Acceso se registra, la información de autorización finalmente se devuelve.
  6. El usuario está autorizado y puede navegar por internet.

Problemas de roaming de invitados

Síntoma: Los invitados que se desplazan entre puntos de acceso pierden el acceso a internet y se les solicita que vuelvan a autenticarse, a pesar de que ya estaban autorizados.

Causa raíz: Debido al mismo mecanismo de paquete “inform” descrito en la sección Retraso en la autenticación anterior, un controlador alojado externamente no puede notificar instantáneamente a todos los puntos de acceso que un invitado ya está autorizado. Cuando un invitado se desplaza (roaming) a un AP diferente, es posible que ese AP aún no sepa que el invitado está autorizado y bloqueará el acceso a internet hasta que se complete el siguiente ciclo de “inform” (hasta 30 segundos), obligando al invitado a pasar por el proceso de inicio de sesión nuevamente.

Solución: Los mismos enfoques que resuelven el retraso en la autenticación también solucionan los problemas de roaming:

A) Cambie a un controlador local para que el estado de autorización se propague instantáneamente, por ejemplo, un UniFi Cloud Gateway Ultra.

B) Utilice un dispositivo MikroTik para gestionar el flujo de inicio de sesión de Social WiFi en lugar de UniFi.

Actualización del firewall de UniFi (Zone-based Firewall)

Síntoma: Después de instalar el servicio, o cuando el firewall se actualiza en una instalación existente, ninguno de los métodos de autorización disponibles funciona. Este es un problema conocido donde las URLs de la lista blanca de pre-autorización (Pre-Authorization Allowlist) no se aplican cuando una red (VLAN) tiene un tipo de zona de Hotspot. Este problema se está investigando actualmente con UniFi.

Solución: Cree una nueva regla de firewall encima de la regla afectada (ID: 30004) con la siguiente configuración.

NameHotspot out
Source ZoneHotspot, Any
PortAny
ActionAllow
Destination ZoneExternal, Any
PortAny

Firewall Rule

Deje todos los demás ajustes en sus valores predeterminados.