homedex
Homedex es un inventario de homelab que descubre automáticamente servicios, puertos y rutas desde Docker y reverse proxies. Ofrece una hoja de ruta de infraestructura sin agentes ni telemetría, con UI en Svelte y backend en Go sobre SQLite.
Ficha actualizada 22 sept 2026, 15:30 · upstream 21 sept 2026, 19:39 · release v0.1.5
Qué es homedex
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Homedex actúa como un libro mayor para tu homelab, registrando qué ejecuta dónde mediante descubrimiento automático de Docker y configuraciones de reverse proxy (Traefik, Caddy, Nginx). No gestiona el ciclo de vida de los contenedores ni monitoriza uptime; su propósito es registrar la infraestructura observada, incluyendo fechas de caducidad de certificados y rutas rotas.
El sistema utiliza un backend en Go con frontend Svelte y persistencia en SQLite. Soporta múltiples fuentes de datos como sockets Docker (mediante proxy seguro), SSH para hosts remotos y Tailscale. Incluye una API RESTful, exportación a Markdown/JSON y notificaciones vía Shoutrrr para alertas de caducidad o cambios.
La seguridad está priorizada con autenticación HTTP, cookies HttpOnly, CSRF y un proxy de socket que impide mutaciones en el Docker API. No incluye telemetría ni comprobadores de actualizaciones automáticos, requiriendo una configuración manual de conectores externos para fuentes adicionales.
- Inventario automático de servicios y contenedores activos en Docker
- Registro de rutas rotas y resolución de upstreams desde reverse proxies
- Gestión de fechas de caducidad de certificados TLS y dominios
- Auditoría de hosts remotos mediante SSH o Tailscale sin agentes
- Exportación de inventario para documentación o migraciones
- Alertas de cambios en la infraestructura mediante notificaciones configurables
- Descubrimiento read-only que evita riesgos de seguridad en el socket Docker
- Soporte nativo para múltiples reverse proxies (Traefik, Caddy, Nginx)
- UI reactiva en Svelte con búsqueda FTS y paleta de comandos
- Persistencia ligera en SQLite sin dependencias externas complejas
- Exportación segura con redacción automática de datos sensibles
- Arquitectura monolítica simple (un proceso Go) bajo 30 MiB
- No es un visualizador de topología ni diagramas de red
- Requiere configuración manual de conectores para fuentes externas
- Sin terminación de TLS nativa en el contenedor
- No realiza monitorización de uptime ni salud continua
- No gestiona acciones de ciclo de vida de contenedores (start/stop)
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 Compose, usando un proxy de socket para acceso read-only al API de Docker. Configurar HOMEDEX_PORT si 7377 está ocupado y HOMEDEX_SECURE_COOKIES=true para HTTPS. No exponer la UI sin autenticación; usar reverse proxy externo para TLS. Verificar SECURITY.md antes de despliegue en producción.
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.