Fluxheim/Ducumentazione/Reverse Proxy

Reverse Proxy

Metti Fluxheim davanti a nu application server. Fluxheim gestisce TLS, header, limiti e selezione upstream.

Basic proxy

[[vhosts]]
name = "app"
hosts = ["app.example.com"]

[[vhosts.routes]]
path_prefix = "/"
action = "proxy"
upstreams = ["127.0.0.1:3000"]

Scelte route

FunzioneUsalo quanno
path_exactUn URL richiede na route precisa.
path_prefixUn intero sottoalbero URL va a nu backend.
strip_prefixIl backend nun adda vedere 'o prefisso pubblico.
rewrite_prefixIl backend si aspetta nu prefisso interno diverso.
methodsNa route adda accettare solo metodi HTTP selezionati.

Esempio path rewrite

[[vhosts.routes]]
name = "api"
path_prefix = "/api/"
strip_prefix = "/api/"
rewrite_prefix = "/internal/"

[vhosts.routes.proxy]
upstreams = ["10.0.0.20:8080"]
connect_timeout_secs = 5
read_timeout_secs = 30
send_timeout_secs = 30

CORS pe' ll'app d''o browser

Abilita CORS sulo quanno ll'app d''o browser ncopp''a origine canusciute hanno 'a chiammà sta route.

[headers.cors]
enabled = true
allow_origins = ["https://app.example.com"]
allow_methods = ["GET", "HEAD", "POST"]
allow_headers = ["authorization", "content-type"]
allow_credentials = true
max_age_secs = 600
  • Fluxheim risponne localmente ê richieste preflight valide; 'e preflight rifiutate tornano 403 senza arrivà a ll'applicazione.
  • Nun mettere n'origene wildcard nzieme ê credenziale.
  • CORS nun è autenticazione, autorizzazione o protezione CSRF.

Note production

  • Mantieni l'applicazione su loopback o su na rete privata.
  • Imposta limiti ô body d'e request primma 'e esporre upload.
  • Use trusted proxy settings only for networks you control.
  • Preferisci route esplicite a nu grande fallback quanno path diversi richiedono regole 'e sicurezza diverse.
Napulitano