homelab
Homelab con cluster k3s de 4 nodos, basado en principios de GitOps y FluxCD. Incluye control plane, workers, NAS Ugreen DH4300 Plus y TrueNAS Scale como backup.
Ficha actualizada 22 sept 2026, 18:34 · upstream 22 sept 2026, 16:53 · release sin release detectada
Qué es homelab
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Este repositorio describe un homelab diseñado para ejecutar un cluster Kubernetes ligero (k3s) con 4 nodos: uno de control plane en una VM Proxmox y tres workers también en máquinas virtuales o hardware bare-metal. El sistema se gestiona mediante GitOps utilizando FluxCD, lo que permite automatizar la creación, escalado y mantenimiento del cluster. La infraestructura incluye un servidor NAS Ugreen DH4300 Plus para almacenamiento de archivos y una réplica TrueNAS Scale como servidor de respaldo. Se implementa un esquema de backup en tres niveles: base de datos PostgreSQL con recuperación punto a punto (PITR) en Cloudflare R2, volúmenes persistentes con snapshots en Longhorn, y copias de seguridad de archivos mediante Restic sincronizado con Google Drive.
- Ejecución de aplicaciones web y microservicios
- Desarrollo y pruebas de software
- Servicio de almacenamiento NAS compartido
- Reproducción de contenido multimedia (imágenes, música)
- Monitoreo y análisis de datos
- Entorno de desarrollo local con herramientas de CI/CD
- Implementación completa de GitOps mediante FluxCD para automatización del ciclo de vida del cluster
- Diseño dual de DNS (AdGuard Home + Cloudflare) que permite acceso interno y externo desde la misma red sin necesidad de Ingress
- Backup en tres capas: base de datos con PITR, volúmenes persistentes con snapshots y copias de seguridad de archivos
- Arquitectura de control plane separada (Proxmox VM) con workers independientes para mayor escalabilidad
- Uso de Longhorn como almacenamiento distribuido con soporte para múltiples tipos de PVCs
- No se incluye un sistema de autenticación centralizado, por lo que el acceso a los recursos debe ser gestionado manualmente mediante SSH o certificados
- El cluster k3s no tiene provisionamiento automático de IPs públicas ni DNS externo sin configuración adicional
- La sincronización de datos entre NAS y Google Drive se realiza cada 2 días, lo que puede generar retrasos en la disponibilidad de archivos
- No se incluye un sistema de monitoreo o alerting centralizado para el cluster k3s
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.
Para desplegar este homelab, se recomienda instalar FluxCD en una máquina control plane (Proxmox VM) y ejecutar las plantillas de bootstrap. Se debe configurar sops con la clave de edad generada por age para proteger los secretos del cluster. Es importante mantener el repositorio sincronizado con Git y actualizar el FluxCD cada vez que se actualice el código. Para acceder a servicios internos, se requiere un DNS externo (AdGuard o Cloudflare) configurado como proveedor de registros A. Se recomienda ejecutar las herramientas de seguridad (precommit, age) antes de cualquier operación crítica del cluster.
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.