Instalação OpenWrt + OpenNDS

O que é

O modelo OpenWrt OpenNDS transforma um roteador com o sistema OpenWrt em hotspot. O roteador mostra a sua tela de login para o visitante e libera a internet depois do login. Não usa RADIUS: o roteador conversa direto com a plataforma.

Você roda um comando no roteador e ele se configura sozinho: instala o portal, cria a rede do hotspot, aplica o nome da rede e a lista de sites liberados.

Antes de começar

Você vai precisar de:

• Um roteador com OpenWrt 25.x já instalado e gravado de forma definitiva. O passo a passo completo do painel foi feito para o Xiaomi Mi Router 4A Gigabit (16 MB de memória flash e 128 MB de RAM). Outros roteadores com OpenWrt 25.x e espaço parecido também servem.
• A internet (WAN) do roteador funcionando. O instalador para se não tiver internet.
• Um computador ligado por cabo na porta LAN do roteador, com acesso SSH (no Windows 10 ou 11, o comando ssh já vem no Prompt de Comando).
• Uma licença livre para criar o hotspot no painel.

Use cabo, não WiFi. O instalador move o WiFi para a rede do hotspot. Se você estiver conectado pelo WiFi, perde o acesso no meio da instalação. Pelo cabo, o roteador continua em 192.168.1.1 como antes.

O roteador ainda está com o sistema de fábrica?

Para o Xiaomi 4A Gigabit, o painel gera um guia que leva o roteador do sistema de fábrica até o OpenWrt definitivo (ele aparece na aba Guia de Instalação, explicada abaixo). Em resumo, o guia tem três fases:

1. Liberar o acesso ao roteador Xiaomi, com uma ferramenta rodada no seu computador.
2. Gravar o OpenWrt: primeiro um sistema temporário e depois o definitivo, em System > Backup / Flash Firmware.
3. Instalar o agente com o comando do painel (o Passo 3 deste artigo).

Não pule a gravação definitiva. Se o roteador ficar só no sistema temporário, tudo o que você configurar some quando ele reiniciar. O instalador avisa e para se perceber isso. E não desligue o roteador enquanto ele grava o sistema: uma queda de energia nessa hora pode inutilizar o aparelho.

Passo 1 — No painel: criar o hotspot

1. Abra o menu Hotspots e clique em Configurar Novo Hotspot.
2. Na aba Informações Básicas, preencha:
   • Nome Fantasia: o nome do local (ex.: Loja Centro).
   • Local: onde o roteador fica (ex.: Salão).
   • Modelo: escolha OpenWrt.
   • MAC Address, Serial Number e IP Padrão são opcionais para este modelo.
3. Se quiser, complete as abas Endereço e Contato.
4. Clique em Criar Hotspot. O painel abre a tela de edição do hotspot.

Tempo e velocidade

Na tela de edição, aba Personalização, bloco Tempo de Acesso, o campo Tempo Padrão escolhe o perfil do hotspot. Desse perfil o roteador usa:

• a Banda, que vale igual para download e upload;
• o Tempo de cada visitante. Quando o tempo acaba, o roteador desconecta o visitante.

Os perfis ficam em Configurações → Perfis de Acesso. Clique em Salvar depois de mudar.

Passo 2 — No painel: copiar o comando de instalação

1. Ainda na edição do hotspot, abra a aba Guia de Instalação.
2. O quadro OpenWrt + openNDS mostra:
   • Hash do Dispositivo: o código que identifica este hotspot.
   • Comando de Instalação (SSH no roteador): o comando completo, já com o endereço do servidor e o hash. Clique no botão de copiar, no canto do quadro.
3. Se quiser o passo a passo completo (inclusive a gravação do OpenWrt no Xiaomi 4A Gigabit), clique em Gerar Instalador. O guia aparece na tela e pode ser baixado em Baixar Script.

O comando tem este formato (o seu já vem preenchido):

wget -O- '<endereço exibido no painel>/...?format=installer' | sh

Passo 3 — No roteador: rodar o instalador

1. No computador ligado por cabo, abra o terminal e entre no roteador:

   ssh root@192.168.1.1

   Use a senha que você definiu em System > Administration.
2. Cole o comando copiado do painel e aperte Enter.
3. Acompanhe as mensagens. O instalador:
   • instala o portal (openNDS) e os programas de que ele precisa;
   • cria uma rede separada para o hotspot (192.168.50.1), sem mexer na rede do cabo;
   • move o WiFi para a rede do hotspot e aplica o nome da rede;
   • aplica a lista de sites liberados antes do login (walled garden);
   • liga o envio de sinal de vida para o painel, a cada minuto;
   • instala um menu no LuCI (a tela web do roteador) para acompanhar o agente.
4. No fim aparece a mensagem de instalação concluída. Deu erro? Leia a mensagem, corrija e rode o mesmo comando de novo. Rodar duas vezes não estraga nada.

O que o painel envia para o roteador

Item	De onde vem
Nome da rede WiFi	O SSID padrão da sua conta. Se não houver, o Nome Fantasia do hotspot. A rede fica aberta, sem senha.
Sites liberados antes do login	A lista Walled Garden - Permissões (Allow), em Administração → Configurações → ACL (Firewall/Walled Garden).
Velocidade e tempo	O perfil do campo Tempo Padrão do hotspot, aplicado a cada login.

Mudou o nome da rede ou a lista de sites liberados? O roteador só recebe essas duas coisas na instalação. Rode o comando de novo, ou use o botão Reprovisionar na página Sistema do menu que o instalador criou no LuCI. Tempo e velocidade não precisam disso: valem a partir do próximo login.

Passo 4 — Testar com um celular

1. Espere pelo menos 1 minuto depois da instalação.
2. No celular, conecte na rede WiFi do hotspot.
3. A tela de login deve abrir sozinha. Se não abrir, abra qualquer site no navegador.
4. Faça o login como um visitante. A internet deve liberar logo depois.
5. No painel, abra o hotspot em Hotspots (Ver detalhes). O quadro Clientes Conectados mostra o celular do teste, com o consumo. Ele se atualiza a cada 15 segundos.

Problemas comuns

Sintoma	O que fazer
O instalador diz que não há internet	Configure a WAN do roteador (cabo do modem na porta WAN) e rode o comando de novo.
O instalador diz que o sistema está rodando na memória e as alterações não ficam	O OpenWrt definitivo não foi gravado. Faça a gravação em System > Backup / Flash Firmware e rode o instalador depois.
O comando termina na hora sem instalar nada, ou mostra erro 404	Confira se o hotspot está com o modelo OpenWrt e ativo, e copie o comando de novo da aba Guia de Instalação, sem cortar nenhum pedaço.
Perdi o acesso ao roteador pelo WiFi	É esperado: o WiFi agora é do hotspot. Entre pelo cabo, em 192.168.1.1.
O celular conecta, mas a tela de login não abre	Rode o instalador de novo. Ele troca um componente do roteador que o portal precisa.
A tela de login abre, mas depois do login a internet não libera	Rode o instalador de novo para refazer a configuração do portal.
A tela de login abre sem imagens, ou o login social não conclui	Falta um site na lista de sites liberados. Peça para incluir e depois use Reprovisionar.
Quero começar do zero	No roteador, rode firstboot e depois reboot. Isso apaga todas as configurações. Depois entre por SSH em 192.168.1.1 e rode o instalador.