--- title: "Como instalar o Hotspot Social na Controller UniFi - 7.3.83 ou inferior" url: "https://ajuda.hotspotsocial.com.br/pt/article/configurar-unifi-network-controller-hotspot-social" language: "pt" last_updated: "2026-09-10T18:09:52.351Z" --- # Como instalar o Hotspot Social na Controller UniFi - 7.3.83 ou inferior Como instalar o Hotspot Social na controladora UniFI * * * Este material procura orientar de forma clara e prática a instalação do **Hotspot Social** no **UniFi Controller**, garantindo que todos os passos sejam executados corretamente para o funcionamento da solução. Antes de iniciar, destacamos alguns pontos importantes sobre **compatibilidade, permissões e limitações específicas do ambiente UniFi.** A partir daqui, você terá um guia completo para configurar sua rede com segurança e aproveitar todos os recursos do Hotspot Social. * * * **IMPORTANTE**: - Ao usar o Hotspot Social com o UniFi Controller **NÃO** é gerado o **LOG do Marco Civil**.  - Recomendamos que **faça o backup das configurações do UniFi Controller** **antes de configurar o Hotspot Social**. - É necessário ter um servidor DHCP na rede. - A revenda deve ter acesso completo (root ou administrador) ao servidor do UniFi Controller, pois será necessário inserir arquivos de configuração nos diretórios do UniFi Controller.  - Os APs UniFi devem estar sempre conectados ao mesmo UniFi Controller que foi configurado o Hotspot Social. - Não há bloqueio das redes sociais antes do usuário finalizar a conexão. - Não é possível realizar a troca do SSID dos APs pelo painel do Hotspot Social, a troca deve ser realizada diretamente pelo UniFi Controller. - Não é possível desconectar o usuário pelo Dashboard do painel do Hotspot Social. - A autenticação dos usuários do Hotspot Social é realizada externamente em nossos servidores Radius. - Para alterar a velocidade de conexão, é necessário configurar pela UniFi Network Controller, no menu "User Groups" e designar o uso dele em "Wireless Network". Nas imagens do material foi utilizado a **Unifi Network Controller** versão **5.12.66.0,** atualmente o **Hotspot está homologado** para funcionamento até a versão **7.3.83,** instalado tanto em servidor Windows quanto em servidor Linux.  Acesse o Controller e clique em **Configurações** (ícone de engrenagem na parte inferior do lado esquerdo) ![](https://cdn-assets.productfruits.com/a3f06eb8-48fe-4b58-99a4-f97c1a5f809a) ## **Configuração do Sítio (Site)** 1. Clique em **Sítio** 2. Insira o nome do **Sítio**, selecione o **País** e o **Fuso Horário** ![](https://cdn-assets.productfruits.com/b84462c8-8558-4bbf-a830-03d44fd3c502) ## **Configuração da Rede Sem Fio** 1. Clique em **Rede Sem fio** 2. Clique em **\+ CRIAR NOVA REDE SEM FIO** ![](https://cdn-assets.productfruits.com/04e83d3e-3fae-4a1b-9617-96ac53360599) Nas seções **Editar Redes Sem Fio** e **Opções Avançadas.** 1. Insira o nome do **SSID** 2. Ative a **Rede sem fio** 3. Em segurança selecione **Aberto** 4. Habilite **Política de Convidado** 5. Desabilite o **Filtro Multicast e Broadcast** ![](https://cdn-assets.productfruits.com/91045aa8-4998-41a2-ac9e-f5f7f5e03662) ## **Configurar RADIUS** 1. Clique em **Perfis** 2. Clique em **\+ CRIAR NOVO PERFIL RADIUS** ![](https://cdn-assets.productfruits.com/dd8108c1-984a-4dfd-a069-631b0a567aee) Na seção **Editar Perfil Radius** 1. Digite o **Nome do Perfil** 2. Insira os seguintes dados => **IP**: 40.70.60.221    **Porta**: 1812      **Senha/Código Compartilhado**: wmngr2761a3301 3. Habilite **Contas ativas** 4. Habilite **Atualização provisória** 5. Em **Intervalo de atualização provisória** insira o valor **60** 6. Insira os seguintes dados => **IP**: 40.70.60.221    **Porta**: 1813      **Senha/Código Compartilhado**: wmngr2761a3301 ![](https://cdn-assets.productfruits.com/b1bcba69-6554-4eef-90d0-8d13b5c59c4c) ## **Configuração do Controle de Convidados**  Na seção **Políticas de Convidado** 1. Selecionar o item, Control **de convidados** 2. Ativar **Portal de Convidados** 3. Escolher **Hotspot** como forma de **Autenticação** 4. O tempo de **Expiração Padrão** será o tempo de **Sessão do Perfil de Conexão Padrão**  5. Selecionar a opção **Redirecionar para o URL original** 6. **NÃO** selecionar nenhuma opção de **Redirecionamento** ![](https://cdn-assets.productfruits.com/8c7efa40-65dd-4259-9e8b-9416d504f4db) Na seção **Personalização do Portal** 1. Selecione **AngularJS** 2. Selecione **Substituir modelos com alterações personalizadas** ![](https://cdn-assets.productfruits.com/3ec0796a-81b7-461c-a5a0-4c138de72839) Nas seções **Hotspot** e **Radius** 1. Selecione **Ativar a autorização baseada em RADIUS** 2. Selecione o **Perfil** do **Radius** que foi criado anteriormente 3. Selecione **MS-CHAPv2** ![](https://cdn-assets.productfruits.com/63d24d70-87b6-4c31-8239-9ff5f7943336) Na seção **Controle de Acesso**  Adicione os endereços abaixo (um de cada vez) em **Acesso Pré-Autorizado**: ```plaintext 104.41.3.13 138.118.173.207 187.45.181.29 191.232.199.45 191.238.219.216 20.186.155.118 45.32.160.174 akamaihd.net connect.facebook.net facebook.com fbcdn.net accounts.google.com googleapis.com ssl.gstatic.com hotspotsocial.xyz linkedin.com licdn.net licdn.com instagram.com twitter.com api.twitter.com x.com api.x.com twimg.com loginwifi.live akadns.net alphacdn.net msedge.net trafficmanager.net microsoftonline.com viacep.com.br doubleclick.net edgekey.net akamaitechnologies.com akamaiedge.net apple.com.edgekey.net akamai.com wifimanager.azurewebsites.net 40.75.27.221/32 52.225.216.128/32 40.70.60.221/32 52.67.255.165/32 170.82.175.0/24 187.16.245.192/29 201.148.101.24/29 200.189.173.48/28 200.98.28.70/32 187.85.159.176/29 170.84.29.208/29 34.95.168.58/32 45.63.104.13/32 140.82.27.226/32 45.77.97.241/32 207.246.123.237/32 207.148.26.195/32 186.211.161.0/29 45.238.96.152/29 34.95.213.225/32 34.95.209.169/32 35.247.222.78/32 34.95.253.129/32 34.95.148.131/32 34.95.164.249/32 129.159.48.87/32 208.89.72.56/29 wifimanager.online 170.82.173.10/32 170.82.174.10/32 170.82.173.30/32 170.82.174.30/32 209.126.0.53/32 20.49.97.15/32 38.224.134.0/24 144.22.216.139/32 150.230.84.126/32 ``` Em **Controle de Acesso** adicione os endereços abaixo (um de cada vez) em **Restrições Pós-Autorização**: ```plaintext 192.168.0.0/16 172.16.0.0/12 10.0.0.0/8 ``` ![](https://cdn-assets.productfruits.com/d8db0a9a-89d5-45c3-977e-90048ca04a3e) ## **Cópia dos arquivos de configuração do Hotspot Social** Para cada licença do Hotspot Social para Unifi serão enviados 03 arquivos que deverão ser adicionados no Controller.  - index.html - signin.html - WM\_unifi.js Os arquivos deverão ser adicionados no diretório referente ao sítio (site) onde estão vinculados os APs do Hotspot Social.  Para saber qual o diretório correto é só seguir o procedimento abaixo: - Acessar o Unifi Network Controller e escolher o sítio (site) onde estão vinculados os APs do Hotspot Social;  - No navegador a URL irá mostrar qual é o código do site: *https://SEUIPouDOMINIO.COM:8443/manage/site/**CÓDIGODOSITE**/dashboard* Por padrão o código do site é: **default**. Nesse exemplo, o site onde estão os APs é o **Wifi Manager** e o código do meu site é: **7kajnw9n** ### **Em servidores Windows:** Os arquivos deverão ser copiados e/ou substituídos no seguinte diretório: "Diretório onde está instalado o UniFi Controller"\\data\\sites\\**7kajnw9n**\\app-unifi-hotspot-portal Veja que o diretório **7kajnw9n** é o código do Site (sítio) do UniFi Controller que estou usando neste exemplo. **Em servidores Linux:** Para acesso SSH e para fazer a cópia dos arquivos (SFTP) recomendamos o programa [Bitvise](https://www.bitvise.com/). No exemplo abaixo o código do Site (sítio) do UniFi Controller é **1c8mbqij**. É possível localizar no endereço de acesso no navegador. - Os arquivos deverão ser copiados e substituídos no seguinte diretório:  /usr/lib/unifi/data/sites/**1c8mbqij**/app-unifi-hotspot-portal/ - Agora é necessário alterar o usuário e grupo desses arquivos para "unifi" usando o comando abaixo como root: chown unifi:unifi /usr/lib/unifi/data/sites/**1c8mbqij**/app-unifi-hotspot-portal/\* Pronto, sua instalação está finalizada e já pode se conectar no seu Hotspot Social 😁💪🏻. Em caso de dúvidas, entre em contato com nosso time de suporte pelos canais de atendimento.