Bereitstellungsoptionen

QuoteNode unterstützt mehrere Bereitstellungsmodelle, alle basierend auf Docker-Containern. Wählen Sie die Topologie, indem Sie entscheiden, wer die Anwendung und öffentliche Angebotslinks öffnen muss.

Empfohlene Pfade

Szenario	Empfohlener Guide
Evaluierung auf einem Computer	Lokaler Laptop
Office-only-Test auf Windows	Windows LAN-Server
Office-only interner Linux-Server	Linux LAN-Server
Öffentliche Beta auf eigenem VPS	Ubuntu-Öffentlichserver
Öffentliche Beta mit verwaltetem Proxy/Deploy-UI	Coolify
Bestehende Docker-UI/NAS-Plattform	Portainer, QNAP oder NAS

Die kurze Auswahlseite ist Installationsguide. Verwenden Sie Installation Troubleshooting für URL-, CORS-, DNS-, SMTP- und Secret-Verlust-Probleme.

Produktionstopologie

Eine öffentliche Bereitstellung sieht normalerweise so aus:

Internet
  │
  ▼
Öffentlicher HTTPS-Reverse-Proxy
  └── Frontend-Dienst
        ├── Statische Vue-Anwendung
        └── /api und /offer Routen zum Backend

Backend -> PostgreSQL
Backend -> Gotenberg für PDF-Generierung
Backup-Worker -> PostgreSQL und persistierte Dateien

Coolify stellt selbst den öffentlichen HTTPS-Reverse-Proxy bereit. Der standardmäßige Docker-Compose-Produktions-Stack kann auch seinen eigenen internen Caddy-Proxy ausführen.

Dienste

Container	Zweck
frontend	Liefert die Vue-Anwendung aus und routed Browser-Traffic.
backend	Java / Spring Boot API, Geschäftslogik, öffentliche Links, PDF-Orchestrierung.
postgres	PostgreSQL-Datenbank.
gotenberg	HTML-zu-PDF-Konvertierungsdienst.
backup-worker	Geplante Datenbank- und Datei-Backups.

Persistente Daten

Daten	Warum sie wichtig sind
PostgreSQL-Volume	Hauptdatenbank.
Uploads-Volume	Produktbilder, Logos, CRM-Anhänge.
PDF-Volume	Generierte PDF-Dokumente.
Backup-Volume	Lokale Backup-Archive vor Offsite-Kopie.
GeoIP-Volume	Optionale MaxMind-Datenbank.

Sichern Sie .env separat von Docker-Volumes. Der DB_ENCRYPTION_KEY in .env ist erforderlich, um sensible Felder zu entschlüsseln.

Release-Metadaten und Update-Checks

QuoteNode kann einen Admin-only-Hinweis anzeigen, wenn ein neuerer Upstream-Release verfügbar ist.

• Öffentliches Manifest: https://quotenode.dev/releases/latest.json
• Frontend-Flag: VITE_RELEASE_CHECK_ENABLED
• Frontend-Override-URL: VITE_RELEASE_MANIFEST_URL

Das ist getrennt vom per-Installation Frontend-Reload-Check:

• /app-version.json antwortet: “diese Installation hat ein neueres Frontend-Bundle bereitgestellt”.
• releases/latest.json antwortet: “ein neuerer QuoteNode-Release existiert upstream”.

Offline oder private Bereitstellungen können den Upstream-Check deaktivieren oder auf einen internen Mirror zeigen.

Umgebungsvariablen

Für installationsfokussierte Variablen siehe Deployment-Umgebungsvariablen. Für den vollständigen Katalog siehe Umgebungsvariablen-Referenz.

Sicherheitshinweise

• Öffentliche Bereitstellungen erfordern HTTPS.
• CORS_ALLOWED_ORIGINS muss exakt mit dem Browser-Ursprung übereinstimmen.
• LICENSE_SKIP_SIGNATURE_CHECK muss in echten Bereitstellungen abwesend oder false sein.
• Stellen Sie PostgreSQL, Gotenberg oder den Backup-Worker nicht öffentlich dar.
• Reverse-Proxies sollten Client-IP-Header für Sicherheitslogging und öffentliche-Link-Schutzmaßnahmen beibehalten.