Documentación del homelab savethemall.eu

Traducción automática del original francés.

Esta documentación describe el entorno tal como funciona: seis contenedores Docker, aproximadamente trescientos contenedores (recuento del 2026-10-06), un proxy inverso de dos niveles y una base de datos de identidad que gestiona los accesos.

Qué es esta documentación y qué no es

Es la versión revisada y publicada del conocimiento del entorno: lo que se debe saber para actuar sin causar problemas.

No es la memoria de trabajo. Los informes de incidentes, los registros de decisiones por pila y las preguntas frecuentes se encuentran en el repositorio Obsidian, y son consultables en el wiki. Una página publicada aquí es una página que alguien ha considerado estable; una nota del repositorio es un estado del conocimiento en un momento dado.

El intercambio exacto de roles, y la prueba que se resume en una frase: Dónde escribir qué.

Por dónde empezar

• Infraestructura

  Los contenedores, sus direcciones, qué se ejecuta en cada uno y dónde se almacenan los datos.

• Pilas

  Las convenciones Compose del entorno y el ciclo de vida de una pila, desde la creación hasta la desactivación.

• Red

  El camino de una solicitud desde Internet, la resolución DNS y su horizonte duplicado.

• Procedimientos

  Los pasos a seguir: publicar un servicio, parchear un contenedor, leer una clave.

Los cinco puntos clave para evitar errores

1. El borde WAN es el NAS, no vm-docker. Un filtrado L3 aplicado a vm-docker no bloque nada: la fuente que ve siempre es nas. Ver Servidor proxy inverso.
2. curl https://<fqdn> desde la red local no prueba el WAN. El DNS está en un horizonte doble. Ver DNS y resolución.
3. En el cofre, 10-stacks/<nom>/compose.yml es un enlace simbólico inactivo. El archivo real reside en el host. Ver Convenciones.
4. En vm-docker y vm-compute-01, restart: on-failure:5 y no always. docker-staggered.service es la única autoridad de inicio al arrancar.
5. Dos cofres: OpenBao para secretos de máquinas, Vaultwarden para secretos humanos. Vaultwarden ya está desbloqueado: nunca ejecutar bw unlock. Ver Leer un secreto del cofre.

Editar esta documentación

El contenido está escrito a mano en docs/ del repositorio homelab-docs. El procedimiento es en el README.md del repositorio, y la mecánica en Integración continua.

Este sitio no tiene una frecuencia de actualización

Se reconstruye únicamente con un push a main: de forma ocasional, nunca periódica. Sin cron, sin reconstrucción programada.

Esto es diferente del wiki (Wiki.js), que se sincroniza cada noche porque deriva del cofre — el cofre se mueve solo, por lo que el wiki debe volver a sincronizarse. Aquí nada puede cambiar sin un commit, y una reconstrucción horaria reconstruiría exactamente igual.

Consecuencia: modificar una nota en el cofre no actualiza esta documentación. Los dos no están conectados — ver la sección sobre la asignación de roles a continuación.

Dernière vérification de cette page : 2026-10-06