Fluxheim/Documentation/Reverse Proxy

Reverse Proxy

Placez Fluxheim devant un serveur applicatif. Fluxheim gère TLS, les en-têtes, les limites et la sélection upstream.

Basic proxy

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

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

Choix de routes

FonctionnaliteUtilisez-le quand
path_exactUne URL a besoin d'une route precise.
path_prefixTout un sous-arbre d'URL va vers un backend.
strip_prefixLe backend ne doit pas voir le prefixe public.
rewrite_prefixLe backend attend un prefixe interne different.
methodsUne route ne doit accepter que certaines methodes HTTP.

Exemple de reecriture de chemin

[[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 pour les applications de navigateur

Activez CORS uniquement lorsque les applications de navigateur sur des origines connues doivent appeler cette route.

[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épond localement aux requêtes CORS preflight valides ; les requêtes preflight rejetées renvoient 403 sans atteindre l'application.
  • Ne combinez pas une origine générique avec des informations d'identification.
  • CORS n’est pas une authentification, une autorisation ou une protection CSRF.

Notes de production

  • Gardez l'application sur loopback ou sur un réseau privé.
  • Définissez les limites de corps de requête avant d'exposer les uploads.
  • Use trusted proxy settings only for networks you control.
  • Preferez des routes explicites a un grand fallback quand les chemins ont besoin de regles de securite differentes.
Français