proxmox-homelab-automation
Automatización basada en shell para despliegue de servicios Docker Compose en contenedores LXC no privilegiados sobre Proxmox VE 9.x con ZFS, gestión de firewall y sincronización de drivers NVIDIA.
Ficha actualizada 24 sept 2026, 5:33 · upstream 24 sept 2026, 5:14 · release sin release detectada
Qué es proxmox-homelab-automation
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Este repositorio proporciona una solución completa para gestionar un homelab personal basado en Proxmox VE, organizando cargas de trabajo en siete contenedores LXC dedicados: gateway, media, utility, desktop, AI, development y gaming. La arquitectura utiliza ZFS como sistema de archivos con pools separados (fastpool para configuración y estado de aplicaciones, datapool para datos masivos) y snapshots gestionados por sanoid para recuperación rápida ante errores locales.
La automatización se centra en el ciclo de vida de los contenedores LXC, la instalación y gestión de Docker Compose stacks, la aplicación dinámica de reglas de firewall y la sincronización de bibliotecas NVIDIA para aceleración hardware. Los secretos de despliegue están cifrados con AES-256-CBC y descifrados en tiempo de ejecución mediante una clave maestra, minimizando la exposición de credenciales en repositorios o logs.
El sistema incluye herramientas específicas para gestión de GPU passthrough, incluyendo hooks de inicio para validación de drivers NVIDIA y sincronización de bibliotecas en el espacio de usuario del contenedor. Los backups se realizan mediante Restic/Backrest con cifrado y replicación a destinos remotos como Oracle VPS o Google Drive, asegurando resiliencia ante fallos del nodo físico.
- Despliegue automatizado de stacks de servicios en contenedores LXC no privilegiados mediante scripts shell
- Gestión de ciclo de vida de LXCs con creación, actualización y redeploy rápido de Docker Compose
- Configuración automática de reglas de firewall para tráfico entre servicios, monitorización y acceso remoto
- Sincronización de drivers NVIDIA y bibliotecas en contenedores LXC para aceleración GPU específica
- Gestión de backups cifrados con Restic/Backrest y replicación a múltiples destinos remotos
- Encapsulación de secretos mediante cifrado AES-256-CBC con PBKDF2-HMAC-SHA256 (600k iteraciones)
- Scripts modulares para despliegue rápido y redeploy sin intervención manual en la mayoría de operaciones
- Recuperación rápida mediante snapshots ZFS gestionados por sanoid para rollback local inmediato
- Hooks de inicio personalizados para validación de drivers NVIDIA y sincronización de bibliotecas
- Redes Docker dedicadas por LXC para aislamiento de dependencias entre servicios
- Dependencia crítica de Proxmox VE 9.x con ZFS; no es compatible con sistemas de archivos alternativos o versiones anteriores
- Configuración específica para GPU NVIDIA GTX 970 con driver 580; no es genérica para otras GPUs o drivers
- Arquitectura de nodo único sin alta disponibilidad (HA); fallo del host implica downtime total de servicios
- Requiere configuración manual inicial de pools ZFS, reglas de firewall y clave maestra antes del despliegue
- Algunos scripts dependen de herramientas específicas como Tailscale o Cloudflare Tunnel que pueden no estar disponibles en todos los entornos
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.
Ejecutar installer.sh en la host Proxmox tras configurar pools ZFS fastpool/datapool, instalar drivers NVIDIA y preparar reglas de firewall. Mantener clave maestra separada de backups. Validar snapshots ZFS y backups remotos antes de producción. Adaptar configuración de red, GPU y secretos según entorno objetivo.
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.