homeserver-ansible
Playbook de Ansible para configurar un home server/NAS en Ubuntu Server LTS 22.04, instalando Docker, Traefik como proxy inverso y Authelia para autenticación con 2FA.
Ficha actualizada 18 sept 2026, 21:40 · upstream 19 jun 2026, 16:53 · release sin release detectada
Qué es homeserver-ansible
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Este repositorio contiene playbooks de Ansible diseñados para automatizar la configuración completa de un servidor doméstico o NAS. El playbook instala Docker en Ubuntu Server LTS 22.04, configura Traefik como proxy inverso SSL/TLS y despliega una pila completa de servicios auto-alojados con autenticación centralizada mediante Authelia.
La arquitectura utiliza Cloudflare para terminación SSL/TLS con modo Full, lo que proporciona protección DDoS y certificados SSL gratuitos. El playbook incluye roles de seguridad basados en las mejores prácticas de Jeff Geerling y permite habilitar servicios como Minecraft (con soporte Bedrock/Java), Transmission, y otros servicios comunes de homelab.
La configuración se gestiona mediante tres archivos: vars.yml para valores compartidos no secretos, local.yml para valores específicos del host, y vault.yml encriptado para credenciales. El despliegue requiere conocimientos básicos de SSH, TCP/UDP, Ansible y Linux.
- Configuración inicial automatizada de un home server con Ubuntu Server LTS 22.04
- Despliegue de múltiples servicios auto-alojados mediante Docker con gestión centralizada
- Implementación de autenticación única y 2FA para todos los servicios web a través de Authelia
- Configuración de proxy inverso SSL/TLS con Cloudflare para protección y certificados gratuitos
- Preparación de servidor Minecraft multiplataforma (Bedrock/Java) con Geyser y Floodgate
- Automatización completa mediante Ansible con roles preconfigurados y gestión de dependencias vía ansible-galaxy
- Integración nativa con Cloudflare para SSL/TLS Full mode, DDoS protection y DNS management
- Autenticación centralizada con Authelia soportando múltiples métodos 2FA (TOTP, WebAuthn)
- Configuración de seguridad reforzada basada en roles de Jeff Geerling para protección del servidor
- Soporte para servicios populares preconfigurados incluyendo Minecraft Paper con Geyser/Floodgate
- Requiere conocimientos previos de Ansible, SSH y gestión de servidores Linux
- Necesita dominio propio con Cloudflare y redirección de puertos 80/443 en el router
- El playbook expone el servidor a ataques externos; requiere configuración adicional de seguridad
- Dependencia de Ubuntu Server LTS 22.04 como sistema operativo base
- No incluye Dockerfile ni docker-compose nativo; la orquestación se realiza vía Ansible
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.
Requiere Ubuntu Server LTS 22.04, dominio con Cloudflare (nameservers apuntados), router con forwarding de puertos 80/443, y control node con Ansible instalado. Clonar repositorio, instalar roles con ansible-galaxy install -r requirements.yml, configurar group_vars/all/local.yml para valores host, crear vault.yml encriptado con ansible-vault create, copiar hosts.example a hosts y editar con IP del servidor. Ejecutar ansible-playbook run.yml -K --ask-vault-pass. Verificar configuración de SSL/TLS en Cloudflare en modo Full.
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.