Pular para o Conteúdo

Documentação · MikroTik

Configurar o MikroTik

Resumo do que o Alpha HotSpot configura no seu roteador. No painel, o script completo é gerado com os seus dados (IP do RADIUS, segredo, VLAN, faixas de IP), pronto para colar no terminal.

A configuração é gerada para RouterOS 7. Revise cada bloco antes de aplicar e faça um backup do roteador. Os itens criados levam o comentário alphahotspot, o que facilita revisar ou remover depois.

1. Antes de Começar

  • Acesso administrativo ao roteador (WinBox, WebFig ou SSH) com RouterOS 7.
  • Uma interface ou bridge onde a rede de visitantes vai ficar (por exemplo, a bridge dos APs).
  • No painel do Alpha HotSpot: cadastre o equipamento em Rede › Equipamentos. O painel define o NAS-Identifier, o segredo RADIUS e as portas.

O primeiro bloco do script define a identidade do roteador, que vai no NAS-Identifier dos pacotes RADIUS:

Terminal do RouterOS
/system identity set name="<NAS-IDENTIFIER>"

2. VLAN de Visitantes

Os visitantes ficam em uma VLAN exclusiva, separada da rede interna da empresa. No AP ou switch, associe o SSID de visitantes à mesma VLAN.

Terminal do RouterOS
/interface vlan add name=vlan50-guest vlan-id=50 interface="bridge" comment="alphahotspot"
/ip address add address=192.168.50.1/24 interface=vlan50-guest comment="alphahotspot"

3. DHCP

Um servidor DHCP próprio para os visitantes, com lease curto (muitos aparelhos ficam pouco tempo).

Terminal do RouterOS
/ip pool add name=alphahotspot-pool ranges=192.168.50.10-192.168.50.250 comment="alphahotspot"
/ip dhcp-server add name=alphahotspot-dhcp interface=vlan50-guest address-pool=alphahotspot-pool lease-time=1h comment="alphahotspot"
/ip dhcp-server network add address=192.168.50.0/24 gateway=192.168.50.1 dns-server=192.168.50.1 comment="alphahotspot"

4. DNS

O roteador responde às consultas DNS dos visitantes, o que é necessário para o redirecionamento do hotspot.

Terminal do RouterOS
/ip dns set allow-remote-requests=yes

5. RADIUS e Accounting

O roteador autentica os visitantes no servidor RADIUS do Alpha HotSpot e envia o accounting das sessões (início, interim update e fim). Opcionalmente, o CoA permite encerrar ou alterar sessões pelo painel.

Terminal do RouterOS
/radius add service=hotspot address=<IP-RADIUS> secret="<SEGREDO>" authentication-port=<PORTA-AUTH> accounting-port=<PORTA-ACCT> timeout=3s comment="alphahotspot"
/radius set [find comment="alphahotspot"] require-message-auth=yes-for-request-resp
# opcional (CoA/Disconnect)
/radius incoming set accept=yes port=<PORTA-COA>

6. Hotspot e Página de Login

O script baixa uma página de login que redireciona o visitante para o portal do Alpha HotSpot e cria o perfil do hotspot com RADIUS e accounting habilitados.

Terminal do RouterOS
/tool fetch url="<URL-DO-LOGIN-GERADA-NO-PAINEL>" dst-path="alphahotspot/login.html" mode=https
/ip hotspot profile add name=alphahotspot hotspot-address=192.168.50.1 dns-name="<DNS-DO-HOTSPOT>" html-directory=alphahotspot login-by=http-chap,http-pap,https use-radius=yes radius-accounting=yes radius-interim-update=300s
/ip hotspot add name=alphahotspot interface=vlan50-guest address-pool=alphahotspot-pool profile=alphahotspot idle-timeout=5m disabled=no

Limites de tempo e de banda podem vir do RADIUS por plano de acesso, configurados no painel.

7. Walled Garden

Antes do login, só o essencial é liberado: o portal, a API e os serviços necessários ao cadastro. A lista exata vem do painel.

Terminal do RouterOS
/ip hotspot walled-garden add dst-host="<HOST-DO-PORTAL>" action=allow comment="alphahotspot"
/ip hotspot walled-garden ip add dst-host="<HOST-DO-PORTAL>" action=accept comment="alphahotspot"

8. Isolamento e NTP

Regras de firewall impedem que visitantes acessem a rede interna e a gerência do roteador, liberando apenas DNS, DHCP e o hotspot local. O NTP mantém o relógio certo, necessário para TLS e accounting.

Terminal do RouterOS
/ip firewall filter add chain=forward in-interface=vlan50-guest dst-address=<REDE-INTERNA> action=drop comment="alphahotspot: bloqueia LAN interna"
/ip firewall filter add chain=input in-interface=vlan50-guest protocol=udp dst-port=53,67 action=accept comment="alphahotspot: DNS/DHCP"
/ip firewall filter add chain=input in-interface=vlan50-guest protocol=tcp dst-port=22,8291,8728,8729,80,443 action=drop comment="alphahotspot: protege gerência"
/system ntp client set enabled=yes

A ordem das regras de firewall importa. Se o roteador já tem regras, confira onde as novas ficaram antes de colocar em produção.

9. Teste e Diagnóstico

  1. Conecte um celular ao SSID de visitantes: o portal deve abrir sozinho.
  2. Faça um cadastro de teste e confirme que a internet é liberada.
  3. No painel, confira se o equipamento aparece online e se a sessão foi registrada.

Para investigar problemas, acompanhe os logs do hotspot e do RADIUS:

Terminal do RouterOS
/log print where topics~"hotspot|radius"

Pronto para Configurar?

Crie sua conta: o painel gera a configuração com os dados reais da sua rede.

Começar GrátisFalar com Especialista