Como transformar seu Raspberry Pi em um ponto de acesso Wi-Fi com portal cativo

Talvez você seja um proprietário de negócio que oferece Wi-Fi gratuito a todos os seus clientes; talvez você tenha um público cativo e planeje vender acesso à sua rede Wi-Fi, ou talvez você queira dar aos convidados um lembrete amigável sobre a etiqueta de uso da sua rede doméstica? Aqui você aprenderá como transformar seu Raspberry Pi em um ponto de acesso Wi-Fi com portal cativo.
Leia também: Como instalar o Windows 11 em um Raspberry Pi 4
Por que eu preciso de um portal cativo?
Se você já tentou acessar uma rede Wi-Fi aparentemente aberta em um café, restaurante, hotel ou academia, apenas para ser recebido por uma tela de login que se recusa a deixá-lo prosseguir antes de inserir algumas informações (geralmente seu endereço de e-mail), então você já está familiarizado com portais cativos!
Um portal cativo é uma página da web que se abre automaticamente no navegador padrão do usuário ou carrega quando eles tentam visitar uma página da web. O usuário precisará geralmente completar uma ação antes de poder sair do portal cativo.
Embora sejam comumente utilizados por empresas, os portais cativos também podem ser uma adição útil à sua rede doméstica. Por exemplo, você pode criar uma rede separada para seus filhos, completa com controles parentais e um portal cativo que gentilmente lembra seus filhos que você confia neles para usar a web de forma responsável - apenas no caso de serem experientes o suficiente para saber como uma VPN funciona.
Leia também: Como programar um Arduino com um Raspberry Pi
O que você vai precisar
Para completar este tutorial, você vai precisar de:
- Raspberry Pi executando o Raspberry Pi OS
- Cabo de alimentação compatível com seu Raspberry Pi
- Teclado externo e uma forma de conectá-lo ao seu Raspberry Pi
- Cabo HDMI ou micro HDMI, dependendo do modelo do seu Raspberry Pi
- Monitor externo
- Cabo Ethernet. Como você está transformando seu Raspberry Pi em um ponto de acesso sem fio, será necessário conectar via Ethernet em vez de Wi-Fi. Isso também significa que não funcionará com Raspberry Pi 2 ou Raspberry Pi Zero, pois eles não têm um porta Ethernet ou cartão sem fio.
Começando: atualize seu Raspberry Pi
Conecte seu teclado externo, monitor e cabo Ethernet, e então conecte seu Pi a uma fonte de energia. Assim que ele iniciar, abra um terminal e digite o seguinte comando para atualizá-lo:
sudo apt update && sudo apt -y upgradeReinicie seu Raspberry Pi executando o seguinte comando:
sudo rebootUma vez que seu Raspberry Pi reinicie, tudo estará atualizado.
Configurando ponto de acesso sem fio para Raspberry Pi
Existem várias maneiras de transformar seu Raspberry Pi em um ponto de acesso totalmente funcional, mas neste tutorial será utilizado o RaspAP, pois é fácil de configurar.
Para instalar o software RaspAP, abra uma janela do Terminal e execute o seguinte comando:
curl -sL https://install.raspap.com | bash
Em seguida, reinicie seu Raspberry Pi usando o seguinte comando:
rebootUma vez que seu Raspberry Pi esteja de volta em funcionamento, seu ponto de acesso Wi-Fi será configurado com as seguintes configurações:
- Endereço IP: 10.3.141.1
- Nome de usuário: admin
- Senha: secret
- Faixa DHCP: de 10.3.141.50 a 10.3.141.255
- SSID: raspi-webgui
- Senha Wi-Fi: ChangeMe
Para colocar seu ponto de acesso à prova, basta pegar qualquer dispositivo habilitado para Wi-Fi e verificar suas configurações de rede. Você deve ver a opção de se conectar a uma nova rede “raspi-webgui”.

Conecte-se a essa rede e será solicitado uma senha. A senha padrão do RaspAP é “ChangeMe”, então digite isso na caixa de configuração de rede, clique em “Conectar” e você estará conectado ao seu novo ponto de acesso Raspberry Pi!
Proteja seu ponto de acesso Wi-Fi
Antes de seguir em frente, atualize “ChangeMe” para algo mais seguro, através da interface web do RaspAP:
Abra seu navegador web, se ainda não o fez.
Na barra de endereços, insira o seguinte: 10.3.141.1.
Quando solicitado, insira o nome de usuário “admin” e a senha “secret.” Agora você deve estar visualizando a interface web principal do RaspAP.

- No menu à esquerda, selecione “Hotspot -> Segurança.”

Encontre a seção “PSK” e insira a senha que você deseja usar para seu ponto de acesso Wi-Fi - certifique-se de que seja algo seguro!
Clique em “Salvar Configurações.”
Criando um portal cativo com Nodogsplash
Agora que seu ponto de acesso está em funcionamento, você está pronto para protegê-lo com um portal cativo.
O portal cativo será construído usando a solução de portal cativo Nodogsplash, mas primeiro você precisa instalar o pacote libmicrohttpd-dev, pois ele contém códigos que você usará para compilar o Nodogsplash.
No seu Raspberry Pi, execute o seguinte comando:
sudo apt install git libmicrohttpd-devUma vez que você tenha o pacote libmicrohttpd-dev, você pode clonar o repositório que contém todo o código do Nodogsplash:
cd ~
git clone https://github.com/nodogsplash/nodogsplash.gitUma vez que o Raspbian terminar de clonar este código, você está pronto para compilar e instalar o software Nodogsplash:
cd ~/nodogsplash
make
sudo make installO Nodogsplash agora está instalado no seu Raspberry Pi.
Configurando seu portal cativo
Em seguida, você precisa apontar o Nodogsplash na direção do endereço do Gateway, que é a interface do roteador que está conectada à rede local. O RaspAP usa 10.3.141.1 por padrão, então você precisa editar o arquivo de configuração do Nodogsplash para que ele escute neste endereço.
Para editar o endereço do Gateway, abra o arquivo de configuração do Nodogsplash:
sudo nano /etc/nodogsplash/nodogsplash.confAdicione o seguinte:
GatewayInterface wlan0
GatewayAddress 10.3.141.1
MaxClients 250
AuthIdleTimeout 480Depois de fazer essas alterações, salve seu arquivo pressionando Ctrl + O, seguido de Ctrl + X.
Inicie seu portal cativo executando o seguinte comando:
sudo nodogsplashSeu portal cativo agora está ativo. Para testá-lo, tente se conectar ao seu hotspot Wi-Fi.

Agora você deve ser recebido pelo portal cativo padrão do Nodogsplash.
Certifique-se de que seu portal esteja sempre online
Agora que você verificou que o portal cativo está funcionando corretamente, precisa garantir que o Nodogsplash comece automaticamente na inicialização.
Defina o Nodogsplash para iniciar automaticamente editando seu arquivo “rc.local”. No Terminal do Raspberry Pi, execute o seguinte comando:
sudo nano /etc/rc.localEncontre a seguinte linha:
exit 0Diretamente acima dela, adicione o seguinte:
nodogsplashSalve suas alterações pressionando Ctrl + O, seguido de Ctrl + X.
Como personalizar seu portal cativo
Nesse ponto, você tem um hotspot Wi-Fi que está protegido por um portal cativo. No entanto, você ainda está usando a página padrão do Nodogsplash, então nesta seção final, vamos olhar como você pode acessar o código que controla sua página do portal cativo e fazer algumas edições simples.
Para personalizar a página padrão do Nodogsplash, você precisará abrir o arquivo “splash.html”:
sudo nano /etc/nodogsplash/htdocs/splash.htmlAgora você pode adicionar imagens e texto ao seu portal e remover conteúdo existente. Por exemplo, na imagem abaixo, o texto que é exibido como parte do portal cativo está sendo alterado.

Quando estiver satisfeito com as edições que fez, salve suas alterações pressionando Ctrl + O, seguido de Ctrl + X.
Tente reconectar-se ao seu hotspot Wi-Fi e você deverá ver seu portal cativo renovado.

Observe que, dependendo do seu sistema operacional e navegador, você pode precisar limpar o cache do navegador para ver o portal cativo atualizado.
Além de um ponto de acesso Wi-Fi, você também pode transformar seu Raspberry Pi em um bloqueador de anúncios ou um servidor web pessoal.
Como você está usando seu portal cativo recém-criado? Para dar as boas-vindas às pessoas em sua rede doméstica, estabelecer algumas regras básicas ou como uma ferramenta para ajudar a promover seu negócio? Deixe-nos saber nos comentários abaixo!