Fluxheim/Dokumentasjon/Reverse Proxy

Reverse Proxy

Sett Fluxheim foran en applikasjonsserver. Fluxheim håndterer TLS, headere, grenser og upstream-valg.

Basic proxy

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

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

Rutevalg

FunksjonBruk det når
path_exactÉn URL trenger en presis rute.
path_prefixEt helt URL-undertre går til én backend.
strip_prefixBackenden bør ikke se det offentlige prefikset.
rewrite_prefixBackenden forventer et annet internt prefiks.
methodsEn rute bør bare godta utvalgte HTTP-metoder.

Eksempel på 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 for nettleserapper

Aktiver CORS bare når nettleserapplikasjoner med kjent opprinnelse må ringe denne ruten.

[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 svarer lokalt på gyldige CORS-preflight-forespørsler; avviste preflight-forespørsler returnerer 403 uten å nå applikasjonen.
  • Ikke kombiner et jokertegn med legitimasjon.
  • CORS er ikke autentisering, autorisasjon eller CSRF-beskyttelse.

Produksjonsnotater

  • Hold applikasjonen på loopback eller et privat nettverk.
  • Sett grenser for request body før du eksponerer opplastinger.
  • Use trusted proxy settings only for networks you control.
  • Foretrekk eksplisitte ruter fremfor én stor fallback når ulike stier trenger ulike sikkerhetsregler.
Norsk