Falta de luz no homelab? Como configurar nobreak via SNMP no Linux

Por que monitorar o nobreak via rede no seu homelab

Quem mantém um servidor caseiro ou um homelab sabe que a energia elétrica da rede concessionária nem sempre é confiable. Quedas repentinas e oscilações de tensão podem corromper bancos de dados, corromper partições ZFS e queimar fontes de alimentação sensíveis. Para mitigar esse risco, o uso de um nobreak, ou UPS (Uninterruptible Power Supply, um sistema de bateria que mantém os equipamentos ligados durante picos ou faltas de luz), é indispensável. Na prática, isso significa que seus servidores ganham uma sobrevida de alguns minutos para encerrar as atividades com elegância em vez de sofrerem um desligamento forçado.

No entanto, apenas ligar os servidores nas tomadas da bateria não resolve tudo. Se a queda de energia durar mais do que a autonomia das baterias, o nobreak simplesmente desligará por falta de carga, cortando a energia de forma abrupta. Para evitar isso, precisamos de uma ponte de comunicação entre o hardware de energia e os sistemas operacionais dos servidores. É aqui que entra o SNMP (Simple Network Management Protocol, um protocolo padrão da internet usado para coletar e organizar informações de dispositivos em redes IP), permitindo que o nobreak envie alertas de nível de bateria crítico diretamente para o Linux. Para estruturar uma infraestrutura robusta, é importante também planejar a resiliência da rede, conceito semelhante ao que discutimos sobre como garantir consistência em arquiteturas event-driven ao lidar com falhas distribuídas.

O papel do protocolo SNMP e do Network UPS Tools

O SNMP atua como um mensageiro universal na rede local. O nobreak possui uma placa de rede ou um software gerenciador que expõe métricas vitais — como carga da bateria, tensão de entrada e tempo restante — em formato de banco de dados conhecido como MIB (Management Information Base, um dicionário que padroniza o nome e o significado de cada dado do dispositivo). O seu servidor Linux pode consultar esses dados periodicamente ou receber armadilhas (traps) imediatas quando ocorre um evento adverso na rede elétrica.

Para traduzir esses alertas em ações práticas no sistema operacional, a ferramenta padrão da indústria no mundo open-source é o NUT (Network UPS Tools). O NUT é dividido em três camadas principais: o driver que conversa diretamente com a porta USB, serial ou placa SNMP da UPS; o servidor que centraliza essas informações; e os clientes que monitoram o status e executam scripts de segurança. Quando o NUT detecta que a bateria atingiu um patamar crítico, ele inicia uma rotina automatizada de desligamento ordenado, fechando containers Docker, desmontando volumes e parando serviços de forma segura.

Como instalar e configurar o NUT para monitorar via SNMP

Para colocar a automação em prática no Linux, o primeiro passo é instalar o pacote do Network UPS Tools na sua distribuição de preferência, como Debian ou Ubuntu. Abra o terminal com privilégios administrativos e execute os comandos abaixo para preparar o ambiente:

sudo apt update
sudo apt install nut nut-server nut-client

Com os binários instalados, o passo seguinte é configurar o arquivo de driver para que o NUT saiba falar com o seu nobreak via SNMP. Edite o arquivo de configuração de drivers localizado em /etc/nut/ups.conf e adicione a estrofe que define a conexão com o endereço IP da placa SNMP do seu nobreak.

[meunobreak]
driver = snmp-ups
port = 192.168.1.50
community = public
pollinterval = 10

Na prática, essa configuração instrui o driver snmp-ups a consultar o endereço IP 192.168.1.50 a cada dez segundos usando a comunidade SNMP padrão. Em seguida, configure o arquivo upsd.users para definir credenciais seguras de acesso e o arquivo nut.conf para definir o modo de operação do serviço como standalone ou síncrono com a rede.

Configurando o desligamento automático e testando o sistema

A etapa final da configuração envolve o arquivo upsmon.conf, onde determinamos o comportamento do cliente monitor. É aqui que definimos se o servidor deve apenas avisar os usuários ou executar um comando de desligamento definitivo quando a energia esgotar. Para garantir que o processo ocorra sem intervenção humana, especificamos as diretrizes de ação baseadas no estado da bateria.

No arquivo upsmon.conf, adicione a diretriz que monitora o nobreak configurado anteriormente, especificando o tipo de privilégio de acesso e o script de execução. O formato típico para o monitoramento local segue a estrutura abaixo:

MONITOR meunobreak@localhost 1 admin senha_segura master
SHUTDOWNCMD "/sbin/shutdown -h now"

Depois de ajustar todos os parâmetros e reiniciar os serviços do NUT com o comando sudo systemctl restart nut-server, o sistema estará pronto para proteger seu homelab. É recomendável realizar um teste prático desconectando o cabo de alimentação do nobreak da tomada da parede por alguns instantes (caso sua carga permita) para verificar se os logs do sistema registram o evento e se o gatilho de desligamento responde conforme o esperado, garantindo a integridade dos seus dados e a longevidade dos seus discos.

Considerações finais sobre resiliência em homelabs

Integrar um nobreak via SNMP no Linux transforma um simples sistema de bateria em um componente ativo e inteligente da sua infraestrutura residencial. Ao automatizar o desligamento seguro, você elimina o fator surpresa das quedas de energia e protege seus investimentos em hardware e armazenamento contra picos destrutivos. Manter o controle automatizado da energia é tão crucial para a saúde do ambiente quanto a escolha de ferramentas de automação e deploy, áreas em que a confiabilidade e a previsibilidade evitam dores de cabeça em manutenções futuras.