Fluxheim/Dokumentace/Reverse Proxy

Reverse Proxy

Postav Fluxheim před application server. Fluxheim řeší TLS, header, limity a výběr upstream.

Basic proxy

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

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

Route volby

FunkcePoužij, když
path_exactJedno URL potřebuje přesnou route.
path_prefixCelý URL subtree jde na jeden backend.
strip_prefixBackend nemá vidět public prefix.
rewrite_prefixBackend očekává jiný internal prefix.
methodsRoute má přijmout jen vybrané HTTP method.

Path rewrite příklad

[[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 pro aplikace prohlížeče

Povolte CORS pouze v případě, že aplikace prohlížeče se známým původem musí volat tuto trasu.

[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 lokálně odpovídá na platné požadavky CORS preflight; odmítnuté preflight požadavky vrátí 403, aniž by se dostaly k aplikaci.
  • Nekombinujte původ zástupných znaků s přihlašovacími údaji.
  • CORS není autentizace, autorizace ani ochrana CSRF.

Production poznámky

  • Drž aplikaci na loopback nebo privátní síti.
  • Nastav request body limity před vystavením upload.
  • Use trusted proxy settings only for networks you control.
  • Preferuj explicit route před jedním velkým fallback, když různé path potřebují různá safety rules.
Čeština