NetAlertX - Estrutura de Visibilidade de Rede & Inteligência de Ativos

📷 Clique para mais capturas de tela

Acesse https://netalertx.com/ para ainda mais gifs e capturas de tela 📷.

NetAlertX é uma plataforma de visibilidade de rede e inteligência de ativos para homelabs, equipes de TI, MSPs e ambientes distribuídos. Ela fornece visibilidade centralizada de rede e descoberta contínua de ativos em sites remotos, VLANs, filiais e redes segmentadas a partir de uma única interface.

O NetAlertX oferece uma fonte única da verdade em tempo real para dispositivos conectados, ajuda a identificar TI oculta e hardware não autorizado, apoia iniciativas de conformidade e automatiza fluxos de trabalho operacionais em ambientes de cliente distribuídos.

Use o NetAlertX para detectar TI oculta, hardware não autorizado, desvios de IPAM e outras mudanças importantes para equipes de serviço. Com sincronização multissite, relatórios, fluxos de trabalho e webhooks, ajuda os MSPs a ficarem à frente dos problemas sem a sobrecarga de um NMS ou SIEM completo.

Índice

• Início Rápido
• Funcionalidades
• Documentação
• Segurança & Privacidade
• FAQ
• Dicas de Solução de Problemas
• Todo o resto

Início Rápido

[!WARNING] ⚠️ Importante: O docker-compose foi alterado recentemente. Leia atentamente o Guia de migração para instruções detalhadas.

Inicie o NetAlertX em segundos com Docker:

docker run -d \
  --network=host \
  --restart unless-stopped \
  -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

Nota: Seu /local_data_dir deve conter uma pasta config e db.

Para implantar uma instância conteinerizada diretamente do repositório de origem, execute a seguinte sequência BASH:

git clone https://github.com/netalertx/NetAlertX.git
cd NetAlertX
docker compose up --force-recreate --build
# Para personalizar: edite o docker-compose.yaml e execute o último comando novamente

Precisa de ajuda para configurá-lo? Consulte o guia de uso ou a documentação completa.

Para usuários do Home Assistant: Clique aqui para adicionar o NetAlertX

Para outros métodos de instalação, consulte a documentação de instalação

|| Guia Docker || Lançamentos || Documentos || Plugins || Site

Funcionalidades

Descoberta e Inteligência de Ativos

Monitoramento contínuo para descoberta de ativos não autorizados, mudanças de estado de conexão e desvios de gerenciamento de endereços IP (IPAM). Métodos de descoberta e varredura incluem: arp-scan, Pi-hole - importação de BD, Pi-hole - importação de concessões DHCP, Importação de concessões DHCP genéricas, Importação do controlador UNIFI, Importação de roteador habilitado para SNMP. Consulte a documentação de Plugins para uma lista completa de plugins disponíveis.

Gateways de notificação

Envie notificações para mais de 80+ serviços, incluindo Telegram via Apprise, ou use publicadores nativos Pushsafer, Pushover ou NTFY.

Integrações e Plugins

Alimente seus dados e mudanças de dispositivo no Home Assistant, leia endpoints da API ou use Webhooks para configurar fluxos de automação personalizados. Você também pode criar seus próprios scanners com o sistema de Plugins em apenas 15 minutos.

Fluxos de trabalho

O módulo de fluxos de trabalho automatiza a governança de TI aplicando políticas de categorização e limpeza de dispositivos. Seja para atribuir dispositivos recém-descobertos a um Nó de Rede específico, agrupar automaticamente dispositivos de um determinado fornecedor, desarquivar um dispositivo se detectado online ou excluir dispositivos automaticamente, este módulo oferece flexibilidade para adaptar as automações às suas necessidades.

Monitoramento MSP e Multissite

O NetAlertX permite monitoramento centralizado em sites remotos e ambientes isolados através de Nós de Sincronização para VLANs e filiais, fornecendo visibilidade unificada de ativos em várias redes. Ele suporta painéis estilo NOC, exportação de métricas Prometheus, automação de fluxo de trabalho para governança de dispositivos e descoberta distribuída com alerta centralizado para operações de rede escaláveis.

Documentação

Explore toda a documentação aqui ou navegue para uma opção de instalação específica abaixo.

Navegadores suportados: Chrome, Firefox

• [Instalação] Docker
• [Instalação] Home Assistant
• [Instalação] Bare metal
• [Instalação] Unraid App
• [Configuração] Uso e Configuração
• [Desenvolvimento] Documentação da API
• [Desenvolvimento] Plugins Personalizados

Segurança & Privacidade

O NetAlertX escaneia sua rede local e pode armazenar metadados sobre dispositivos conectados. Por padrão, todos os dados são armazenados localmente. Nenhuma informação é enviada para serviços externos a menos que você configure explicitamente notificações ou integrações.

Conformidade e Endurecimento:

• Execute atrás de um proxy reverso com autenticação
• Use firewalls para restringir o acesso à interface web
• Atualize regularmente para a versão mais recente para patches de segurança
• Controle de Acesso Baseado em Funções (RBAC) via Proxy Reverso: Integre com seu provedor SSO/Identidade existente para acesso seguro ao painel.

Consulte Melhores Práticas de Segurança para mais detalhes.

Projetado para MSPs, NOCs e Redes Distribuídas

O NetAlertX suporta monitoramento centralizado em VLANs, filiais, ambientes de cliente, redes isoladas e sites remotos.

Usando Nós de Sincronização, coletores distribuídos enviam com segurança dados de inventário de dispositivos e visibilidade de rede de volta para um hub central, permitindo monitoramento, alerta e rastreamento de ativos unificados em todos os locais.

Isso fornece a MSPs e NOCs uma visão operacional única de muitas redes independentes, sem exigir acesso direto ou infraestrutura de varredura centralizada.

Implantações comuns incluem painéis MSP, painéis NOC, monitoramento de inventário multissite e descoberta de escritórios remotos.

FAQ

P: Como monitorar VLANs ou sub-redes remotas? R: Certifique-se de que o contêiner tenha acesso adequado à rede (por exemplo, use --network host no Linux). Verifique também se o método de varredura está configurado corretamente na interface.

P: Qual é a implantação recomendada para alta disponibilidade? R: Recomendamos implantar via Docker com volumes persistentes para integridade do banco de dados e executar atrás de um proxy reverso para acesso seguro.

P: Isso enviará algum dado para a internet? R: Não. Todas as varreduras e dados permanecem locais, a menos que você configure notificações baseadas em nuvem.

P: Posso usar isso sem Docker? R: Você pode instalar o aplicativo diretamente em seu próprio hardware seguindo o guia de instalação bare metal.

P: Onde os dados são armazenados? R: Nas pastas /data/config e /data/db. Faça backup dessas pastas regularmente.

Dicas de Solução de Problemas

• Alguns scanners (por exemplo, ARP) podem não detectar dispositivos em sub-redes diferentes. Veja o guia de redes remotas para soluções alternativas.
• Redes apenas Wi-Fi podem exigir scanners alternativos para detecção precisa.
• A limitação de notificações pode ser necessária em redes grandes para evitar spam.
• Em alguns sistemas, permissões elevadas (como CAP_NET_RAW) podem ser necessárias para varredura de baixo nível.

Verifique os Problemas no GitHub para os relatórios de bugs e soluções mais recentes e consulte a documentação oficial.

Todo o resto

📧 Seja notificado sobre novidades

Receba notificações sobre novos lançamentos, novas funcionalidades disponíveis e mudanças importantes.

🔀 Outros Aplicativos Alternativos

• Fing - Aplicativo de scanner de rede para segurança da Internet (Comercial, Aplicativo de telefone, Hardware proprietário)
• NetBox - O padrão ouro para Fonte da Verdade de Rede (NSoT) e IPAM.
• Zabbix ou Nagios - Foco forte em monitoramento de infraestrutura.
• Domotz - Plataforma comercial de monitoramento e gerenciamento remoto voltada para MSPs, equipes de TI e ambientes multissite.
• NetAlertX - A escolha simplificada e focada em descoberta para inteligência de ativos em tempo real e alertas sem ruído.

💙 Doações

Obrigado a todos que apreciam esta ferramenta e doam.

Clique para mais formas de doar

---

• Bitcoin: 1N8tupjeCK12qRVU2XrV17WvKK7LCawyZM
• Ethereum: 0x6e2749Cb42F4411bc98501406BdcD82244e3f9C7

📧 Envie um e-mail para [email protected] se quiser entrar em contato ou se devo adicionar outras plataformas de patrocínio.

🏗 Contribuidores

Este projeto não seria nada sem o trabalho incrível da comunidade, com agradecimentos especiais a:

pucherot/Pi.Alert (o criador original do PiAlert), leiweibau: Modo escuro (e muito mais), Macleykun (Ajuda com a limpeza do Dockerfile), vladaurosh pela ajuda com a re-base Alpine, Final-Hawk (Ajuda com NTFY, estilização e outras correções), TeroRERO (Traduções em espanhol), Data-Monkey (Divisão do arquivo python.py e mais), cvc90 (Tradução em espanhol e vários trabalhos na interface) para citar alguns. Confira todos os contribuidores incríveis.

🌍 Traduções

Usando orgulhosamente Weblate. Ajude e sugira idiomas no portal online do Weblate.

Licença

GPL 3.0 | Leia mais aqui | Fonte do GIF animado (Animação de carregamento) | Fonte das Fontes auto-hospedadas

Todos os nomes de produtos, logotipos e marcas são propriedade de seus respectivos proprietários. Todos os nomes de empresas, produtos e serviços usados neste site são apenas para fins de identificação. O uso desses nomes, logotipos e marcas não implica endosso.