Opciones de despliegue

QuoteNode soporta varios modelos de despliegue, todos basados en contenedores Docker. Elige la topologia segun quien debe abrir la aplicacion y los enlaces publicos de oferta.

Rutas recomendadas

Escenario	Guia recomendada
Evaluacion en un ordenador	Portatil local
Prueba solo oficina en Windows	Servidor LAN Windows
Servidor Linux interno de oficina	Servidor LAN Linux
Beta publica en tu propio VPS	Servidor publico Ubuntu
Beta publica con proxy/UI de despliegue gestionados	Coolify
Plataforma Docker UI/NAS existente	Portainer, QNAP o NAS

La pagina corta de eleccion es la Guia de instalacion. Usa Resolucion de problemas de instalacion para problemas de URL, CORS, DNS, SMTP y perdida de secretos.

Topologia de produccion

Un despliegue publico normalmente se ve asi:

Internet
  │
  ▼
Reverse proxy HTTPS publico
  └── servicio frontend
        ├── aplicacion Vue estatica
        └── rutas /api y /offer hacia backend

Backend -> PostgreSQL
Backend -> Gotenberg para generacion PDF
Backup worker -> PostgreSQL y archivos persistentes

Coolify proporciona por si mismo el reverse proxy HTTPS publico. El stack Docker Compose de produccion estandar tambien puede ejecutar su propio proxy Caddy interno.

Servicios

Contenedor	Proposito
frontend	Sirve la aplicacion Vue y enruta el trafico del navegador.
backend	API Java / Spring Boot, logica de negocio, enlaces publicos y orquestacion PDF.
postgres	Base de datos PostgreSQL.
gotenberg	Servicio de conversion HTML a PDF.
backup-worker	Backups programados de base de datos y archivos.

Datos persistentes

Dato	Por que importa
Volumen PostgreSQL	Base de datos principal.
Volumen uploads	Imagenes de producto, logos y adjuntos CRM.
Volumen PDF	Documentos PDF generados.
Volumen backup	Archivos locales antes de copia offsite.
Volumen GeoIP	Base MaxMind opcional.

Haz backup de .env por separado de los volumenes Docker. La clave DB_ENCRYPTION_KEY en .env es necesaria para descifrar campos sensibles.

Metadatos de release y comprobaciones de actualizacion

QuoteNode puede mostrar un aviso solo para administradores cuando existe una release upstream mas reciente.

• Manifiesto publico: https://quotenode.dev/releases/latest.json
• Flag frontend: VITE_RELEASE_CHECK_ENABLED
• URL override frontend: VITE_RELEASE_MANIFEST_URL

Esto es independiente de la comprobacion de recarga frontend de cada instalacion:

• /app-version.json responde: “esta instalacion desplego un bundle frontend mas nuevo”.
• releases/latest.json responde: “existe una release QuoteNode upstream mas nueva”.

Los despliegues offline o privados pueden desactivar la comprobacion upstream o apuntarla a un mirror interno.

Variables de entorno

Para variables centradas en instalacion, consulta Variables de entorno de despliegue. Para el catalogo completo, consulta Referencia de variables de entorno.

Notas de seguridad

• Los despliegues publicos requieren HTTPS.
• CORS_ALLOWED_ORIGINS debe coincidir exactamente con el origen del navegador.
• LICENSE_SKIP_SIGNATURE_CHECK debe estar ausente o ser false en despliegues reales.
• No expongas PostgreSQL, Gotenberg ni backup-worker publicamente.
• Los reverse proxies deben preservar headers de IP cliente para logs de seguridad y protecciones de enlaces publicos.