Repolode
Enviar
netalertx

netalertx/NetAlertX

Herramienta autohospedada de visibilidad de red que detecta dispositivos continuamente, señala cambios y envía alertas.

Alternativa open source a:Fing

Ver en GitHubSitio web
Estrellas
7,384
Forks
470
Issues abiertos
33
Último commit
hace 6 días

¿Qué es?

NetAlertX es una plataforma autohospedada para rastrear los dispositivos conectados a una o varias redes. Realiza análisis continuos para encontrar dispositivos nuevos y que vuelven a conectarse, detectar cambios en el estado de conexión y desviaciones en la gestión de direcciones IP (IPAM), y mantener un inventario centralizado de activos. Entre sus métodos de descubrimiento se incluyen arp-scan, la importación de datos de Pi-hole y de concesiones DHCP, la importación desde un controlador UniFi y desde routers con SNMP, además de un sistema de plugins para crear escáneres personalizados.

Cuando se produce un cambio, NetAlertX puede enviar notificaciones a través de más de 80 servicios mediante Apprise, además de Pushsafer, Pushover y NTFY. Los flujos de trabajo pueden clasificar automáticamente los dispositivos recién detectados, agruparlos por fabricante, quitar del archivo los que vuelven a estar en línea o eliminar las entradas obsoletas. Los datos se ofrecen mediante una API, webhooks, integración con Home Assistant y exportación de métricas de Prometheus.

Para proveedores de servicios gestionados y equipos NOC, los Sync Nodes permiten que los recopiladores de ubicaciones remotas, VLAN o sucursales envíen el inventario a un centro centralizado. De forma predeterminada, los datos de análisis se almacenan localmente. El proyecto se distribuye como una imagen Docker y también incluye documentación para la instalación en bare metal.

Funciones clave

  • 01Descubrimiento continuo mediante arp-scan e importaciones de Pi-hole, concesiones DHCP, UniFi y routers SNMP
  • 02Detección de cambios en dispositivos nuevos, estado de conexión y desviaciones de IPAM
  • 03Notificaciones mediante Apprise (más de 80 servicios), Pushover, Pushsafer y NTFY
  • 04Flujos de trabajo para clasificar, agrupar, quitar del archivo o eliminar dispositivos automáticamente
  • 05API, webhooks, integración con Home Assistant y exportación de métricas de Prometheus

Casos de uso

  • Detectar dispositivos no autorizados o de shadow IT en una red doméstica o de oficina
  • Rastrear cambios de dirección IP y mantener actualizado el inventario de dispositivos
  • Supervisar varias redes de clientes o sucursales desde un panel centralizado
  • Enviar alertas al teléfono o a aplicaciones de chat cuando se conectan dispositivos nuevos a la red

Inicio rápido

  1. 1

    Inicia NetAlertX con 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

    O clona el repositorio del código fuente

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

    Entra en el directorio del proyecto y compila con Docker Compose

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

Antes de usarlo

  • El escaneo de red requiere capacidades elevadas para el contenedor y el uso de la red del host en Linux.
  • Algunos escáneres, como ARP, pueden no detectar dispositivos en otras subredes.
  • Las redes que solo usan Wi-Fi pueden requerir escáneres alternativos para detectar dispositivos con precisión.
  • Si actualizas desde una versión anterior, debes seguir la guía de migración.

En colecciones

Apps autoalojadas

Temas

#network-monitoring#asset-management#network-discovery#ipam#selfhosted#docker#home-assistant#arp-scan#dcim#network-analysis

Preguntas frecuentes

¿Qué es NetAlertX?
Herramienta autohospedada de visibilidad de red que detecta dispositivos continuamente, señala cambios y envía alertas. NetAlertX es una plataforma autohospedada para rastrear los dispositivos conectados a una o varias redes. Realiza análisis continuos para encontrar dispositivos nuevos y que vuelven a conectarse, detectar cambios en el estado de conexión y desviaciones en la gestión de direcciones IP (IPAM), y mantener un inventario centralizado de activos. Entre sus métodos de descubrimiento se incluyen arp-scan, la importación de datos de Pi-hole y de concesiones DHCP, la importación desde un controlador UniFi y desde routers con SNMP, además de un sistema de plugins para crear escáneres personalizados.
¿NetAlertX es gratuito? ¿Qué licencia tiene?
NetAlertX es open source bajo la licencia GPL-3.0. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿NetAlertX sigue mantenido?
Mantenimiento activo. El último commit de NetAlertX fue el 1 nov 2026.
¿Para qué puedo usar NetAlertX?
Detectar dispositivos no autorizados o de shadow IT en una red doméstica o de oficina Rastrear cambios de dirección IP y mantener actualizado el inventario de dispositivos Supervisar varias redes de clientes o sucursales desde un panel centralizado Enviar alertas al teléfono o a aplicaciones de chat cuando se conectan dispositivos nuevos a la red
¿Cómo se instala NetAlertX?
Inicia NetAlertX con 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 O clona el repositorio del código fuente: git clone https://github.com/netalertx/NetAlertX.git Entra en el directorio del proyecto y compila con Docker Compose: cd NetAlertX && docker compose up --force-recreate --build
¿Dónde consigo NetAlertX?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/netalertx/NetAlertX

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados

netbox-community / netbox

Aplicación web open source que sirve como fuente de verdad para modelar y documentar infraestructura de red, con API REST y GraphQL para automatizar tareas.

DevOps y nube#network-automation#ipam#dcim
21,9 mil+52 esta semana3,2 milPythonApache-2.0Bien mantenidoActualizado hace 23 horas