netalertx/NetAlertX

O que é?

Recursos principais

• 01Descoberta contínua com arp-scan e importações do Pi-hole, de concessões DHCP, do UniFi e de roteadores SNMP
• 02Detecção de alterações em novos dispositivos, no estado da conexão e em divergências de IPAM
• 03Notificações via Apprise (mais de 80 serviços), Pushover, Pushsafer e NTFY
• 04Fluxos de trabalho que categorizam, agrupam, desarquivam ou excluem dispositivos automaticamente
• 05API, webhooks, integração com Home Assistant e exportação de métricas do Prometheus

Casos de uso

• Identificar dispositivos não autorizados ou de shadow IT em redes domésticas ou de escritórios
• Monitorar alterações de endereços IP e manter um inventário atualizado de dispositivos
• Monitorar várias redes de clientes ou filiais em um único painel central
• Enviar alertas para aplicativos de celular ou de chat quando novos dispositivos entram na rede

Início rápido

1. 1

   Inicie o NetAlertX com Docker

   docker run -d --network=host --restart unless-stopped --cap-add=NET_RAW --cap-add=NET_ADMIN --cap-add=NET_BIND_SERVICE -v /local_data_dir:/data -v /etc/localtime:/etc/localtime:ro --tmpfs /tmp:uid=20211,gid=20211,mode=1700 -e PORT=20211 -e APP_CONF_OVERRIDE='{"GRAPHQL_PORT":"20214"}' ghcr.io/netalertx/netalertx:latest
2. 2

   Ou clone o repositório do código-fonte

   git clone https://github.com/netalertx/NetAlertX.git
3. 3

   Entre no diretório do projeto e compile com Docker Compose

   cd NetAlertX && docker compose up --force-recreate --build

Antes de usar

• !A varredura de rede requer recursos elevados no contêiner e o uso da rede do host no Linux.
• !Alguns scanners, como o ARP, podem não detectar dispositivos em outras sub-redes.
• !Redes que usam apenas Wi-Fi podem exigir scanners alternativos para uma detecção precisa.
• !Quem estiver atualizando de versões anteriores deve seguir o guia de migração.

Em coleções

Tópicos

Perguntas frequentes

O que é NetAlertX?

Ferramenta de visibilidade de rede auto-hospedada que descobre continuamente dispositivos, identifica alterações e envia alertas. NetAlertX é uma plataforma auto-hospedada para monitorar os dispositivos conectados a uma ou mais redes. Ela executa varreduras contínuas para encontrar dispositivos novos e que retornaram, detecta mudanças no estado da conexão e divergências no gerenciamento de endereços IP (IPAM), além de manter um inventário central de ativos. Os métodos de descoberta incluem arp-scan, importação de dados do Pi-hole e de concessões DHCP, importação de um controlador UniFi e de roteadores com SNMP, além de um sistema de plugins para criar scanners personalizados.

NetAlertX é gratuito? Qual é a licença?

NetAlertX é open source sob a licença GPL-3.0. Confira os termos da licença antes de usá-lo em produtos comerciais.

NetAlertX ainda é mantido?

Manutenção ativa. O último commit de NetAlertX foi em 1 de nov. de 2026.

Para que posso usar NetAlertX?

Identificar dispositivos não autorizados ou de shadow IT em redes domésticas ou de escritórios Monitorar alterações de endereços IP e manter um inventário atualizado de dispositivos Monitorar várias redes de clientes ou filiais em um único painel central Enviar alertas para aplicativos de celular ou de chat quando novos dispositivos entram na rede

Como instalar NetAlertX?

Inicie o NetAlertX com Docker: docker run -d --network=host --restart unless-stopped --cap-add=NET_RAW --cap-add=NET_ADMIN --cap-add=NET_BIND_SERVICE -v /local_data_dir:/data -v /etc/localtime:/etc/localtime:ro --tmpfs /tmp:uid=20211,gid=20211,mode=1700 -e PORT=20211 -e APP_CONF_OVERRIDE='{"GRAPHQL_PORT":"20214"}' ghcr.io/netalertx/netalertx:latest Ou clone o repositório do código-fonte: git clone https://github.com/netalertx/NetAlertX.git Entre no diretório do projeto e compile com Docker Compose: cd NetAlertX && docker compose up --force-recreate --build

Onde consigo NetAlertX?

O código-fonte e as instruções de instalação estão no GitHub: https://github.com/netalertx/NetAlertX