WatchYourPorts
Inventario de puertos abiertos para servidores locales con monitorización continua. Exporta métricas a InfluxDB2 para visualización en Grafana. Incluye autenticación opcional y soporte nativo para Docker.
Ficha actualizada 18 sept 2026, 20:49 · upstream 19 sept 2025, 8:27 · release 0.1.2
Qué es WatchYourPorts
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
WatchYourPorts es una herramienta de monitorización diseñada para mantener un inventario preciso de los puertos abiertos en servidores locales. Utiliza escaneos periódicos (configurables) para verificar la disponibilidad de servicios específicos, almacenando el estado histórico en memoria y exportando datos a InfluxDB2.
La aplicación se ejecuta principalmente mediante contenedores Docker, ofreciendo una interfaz web accesible en el puerto 8853. Soporta temas personalizables vía Bootstrap y permite la integración con sistemas de autenticación externos como ForAuth o Authelia para restringir el acceso a la GUI.
Una característica destacada es su capacidad para importar automáticamente puertos desde instalaciones Docker existentes mediante un script de exportación, lo que facilita la gestión de flotas de servidores sin intervención manual constante. La interfaz permite consultar el estado actual de puertos individuales o agregados.
- Monitorización de disponibilidad de servicios en infraestructura local (LAN).
- Auditoría de seguridad para identificar puertos expuestos no deseados en servidores internos.
- Integración con dashboards de observabilidad existentes mediante InfluxDB2 y Grafana.
- Gestión centralizada del estado de múltiples hosts sin necesidad de instalar agentes.
- Soporte nativo para Docker (Dockerfile, Compose) y scripts de exportación de puertos.
- Exportación de métricas a InfluxDB2 compatible con la configuración estándar de Grafana.
- Interfaz web con soporte para temas Bootswatch y personalización de colores.
- API RESTful para consulta de estados de puertos e historial sin necesidad de GUI.
- Autenticación flexible mediante integración con ForAuth o proveedores SSO como Authelia.
- Requiere conexión a internet por defecto para descargar recursos (temas, iconos) a menos que se use el contenedor node-bootstrap.
- El escaneo de puertos es periódico (por defecto cada 10 minutos), no en tiempo real continuo.
- La base de datos histórica se almacena en memoria con un límite configurable (HIST_TRIM).
- Dependencia de Go y Node.js para el funcionamiento del backend y frontend respectivamente.
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.
Despliegue recomendado vía Docker o Docker Compose. Asegurar que el contenedor tenga acceso a la red local para escanear puertos (ej. -p 8853:8853). Configurar INFLUX_ENABLE en true y variables de conexión a InfluxDB2 si se desea persistencia de métricas. Para entornos offline, utilizar docker-compose-local.yml o montar el volumen node-bootstrap con recursos estáticos.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
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.