homelab
Cluster Kubernetes en Talos Linux para homelab, gestionado con GitOps (Flux), Renovate y GitHub Actions. Incluye almacenamiento distribuido con Rook y exposición de servicios vía Cilium Gateway, Tailscale o Cloudflare Tunnel.
Ficha actualizada 22 sept 2026, 15:30 · upstream 21 sept 2026, 19:44 · release 2026.9.0
Qué es homelab
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Este repositorio documenta una infraestructura de homelab basada en Kubernetes que corre sobre Talos Linux, una distribución inmutable diseñada para entornos de producción. La configuración se gestiona mediante prácticas de GitOps utilizando Flux como controlador principal y Renovate para la actualización automática de dependencias. El almacenamiento persistente se implementa a través de Rook, proporcionando soluciones escalables para bloques, archivos y objetos, complementado por un NAS Synology externo gestionado vía CSI personalizado.
La arquitectura de red es sofisticada, permitiendo la exposición de aplicaciones mediante tres métodos distintos: localmente en la LAN, de forma privada a través de Tailscale con MagicDNS personalizado, o públicamente utilizando Cloudflare Tunnel para proteger los endpoints web y webhooks. Se utilizan herramientas como Cert Manager para la gestión automática de certificados TLS y External-DNS para sincronizar registros DNS dinámicamente.
El enfoque del proyecto prioriza la seguridad, la automatización y la resiliencia, con un diseño que permite una desmontada completa sin pérdida de datos. La estructura del repositorio sigue estándares de IaC (Infrastructure as Code) utilizando Kustomize para modularizar las aplicaciones y componentes, asegurando una gestión limpia y escalable de los recursos dentro del clúster.
- Gestión de un clúster Kubernetes en bare-metal con Talos Linux
- Automatización de actualizaciones de dependencias y configuración mediante Renovate y Flux
- Implementación de almacenamiento persistente distribuido con Rook (Ceph)
- Exposición segura de servicios internos a través de Tailscale o Cloudflare Tunnel
- Gestión centralizada de secretos utilizando 1Password Connect vía External Secrets
- Monitorización del clúster y métricas de infraestructura mediante dashboards personalizados
- Uso de Talos Linux para un sistema operativo inmutable y seguro en Kubernetes
- Implementación completa de GitOps con FluxCD para la gestión declarativa del clúster
- Automatización de renovación de certificados SSL mediante Cert Manager
- Arquitectura de red híbrida que soporta LAN, Tailscale y Cloudflare Tunnel
- Almacenamiento resiliente gestionado por Rook sin dependencias externas críticas para el clúster principal
- Integración con Synology NAS mediante CSI driver personalizado para almacenamiento externo
- Requiere conocimientos avanzados de Kubernetes y GitOps para su mantenimiento
- Dependencia de hardware específico (Minisforum MS-01) para la configuración actual
- Configuración de red compleja que puede no ser trivial en entornos domésticos estándar
- Uso de herramientas específicas como Cilium o Talos que tienen curvas de aprendizaje pronunciadas
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.
Se recomienda leer la documentación de Talos y Flux antes de intentar el despliegue. El repositorio no es un script de instalación "one-click", sino una referencia para configurar manualmente o adaptar los manifiestos Kustomize. Asegurar que el hardware soporte virtualización y tenga conectividad de red adecuada para Tailscale o Cloudflare.
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.