Fluxheim/Dokumentation/Reverse Proxy

Reverse Proxy

Setze Fluxheim vor einen Anwendungsserver. Fluxheim übernimmt TLS, Header, Limits und die Upstream-Auswahl.

Basic proxy

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

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

Routenauswahl

FeatureNutze es, wenn
path_exactEine URL braucht eine prazise Route.
path_prefixEin ganzer URL-Unterbaum geht an ein Backend.
strip_prefixDas Backend soll den offentlichen Prefix nicht sehen.
rewrite_prefixDas Backend erwartet einen anderen internen Prefix.
methodsEine Route soll nur ausgewahlte HTTP-Methoden akzeptieren.

Beispiel fur Pfad-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

Produktionshinweise

  • Halte die Anwendung auf Loopback oder in einem privaten Netzwerk.
  • Setze Request-Body-Limits, bevor du Uploads freigibst.
  • Use trusted proxy settings only for networks you control.
  • Bevorzuge explizite Routen statt eines grossen Fallbacks, wenn Pfade unterschiedliche Sicherheitsregeln brauchen.
Deutsch