Integração do CaptiveWeb com UniFi Controller instalado localmente (self-hosted) ou via UniFi Network Application.

ℹ️
Versão suportadaUniFi Network Application 7.x ou superior. UniFi Controller 6.x também é compatível.

1. Habilitar Guest Portal no UniFi

  1. Acesse o UniFi Controller

    Vá para Settings → WiFi → sua rede Wi-Fi de convidados.

  2. Ative Guest Hotspot

    Em Advanced → Guest Hotspot, ative a opção e selecione External Portal Server.

  3. Configure a URL do portal

    Informe a URL: https://portal.captiveweb.com.br/unifi/

2. Configurar RADIUS no UniFi

Em Settings → Profiles → RADIUS, crie um perfil:

CampoValor
IP do servidorradius.captiveweb.com.br
Porta Auth1812
Shared SecretCopiado do painel CaptiveWeb
AccountingHabilitado | Porta 1813

3. Walled Garden no UniFi

Em Settings → Guest Control → Access Control, adicione:

portal.captiveweb.com.br
*.captiveweb.com.br
fonts.googleapis.com
fonts.gstatic.com
*.mercadopago.com
*.asaas.com

4. Importar configuração via ZIP (atalho)

O CaptiveWeb gera automaticamente um arquivo de configuração compatível com o UniFi:

  1. Baixar o ZIP

    No painel, acesse o equipamento UniFi e clique em Baixar configuração ZIP.

  2. Importar no UniFi

    No UniFi Controller, vá em Settings → System → Import e suba o arquivo ZIP.

✅
Pronto!Após salvar, teste conectando um celular ao SSID de convidados. O portal CaptiveWeb deve aparecer automaticamente.