Opcje wdrożenia

QuoteNode wspiera kilka modeli wdrożenia opartych o kontenery Docker. Wybierz topologię według tego, kto ma otwierać aplikację i publiczne linki ofertowe.

Rekomendowane ścieżki

Scenariusz	Rekomendowany przewodnik
Ewaluacja na jednym komputerze	Lokalny laptop
Test biurowy tylko w LAN na Windows	Serwer LAN Windows
Wewnętrzny serwer Linux w biurze	Serwer LAN Linux
Publiczna beta na własnym VPS	Publiczny serwer Ubuntu
Publiczna beta z zarządzanym proxy/deploy UI	Coolify
Istniejąca platforma Docker UI/NAS	Portainer, QNAP lub NAS

Krótka strona wyboru to Przewodnik instalacji. Problemy z URL, CORS, DNS, SMTP i utratą sekretów opisuje Rozwiązywanie problemów instalacji.

Topologia produkcyjna

Publiczne wdrożenie zwykle wygląda tak:

Internet
  |
  v
Publiczny reverse proxy HTTPS
  -> frontend service
       -> statyczna aplikacja Vue
       -> trasy /api i /offer do backendu

Backend -> PostgreSQL
Backend -> Gotenberg do generowania PDF
Backup worker -> PostgreSQL i utrwalone pliki

Coolify zapewnia publiczny reverse proxy HTTPS samodzielnie. Standardowy produkcyjny stack Docker Compose może też uruchamiać własny wewnętrzny proxy Caddy.

Usługi

Kontener	Rola
frontend	Serwuje aplikację Vue i obsługuje ruch przeglądarki.
backend	API Java / Spring Boot, logika biznesowa, linki publiczne, orkiestracja PDF.
postgres	Baza danych PostgreSQL.
gotenberg	Konwersja HTML do PDF.
backup-worker	Zaplanowane kopie zapasowe bazy i plików.

Trwałe dane

Dane	Dlaczego są ważne
Wolumen PostgreSQL	Główna baza danych.
Wolumen uploads	Zdjęcia produktów, logotypy, załączniki CRM.
Wolumen PDF	Wygenerowane dokumenty PDF.
Wolumen backup	Lokalne archiwa backupów przed kopią zewnętrzną.
Wolumen GeoIP	Opcjonalna baza MaxMind.

Twórz kopię .env osobno od wolumenów Docker. DB_ENCRYPTION_KEY z .env jest wymagany do odszyfrowania pól wrażliwych.

Metadane wydań i sprawdzanie aktualizacji

QuoteNode może pokazać administratorowi informację, że dostępne jest nowsze upstream release:

• publiczny manifest: https://quotenode.dev/releases/latest.json,
• flaga frontendu: VITE_RELEASE_CHECK_ENABLED,
• nadpisanie URL manifestu: VITE_RELEASE_MANIFEST_URL.

Ten mechanizm jest addytywny i odrębny od bannera reloadu w obrębie tej samej instalacji:

• /app-version.json odpowiada na pytanie: “czy ta instalacja wdrożyła nowszy bundle frontendu?”,
• releases/latest.json odpowiada na pytanie: “czy upstream ma już nowszy release QuoteNode?”.

Dla wdrożeń prywatnych lub offline wskaż własne lustro manifestu przez VITE_RELEASE_MANIFEST_URL albo wyłącz zewnętrzny check całkowicie.

Zmienne środowiskowe

Zmienne potrzebne przy instalacji opisuje Referencja zmiennych środowiskowych wdrożenia. Pełny katalog znajdziesz w Referencji zmiennych środowiskowych.

Uwagi bezpieczeństwa

• Publiczne wdrożenia wymagają HTTPS.
• CORS_ALLOWED_ORIGINS musi dokładnie odpowiadać originowi widocznemu w przeglądarce.
• LICENSE_SKIP_SIGNATURE_CHECK musi być nieobecne albo ustawione na false w prawdziwych wdrożeniach.
• Nie wystawiaj publicznie PostgreSQL, Gotenberg ani backup-worker.
• Reverse proxy powinien przekazywać nagłówki IP klienta dla logów bezpieczeństwa i ochrony linków publicznych.