Fluxheim/Documentație/Reverse Proxy

Reverse Proxy

Pune Fluxheim în fața unui application server. Fluxheim gestionează TLS, header-ele, limitele și selecția upstream.

Basic proxy

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

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

Alegeri de route

FuncțieFolosește când
path_exactUn URL are nevoie de un route precis.
path_prefixUn întreg subtree URL merge către un backend.
strip_prefixBackend-ul nu trebuie să vadă prefixul public.
rewrite_prefixBackend-ul așteaptă un prefix intern diferit.
methodsUn route trebuie să accepte doar metode HTTP selectate.

Exemplu 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 pentru aplicații de browser

Activați CORS numai atunci când aplicațiile browser cu origini cunoscute trebuie să apeleze această rută.

[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 răspunde local cererilor CORS preflight valide; cererile preflight respinse returnează 403 fără a ajunge la aplicație.
  • Nu combinați o origine wildcard cu acreditările.
  • CORS nu este autentificare, autorizare sau protecție CSRF.

Note production

  • Ține aplicația pe loopback sau într-o rețea privată.
  • Setează limite pentru request body înainte să expui upload-uri.
  • Use trusted proxy settings only for networks you control.
  • Preferă route-uri explicite în locul unui fallback mare când path-uri diferite au reguli de siguranță diferite.
Română