DockerMap
DockerMap es una aplicación web local para mapear la infraestructura de un servidor autoalojado. Proporciona visibilidad sobre contenedores Docker, archivos Compose, servicios del host (systemd, cron), puertos y logs.
Ficha actualizada 22 sept 2026, 18:12 · upstream 22 sept 2026, 17:15 · release v0.1.0-alpha.0
Qué es DockerMap
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
DockerMap es una aplicación web local diseñada para proporcionar una visión integral de lo que se ejecuta en un servidor autoalojado. Integra datos de Docker, archivos Compose, servicios del host como systemd o cron, y herramientas de red como Tailscale. Su objetivo principal es ayudar a los administradores a entender qué está corriendo, dónde residen los datos y cómo interactúan los componentes sin realizar cambios directos.
La arquitectura se basa en tres servicios principales: una aplicación web frontend desarrollada con React/Vite, una API backend en Node.js (Express) y un daemon escrito en Rust que inspecciona el runtime del host. Esta separación permite una gestión modular de las funciones de lectura y análisis. El sistema soporta despliegues aislados mediante Docker Compose o imágenes locales para compatibilidad.
En términos de seguridad, la herramienta adopta un enfoque defensivo por defecto. Se une al socket de Docker en modo solo lectura (ro) y requiere tokens Bearer para acceder a las rutas de la API. Las ediciones de archivos Compose se muestran como previsualizaciones secas (dry-run), evitando modificaciones accidentales. El daemon limita el acceso a la API de Docker a un inventario revisado, protegiendo contra operaciones no autorizadas.
- Auditoría de mounts y drift en volúmenes de datos
- Diagnóstico de servicios del host (systemd, cron, PM2) junto con contenedores
- Visualización de redes y puertos expuestos para seguridad perimetral
- Comparación entre la configuración declarada en Compose y el estado real de Docker
- Inspección de logs y señales de runtime sin necesidad de acceso root directo
- Integración como widget en dashboards de autoalojamiento (ej: Homepage)
- Arquitectura split con daemon en Rust para inspección eficiente del host
- Soporte nativo para múltiples ecosistemas: Docker, Compose, systemd, cron, Tailscale
- Seguridad read-only por defecto con autenticación Bearer obligatoria
- Capacidad de previsualizar cambios en mounts y reglas de routing antes de aplicarlos
- Widget API compatible con dashboards como Homepage para monitorización remota
- Fallback de datos mock explícito marcado para pruebas sin infraestructura Docker
- Requiere acceso al socket de Docker (/var/run/docker.sock) o modo mock explícito
- Funcionalidad read-only; no permite reiniciar, editar o eliminar contenedores directamente
- Dependencia de Node.js 22.x LTS y Rust con versión pinada en producción
- Los datos de inventario son snapshots del proceso daemon, no eventos persistentes
- Las rutas de la API requieren tokens Bearer configurados en variables de entorno seguras
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: usar Docker Compose aislado con DOCKERMAP_API_TOKEN y DOCKERMAP_DAEMON_TOKEN definidos fuera del checkout. Unir /var/run/docker.sock:ro. Ejecutar solo en loopback (127.0.0.1). Para desarrollo local, instalar dependencias (npm, Rust) y ejecutar npm run dev:stack. Verificar endpoints de salud antes de considerar el build como release.
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.