Ctrl K
ComunidadGuías…
GITHUB · ANALIZADO

infrastructure

Infraestructura de homelab completa basada en Kubernetes con Talos Linux y GitOps sobre Proxmox. Arquitectura segura sin puertos abiertos, usando pfSense y Tailscale para acceso remoto. Incluye gestión de almacenamiento ZFS y backups automatizados a nube.

Ficha actualizada 25 sept 2026, 18:03 · upstream 25 sept 2026, 1:47 · release sin release detectada

Ver códigoProblemas y ayudaRepositorio ↗Sitio oficial
00

Qué es infrastructure

Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.

Este repositorio define una infraestructura de homelab de producción lista para Kubernetes utilizando Talos Linux y GitOps con Flux. La arquitectura se basa en tres hosts Proxmox independientes, cada uno ejecutando un nodo Kubernetes, evitando corosync para alta disponibilidad de etcd. Todo el estado es reproducible mediante git push, eliminando la necesidad de scripts manuales complejos.

La seguridad es prioritaria: no hay puertos abiertos a internet, usando pfSense como router y Tailscale para acceso remoto seguro. El almacenamiento utiliza ZFS en pve-2 con RAIDZ2 para medios masivos y espejo SSD para datos diarios. Los backups se gestionan con restic hacia un VPS de Oracle y un Synology, asegurando copias fuera del sitio.

Los casos de uso incluyen despliegues de servicios como Jellyfin, Authentik y Pi-hole en contenedores o VMs. La recuperación ante desastres está documentada paso a paso, permitiendo reconstruir la infraestructura desde cero en aproximadamente 35 minutos si se poseen los secretos necesarios.

CASOS DE USO
  • Despliegue reproducible de clúster Kubernetes multi-nodo con Talos Linux
  • Gestión de servicios de homelab sin exposición a internet
  • Automatización de backups y recuperación ante desastres con Restic
  • Red privada segura mediante pfSense y Tailscale
PUNTOS DESTACADOS
  • Arquitectura GitOps pura donde el repositorio es la única fuente de verdad
  • Diseño Zero Trust con cero puertos abiertos y acceso exclusivo vía Tailscale
  • Almacenamiento ZFS optimizado con separación entre datos calientes y fríos
  • Playbooks documentados para recuperación de desastre en orden estricto
PRECAUCIONES
  • Alta complejidad técnica que requiere conocimientos avanzados de Kubernetes y Proxmox
  • Dependencia crítica de secretos externos no incluidos en el repositorio
  • No soporta despliegue automático, requiriendo configuración manual inicial
01

Perfil de infraestructura

Estimación inicial derivada del repositorio y de los servicios detectados.

CPU4 vCPUrecomendación inicial
MEMORIA8 GBRAM estimada
DISCO10 GBalmacenamiento base
COMPLEJIDADhighnivel de operación
02

Despliegue detectado

Qué señales reales de instalación hemos encontrado.

Despliegue manual

Leer DEPLOY.md antes de empezar. Se necesitan age.key y contraseña restic fuera del repositorio. Orden de reconstrucción: pfSense -> pve-2 (restic) -> Kubernetes. El VPS es independiente para recuperación rápida.

—Dockerfile
—Compose
—One-click
03

Stack y dependencias

Componentes inferidos a partir de manifests, configuración y documentación.

FRAMEWORKS
Node.js
SERVICIOS
No detectados
BASES DE DATOS
No detectadas
PUERTOS
No detectados
05

Puede sustituir a

Relaciones detectadas por el análisis del repositorio y su categoría.

06

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.