Saltar al contenido principal
Guía de despliegue de MSP

Despliega CaptiFi para tus clientes

Listas de comprobación paso a paso para el despliegue de UniFi, Omada, Meraki y más. Pon tu primer cliente en marcha en menos de una hora.

Tres rutas de despliegue

Controlador existente

Configura CaptiFi como portal cautivo externo en tu controlador existente de UniFi, Omada, Meraki o Aruba.

CaptiFi Hardware

Conecta nuestro dispositivo preconfigurado. Se conecta a cualquier red existente. No hace falta controlador. En unos minutos entra en directo 5 con el dispositivo CaptiFi.

Hardware Socio

Usa tu propio router o punto de acceso compatible. Configura la redirección de portal externo para que apunte a CaptiFi.

Lista de verificación de despliegue maestro

Completa todos los elementos antes de marcar el sitio como activo. Esta lista de verificación se aplica a todas las rutas de despliegue.

Detalles del cliente confirmados

Nombre del negocio, dirección, persona de contacto, correo electrónico, teléfono

Logo del recinto subido

PNG, JPG o WebP, mínimo 200×200px; un PNG o WebP con fondo transparente funciona mejor.

Página de inicio configurada y aprobada

Marca, colores, método de acceso, términos/enlaces de privacidad

Tipo de controlador seleccionado

Hardware UniFi, Omada, Meraki, Aruba, MikroTik, DrayTek o CaptiFi

Controlador accesible desde CaptiFi, si tu configuración lo necesita

Solo cuando CaptiFi se comunica con un controlador que alojas. UniFi en la clave API o en la ruta de usuario y contraseña, y un controlador Omada en el sitio, necesitan una IP pública o nombre de host, además de una regla de firewall o reenvío de puertos para HTTPS desde CaptiFi. Un controlador Cisco Catalyst 9800 o AireOS necesita que UDP 1700 (9800) o 3799 (AireOS) estén abiertos en el acceso entrante desde CaptiFi. El túnel remoto UniFi, el controlador de pago basado en la nube de Omada y Meraki no necesitan acceso entrante, y el dispositivo CaptiFi no necesita IP estática ni cambio en el firewall.

Red de invitados configurada

SSID separado para invitados, aislamiento de VLAN de la red empresarial

URL del portal cautivo configurada

Redirección de portal externo apuntando a la URL de inicio de CaptiFi

Dispositivo de prueba conectado con éxito

Conecta un teléfono/tablet al SSID de invitados, verifica las cargas de la página de inicio

Captura de datos verificada

Completa el formulario de presentación y verifica que el correo electrónico/nombre aparece en el panel de control de CaptiFi

Redirección tras iniciar sesión probada

Tras iniciar sesión, el invitado debe acceder a internet o a una página de aterrizaje personalizada

Traspaso del cliente completado

Cliente informado sobre el acceso al panel de control, captura de datos y proceso de soporte

Guías específicas para plataformas

Requisitos previos

  • Aplicación de red UniFi en funcionamiento (autoalojada o Cloud Gateway)
  • CaptiFi puede llegar al controlador: una IP pública con una regla de firewall o reenvío de puertos, o el túnel remoto en una consola UniFi OS, que no necesita puertos entrantes
  • Red/SSID de invitados ya creado

Pasos de configuración

  1. En Configuración → WiFi, abre la red de invitados y desplázate hasta el Portal de Hotspot (las versiones antiguas llaman a esto Configuración → Hotspot de Invitados).
  2. Configura el Portal de Hotspot en Habilitado y el tipo de portal en Servidor de Portal Externo
  3. Aquí entra el portal de CaptiFi: dirección 46.62.168.7 IPv4 y site.app.captifi.io de dominio. En la clave API y las conexiones de túnel remoto, CaptiFi escribe estas configuraciones por ti
  4. Configurar el acceso de preautorización - añadir dominios CaptiFi al jardín amurallado
  5. En la configuración de la página de destino, marca Mostrar página de destino, Soporte de redirección HTTPS, URL cifrada y Portal seguro
  6. Desactiva los propios métodos de contraseña, vales, Facebook, pago y RADIUS de UniFi en el portal de hotspot: CaptiFi autoriza a los invitados a través de la API UniFi Controller, por lo que no se necesita RADIUS
  7. Guarda y aplica. Conecta un dispositivo de prueba para verificar.

Dominios de Jardín Amurallado

Añade estos al acceso de preautorización:

site.app.captifi.io
app.captifi.io
fonts.googleapis.com
fonts.gstatic.com
*.captifi.io

Los primeros cuatro son obligatorios; el comodín cubre cualquier cosa que CaptiFi añada después, si tu firmware acepta comodines.

Resolución de problemas

  • Splash no cargando: Comprueba que Jardín Murado incluye dominios CaptiFi
  • Bucle de redirección: Asegúrate de que solo un portal esté activo (desactiva el portal UniFi integrado)
  • El invitado no puede acceder a internet tras iniciar sesión: Revisa las reglas de enrutamiento VLAN y cortafuegos

Pasos de configuración

  1. Crea un SSID de invitados abierto con la opción de Red de Invitados de Omada desactivada y usa una VLAN separada para mantener alejados a los invitados de tus propios dispositivos
  2. Abre Portal de Configuración → →Autenticación de Red (Omada 5: Configuración → Portal de Autenticación →), haz clic en Crear Nuevo Portal, actívalo para el SSID de invitado y configura la Landing Page a URL Original
  3. En la pestaña de Autenticación, configura el Tipo de Autenticación como Servidor de Portal Externo con un servidor de portal personalizado de URL: elige https:// e introduce app.captifi.io/guest/omada?site_id=YOUR_SITE_ID
  4. En la pestaña de Control de Acceso, activa el Acceso Pre-Autenticación y añade app.captifi.io, 46.62.168.7 (rango IP, máscara 32), fonts.googleapis.com y fonts.gstatic.com. Omada no acepta comodines
  5. En Hotspot → Operadores, añade una cuenta de operador para CaptiFi, luego introduce la URL del Controlador, el 32ID del Controlador de -caracteres y el inicio de sesión del operador del recinto en my.captifi.io
  6. Guarda y prueba con un dispositivo invitado. Con una app Open API para rol de Administrador, CaptiFi puede configurar el portal y la lista de preautenticación en el controlador por ti

Pasos de configuración

  1. Abre el tablero de control de Meraki → Wireless → Configura → página de inicio, elige el SSID de invitado e introduce la URL de inicio de CaptiFi bajo URL de inicio personalizada, con Incluir la dirección MAC del cliente activada en la URL de inicio
  2. En Wireless → Configurar → control de acceso, configura la página de inicio en Click-through y la intensidad del portal cautivo para bloquear todo acceso hasta que se complete el inicio de sesión
  3. En Configuración avanzada de salpicaduras, activa el jardín amurallado y añade app.captifi.io, site.app.captifi.io, *.captifi.io, network-auth.com, *.network-auth.com, y fonts.googleapis.com fonts.gstatic.com. Sin las dos entradas network-auth.com Meraki nunca concede acceso
  4. Guarda los cambios. Prueba con un dispositivo invitado en el SSID configurado.

Pasos de preparación

  1. Conecta el dispositivo CaptiFi a la red existente del recinto por Ethernet y enciéndelo
  2. La luz parpadea en amarillo mientras arranca (30 a 60 segundos), luego se vuelve morada fija: está esperando a ser activada
  3. Únete a la red "CaptiFi Setup" desde un teléfono e introduce el PIN de activación de -dígitos del 8recinto
  4. La luz pulsa en azul mientras el dispositivo extrae su configuración de la nube de CaptiFi, y luego se vuelve verde fijo
  5. Conecta un teléfono al SSID de invitados y la página de inicio se carga automáticamente
  6. Toda la configuración dura unos cinco minutos de principio a fin, sin cambios de controlador, IP estática ni cortafuegos

Guía de luz: el amarillo parpadeante arranca, el morado fijo espera el PIN de activación, el azul pulsante está configurando, el verde fijo está activo. Rojo significa que no hay internet, así que conecta el cable al router.

¿Necesitas ayuda?

Apoyo a socios

Proporcionas soporte de primera línea a tus clientes. Envía un correo partners@captifi.io para escalar un problema técnico a CaptiFi como soporte de segunda línea, y avisa si un local está caído para que sepamos que es urgente.

Antes de escalar

  • Confirma que no es un problema de red local
  • Verificar conectividad del controlador
  • Prueba con un dispositivo limpio (sin portal en caché)
  • Incluye capturas de pantalla y registros
Contacta con el soporte del socio

¿Aún no eres socio?

Solicita el Programa de Socios MSP para acceder a precios mayoristas, herramientas de despliegue y una 6licencia interna de demostración de un mes para un solo espacio de pruebas interno (solo pruebas y demostraciones).

Solicita ser socio