NetAlertX: Monitorización y detección de dispositivos en red
Introducción
NetAlertX es una solución self‑hosted orientada a la detección y monitorización de dispositivos dentro de una red local. Su enfoque se centra en mantener un inventario dinámico de equipos conectados (LAN/WiFi), detectar cambios relevantes —nuevos dispositivos, desconexiones, variaciones de IP o estado— y generar alertas en tiempo real.
No se trata de un sistema de monitorización complejo tipo Prometheus/Zabbix, sino de una herramienta ligera orientada a visibilidad y control rápido de red. Resulta especialmente útil en entornos domésticos avanzados o laboratorios self‑hosted donde interesa saber qué está ocurriendo en la capa de red sin desplegar una pila completa de observabilidad.
Enfoque general
El servicio realiza escaneos periódicos sobre la red local utilizando distintos métodos (ARP, consultas activas, integraciones externas) y mantiene una base de datos interna con el estado histórico de cada dispositivo detectado.
A partir de esa información:
- Construye un inventario vivo de dispositivos.
- Detecta altas y bajas.
- Registra cambios de IP, nombre o fabricante.
- Permite definir reglas y notificaciones ante eventos concretos.
Dispone de un sistema de plugins que amplía sus capacidades, incluyendo integraciones con herramientas como Pi‑hole, controladores UniFi o sistemas de automatización como Home Assistant.
Requisitos previos
- Acceso a la red local donde se desea realizar la detección.
- Permisos suficientes para ejecutar escaneos de red (especialmente si se usa modo host en Docker).
- Persistencia de datos para mantener histórico y configuraciones.
Desarrollo
Qué se ha desplegado y por qué
NetAlertX se despliega como contenedor Docker independiente, aislado del resto de servicios pero con acceso directo a la red del host. Se opta por network_mode: host para simplificar la detección de dispositivos y evitar problemas derivados de NAT o redes bridge intermedias.
El objetivo no es exponerlo públicamente, sino utilizarlo como herramienta interna de visibilidad dentro de la LAN.
Configuración utilizada
La carpeta completa del servicio (incluyendo docker-compose.yml y configuraciones asociadas) se encuentra versionada en Gitea:
Aspectos relevantes de la configuración:
- Imagen estable
jokobsk/netalertx. - Modo de red
hostpara acceso directo a la pila de red del sistema. - Definición explícita de zona horaria.
- Persistencia de base de datos y configuración mediante volúmenes.
- Reinicio automático ante caída o reinicio del host.
Persistencia
Se mantienen dos volúmenes principales:
- Base de datos interna (histórico de dispositivos y eventos).
- Configuración personalizada (reglas, ajustes, parámetros de escaneo).
Esto permite actualizar la imagen sin perder estado ni histórico.
Validación
Comprobaciones básicas tras el despliegue:
- Interfaz web accesible en el puerto configurado.
- Detección inicial de dispositivos de la red.
- Registro de eventos en la base de datos.
- Generación correcta de notificaciones configuradas.
- Logs del contenedor sin errores críticos.
Decisiones importantes
- Uso de red en modo host: prioriza visibilidad y simplicidad frente a aislamiento estricto. En este contexto interno resulta aceptable.
- No exposición pública: el servicio está orientado a red local; no se publica tras proxy inverso ni autenticación externa.
- Ligereza frente a complejidad: se utiliza como complemento de seguridad y visibilidad, no como sustituto de sistemas de monitorización completos.
Resumen breve
NetAlertX proporciona inventario dinámico y alertas sobre cambios en la red local mediante un despliegue Docker ligero y persistente. Permite detectar dispositivos nuevos, caídas o modificaciones relevantes sin necesidad de una plataforma de monitorización pesada. Se integra bien en entornos self‑hosted donde la visibilidad de red es prioritaria.