deploy
Repositorio oficial para desplegar el ecosistema Vault Web completo mediante Docker Compose, Git submódulos y scripts de automatización. Incluye configuración de seguridad perimetral con Headscale Caddy, Split-DNS y backups incrementales de usuarios.
Ficha actualizada 27 sept 2026, 10:36 · upstream 27 sept 2026, 10:14 · release sin release detectada
Qué es deploy
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Este repositorio actúa como punto único de entrada para la implementación del stack completo de Vault Web. Utiliza Docker Compose para orquestar servicios críticos como el backend de Vault Web, Cloud Page, gestor de contraseñas y PostgreSQL. La arquitectura está diseñada para operar en entornos Linux (Debian/Ubuntu) con un enfoque estricto en seguridad, separando el frontend público del backend interno mediante Caddy y Headscale.
La configuración de red es fundamental: se implementa un modelo de Split-DNS donde los dominios internos solo son resolvablees dentro de la VPN Tailscale, protegiendo los datos sensibles. El sistema incluye scripts bash para realizar copias de seguridad incrementales de usuarios a discos externos mediante rsync, con retención controlada y enlaces duros para eficiencia.
El despliegue requiere una configuración inicial manual de variables de entorno (.env), reglas de firewall personalizadas (iptables DOCKER-USER) y la conexión explícita de redes Docker entre el stack principal y Headscale. Se recomienda mantener los submódulos Git actualizados para asegurar compatibilidad con las dependencias de los servicios.
- Despliegue rápido del stack completo de Vault Web (frontend, backend, DB) en un servidor Linux.
- Implementación de una arquitectura segura con terminación TLS y aislamiento de red mediante Tailscale/Headscale.
- Gestión de copias de seguridad incrementales automatizadas para datos de usuarios almacenados externamente.
- Configuración de entornos multiusuario con mapeo correcto de rutas entre host y contenedores (Cloud Page).
- Actualización segura del stack manteniendo la integridad de los submódulos Git y reglas de firewall.
- Arquitectura contenerizada completa gestionada con Docker Compose y submódulos Git.
- Modelo de seguridad perimetral robusto con Caddy, Headscale y Split-DNS para evitar exposición pública no deseada.
- Sistema de backups incrementales automatizados con rsync y retención de 5 snapshots en disco externo.
- Soporte nativo para servicios clave: Vault Web, Cloud Page, Password Manager y PostgreSQL.
- Reglas de firewall personalizadas (iptables) para bloquear puertos de debug/admin por defecto.
- Mecanismos de verificación integrados para asegurar el contexto seguro (Secure Context) en navegadores.
- Requiere configuración manual de Split-DNS en cada cliente VPN para resolver dominios internos correctamente.
- No incluye Dockerfiles propios; depende de imágenes preexistentes que deben ser compatibles con la versión actual.
- El sistema de backups depende de rsync y un disco externo montado manualmente o vía fstab, sin replicación nativa.
- La conexión entre Headscale Caddy y el stack principal requiere comandos manuales para unir redes Docker.
- Algunas rutas de archivos (ej. runtime-config.local.js) deben editarse fuera del contenedor en el host.
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.
Desplegar en /opt con git clone --recurse-submodules. Copiar .env.example y configurar secretos, FRONTEND_PORT y CLOUD_HOST_ROOT. Ejecutar docker compose up -d. Conectar red headscale-caddy a deploy_default manualmente. Configurar Caddyfile para reverse_proxy y aplicar reglas iptables DOCKER-USER para bloquear puertos 8080/5433. Verificar Split-DNS en cliente con tailscale up --accept-dns=true.
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.