WatchYourLAN
WatchYourLAN es un escáner ligero de direcciones IP para redes locales con interfaz web. Escanea hosts, envía notificaciones y guarda historial en base de datos. Exporta métricas a Grafana vía InfluxDB o Prometheus. Ideal para monitorización de red en autoalojado.
Ficha actualizada 18 sept 2026, 19:12 · upstream 10 sept 2025, 12:08 · release 2.1.4
Qué es WatchYourLAN
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
WatchYourLAN es una herramienta de escaneo de red ligera escrita en Go, diseñada para identificar dispositivos activos en una red local mediante ARP. Proporciona una interfaz web intuitiva para visualizar el estado online/offline de los hosts y mantener un registro histórico de la actividad de la red. Su arquitectura permite configuraciones flexibles a través de variables de entorno, archivos de configuración o la propia interfaz gráfica.
La aplicación integra capacidades de notificación mediante Shoutrrr, permitiendo alertas en múltiples plataformas como Discord, Telegram, Email o Matrix cuando se detectan nuevos dispositivos o cambios de estado. Además, facilita la visualización avanzada de datos exportando métricas a InfluxDB2 o Prometheus para su posterior análisis en dashboards de Grafana.
El despliegue es sencillo mediante contenedores Docker con soporte para múltiples arquitecturas y sistemas operativos. Aunque no incluye autenticación nativa, se puede integrar fácilmente con soluciones SSO como Authelia o aplicaciones de autenticación externas. Requiere acceso a la red local y configuración adecuada de interfaces de red para funcionar correctamente.
- Monitorización continua de dispositivos conectados en una red doméstica o empresarial pequeña
- Detección automática de nuevos dispositivos en la red y alertas inmediatas por notificación
- Visualización histórica del estado de los hosts mediante dashboards en Grafana
- Escaneo de múltiples interfaces de red configuradas simultáneamente para cubrir segmentos VLAN
- Integración con sistemas de monitorización existentes como Prometheus o InfluxDB
- Uso en entornos autoalojados sin necesidad de dependencias complejas del sistema operativo
- Escaneo ligero y eficiente mediante la librería arp-scan, optimizado para redes locales
- Soporte nativo para múltiples bases de datos (SQLite o PostgreSQL) según necesidades de persistencia
- Integración flexible con Shoutrrr para notificaciones en más de 20 plataformas diferentes
- Interfaz web responsive con temas personalizables vía Bootswatch y modo oscuro/claro
- Exportación de métricas a InfluxDB2 y Prometheus para análisis avanzado en Grafana
- Soporte multi-arquitectura (amd64, arm64, etc.) y despliegue simplificado con Docker
- Requiere modo de red host en Docker, lo que expone el puerto directamente al sistema anfitrión
- No incluye autenticación integrada; es necesario configurar SSO externo para seguridad
- Dependencia externa de herramientas como arp-scan y tzdata en el sistema anfitrión o contenedor
- La interfaz web descarga recursos (iconos, fuentes) desde internet por defecto, afectando a redes aisladas
- El historial se almacena en base de datos, requiriendo gestión manual de limpieza para evitar crecimiento excesivo
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Desplegar con Docker usando modo host (--network="host") y configurar variables IFACES y TZ. Guardar datos en volumen persistente ($DOCKERDATAPATH/wyl:/data/WatchYourLAN). Para seguridad, limitar acceso al puerto 8840 mediante firewall o autenticación externa (Authelia/ForAuth). En redes aisladas, usar imagen node-bootstrap para recursos locales.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.