À medida que avançamos na construção do nosso servidor doméstico no Mini PC Intel N100, começamos a acumular diversas aplicações rodando em paralelo. Agora temos o Home Assistant na porta 8123, o Proxmox na porta 8006, o Node-RED na porta 1880 e, possivelmente, outras ferramentas como servidores de arquivos ou painéis de monitoramento.
O grande problema é que memorizar todos esses números de portas e endereços IPs (como 192.168.1.150:8006) é um teste de paciência para você e, principalmente, para a sua família. Além disso, acessar essas interfaces locais usando o protocolo HTTP padrão deixa as senhas expostas em texto puro dentro do Wi-Fi da casa.
Para resolver isso de forma elegante, profissional e centralizada, a ferramenta ideal é o Nginx Proxy Manager (NPM).
O Nginx Proxy Manager funciona como um “guarda de trânsito digital” com interface visual dentro do seu Mini PC. Ele permite que você substitua todos os IPs e portas complicados por subdomínios amigáveis e fáceis de digitar (como ha.casa.local, proxmox.casa.local ou nodered.casa.local), adicionando certificados de segurança SSL (HTTPS) gratuitos para cada um deles com apenas alguns cliques. Vamos aprender como estruturar essa central de gerenciamento no seu servidor local.
A Lógica do Proxy Reverso: O Guarda de Trânsito Digital
Para entender o papel do Nginx Proxy Manager, imagine que ele se posiciona na entrada do seu Mini PC, escutando todas as requisições que chegam pelas portas padrão de internet (Porta 80 para HTTP e Porta 443 para HTTPS).
Quando você ou alguém da sua família digita um endereço amigável no navegador, a requisição bate primeiro no Nginx Proxy Manager. Ele lê o nome do subdomínio digitado, consulta sua tabela interna e repassa o tráfego para a aplicação e a porta corretas de forma totalmente invisível para o usuário.
O processador Intel N100 gerencia esse fluxo com facilidade extrema. O Nginx é mundialmente conhecido por ser um servidor web ultra-leve, consumindo menos de 1% de processamento para redirecionar centenas de conexões simultâneas dentro da sua residência, garantindo que a navegação pelos seus painéis seja instantânea.
Preparativos e Requisitos Iniciais
Para seguir este guia, certifique-se de ter os seguintes pré-requisitos configurados:
- O seu Home Assistant rodando no Mini PC N100 sob o sistema Home Assistant OS (HAOS).
- Um domínio ou subdomínio configurado (você pode usar o mesmo domínio integrado à Cloudflare que configuramos nos artigos anteriores).
- O IP do seu Mini PC N100 deve estar configurado como IP Estático (Fixo) no roteador da sua operadora para evitar que ele mude sozinho.
Passo a Passo para Instalar e Configurar o Nginx Proxy Manager
A instalação via complemento oficial do Home Assistant OS centraliza o gerenciamento e facilita a integração com o hardware do Mini PC.
1. Instale o Add-on Oficial
No painel do seu Home Assistant, abra o navegador no seu computador pessoal:
- Vá em Configurações > Sistema > Complementos (Add-ons).
- Clique em Loja de Complementos no canto inferior direito.
- Procure por Nginx Proxy Manager na barra de pesquisa e clique sobre ele.
- Clique em Instalar e aguarde o download e a criação do container no SSD NVMe.
2. Ative as Portas de Rede no Roteador (Se Aplicável)
Para que o Nginx Proxy Manager consiga gerenciar o tráfego que vem de fora ou de subdomínios mapeados, ele precisa assumir o controle das portas de internet da máquina.
- Na página do add-on, vá na aba Configuração (Configuration).
- Certifique-se de que as portas de rede locais estão mapeadas corretamente (o padrão do add-on é escutar a porta 80 e 443 do Mini PC).
- Volte para a aba Informações, ative o Iniciar na inicialização e o Vigilância (Watchdog). Clique em Iniciar.
3. Primeiro Acesso e Alteração de Senha Padrão
Assim que o status do add-on ficar verde, clique em Abrir Interface Web (Open Web UI). O painel administrativo do NPM será aberto em uma nova aba do navegador.
- O sistema pedirá as credenciais de fábrica mundiais do Nginx Proxy Manager. Faça o login digitando exatamente os dados abaixo:
- Email: admin@example.com
- Password: changeme
- Imediatamente após o login, o assistente solicitará que você configure o seu nome, um e-mail de administrador real e mude a senha padrão de fábrica para uma senha forte de sua preferência. Faça a alteração e salve.
4. Criando o seu Primeiro Redirecionamento Amigável (Proxy Host)
Vamos configurar o Nginx para redirecionar o painel do seu Proxmox ou do próprio Home Assistant para um endereço limpo.
- No menu superior do NPM, clique em Hosts > Proxy Hosts.
- Clique no botão Add Proxy Host no canto superior direito.
- Na aba Details, preencha os campos da seguinte forma:
- Domain Names: Digite o endereço amigável que deseja usar (ex: ha.seu-dominio.com). Pressione Enter.
- Scheme: Selecione http (ou https caso a aplicação de destino exija, como o Proxmox).
- Forward Name/IP: Digite o endereço IP local fixo do seu Mini PC N100 (ex: 192.168.1.150).
- Forward Port: Digite a porta da aplicação (ex: 8123 para o Home Assistant).
- Marque as opções Block Common Exploits (para ativar a segurança contra invasões web básicas) e Websockets Support (essencial para o painel do Home Assistant e do Node-RED funcionarem em tempo real sem desconectar).
5. Ativando o Certificado de Segurança SSL (HTTPS) Gratuito
Não salve o formulário ainda. Vamos adicionar o cadeado de segurança criptografado para proteger as senhas da sua família.
- Clique na aba SSL dentro dessa mesma janela flutuante.
- Na lista suspensa SSL Certificate, selecione a opção Request a new SSL Certificate (Solicitar um novo certificado via Let’s Encrypt, que é 100% gratuito).
- Marque as opções Force SSL (para forçar o navegador a usar sempre a conexão segura HTTPS) e HTTP/2 Support.
- Marque a caixa declarando que aceita os termos de serviço do Let’s Encrypt e insira o seu e-mail.
- Clique em Save. O Nginx Proxy Manager conversará com os servidores do Let’s Encrypt em segundo plano, validará o seu domínio e gerará o certificado criptografado em poucos segundos.
O Ajuste de Segurança de Proxy no Home Assistant
Assim como fizemos no artigo do túnel, se você configurou o Nginx Proxy Manager para apontar para o próprio Home Assistant, o núcleo do sistema bloqueará o acesso por segurança até que você autorize o Nginx a repassar as conexões.
Abra o seu add-on File Editor, vá no arquivo configuration.yaml e adicione o IP do container do Nginx na lista de proxies confiáveis. Se você já adicionou a rede de containers anteriormente, o bloco deve ficar assim:
YAML
http:
use_x_forwarded_for: true
trusted_proxies:
– 172.30.33.0/24
Salve o arquivo, verifique a configuração em Ferramentas de Desenvolvedor e Reinicie o Home Assistant. A partir deste momento, você pode abrir qualquer dispositivo da casa, digitar o endereço limpo criado no navegador e acessar o seu servidor com design limpo, segurança criptografada e total elegância.
A organização da infraestrutura de rede local consolida a usabilidade e a segurança do seu projeto residencial. Deixar o seu servidor doméstico N100 operando baseado em decorba de números de portas e conexões abertas sem criptografia HTTP traz riscos de segurança e dificulta a adoção da tecnologia pelas outras pessoas da residência. Ao implementar o Nginx Proxy Manager como a sua central de rotas, você cria um mapa de navegação limpo, seguro e inteligente, garantindo que cada aplicação do seu ecossistema seja acessada com a máxima velocidade local que o hardware proporciona e a total proteção que a sua família merece.
