Reverse Proxy

Posa Fluxheim davant d'un servidor d'aplicació. Fluxheim gestiona TLS, headers, límits i selecció upstream.

Basic proxy

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

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

Opcions de route

Funció	Usa-ho quan
`path_exact`	Una URL necessita una route precisa.
`path_prefix`	Tot un subarbre URL va a un backend.
`strip_prefix`	El backend no ha de ver el public prefix.
`rewrite_prefix`	El backend espera un internal prefix diferent.
`methods`	Una route només ha d'acceptar mètodes HTTP seleccionats.

Exemple de 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 per a aplicacions de navegador

Habiliteu CORS només quan les aplicacions del navegador d'origen conegut hagin de trucar a aquesta ruta.

[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 respon localment les sol·licituds CORS preflight vàlides; les sol·licituds preflight rebutjades retornen 403 sense arribar a l'aplicació.
No combineu un origen comodí amb credencials.
CORS no és autenticació, autorització o protecció CSRF.

Notes de producció

Mantingues l'aplicació en loopback o en una xarxa privada.
Defineix request body limits abans d'exposar uploads.
Use trusted proxy settings only for networks you control.
Prefiere routes explícitas a una gran fallback cuando distintos paths necessitan reglas de seguretat diferentes.