Document remote frontend integration

This commit is contained in:
faligam
2026-09-06 16:55:43 +02:00
parent fddb4da1c7
commit 9830acf446
3 changed files with 64 additions and 3 deletions

View File

@@ -66,6 +66,21 @@ curl http://localhost:8080/health
Die API ist danach unter `http://localhost:8080` erreichbar.
`/docs` zeigt die auto-generierte Swagger-Dokumentation (nur bei `NSCT_DEBUG=true`).
### Frontend auf einem separaten Rechner
Das Backend kann unabhängig vom Frontend betrieben werden. Das Frontend leitet
seine Same-Origin-Anfragen an `/api/*` per Caddy an diese API weiter. Auf dem
Frontend-Rechner wird dazu im Frontend-Repository gesetzt:
```env
NSCT_API_UPSTREAM=backend.example.com:8080
```
Der Backend-Rechner muss Port 8080 ausschließlich für die IP bzw. das Netz des
Frontend-Rechners freigeben. Für öffentliche oder nicht vertrauenswürdige Netze
soll die Verbindung zwischen den Rechnern über TLS, VPN oder einen abgesicherten
Reverse Proxy erfolgen.
## Projektstruktur
```
@@ -169,4 +184,4 @@ Alle 22 Stages sind abgeschlossen. NSCT ist production-ready:
## Lizenz
MIT
MIT