Reverse Proxy

Поставьте Fluxheim перед application server. Fluxheim берет на себя TLS, headers, limits и выбор upstream.

Basic proxy

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

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

Выбор routes

Feature-функцияИспользуйте, когда
path_exactОдному URL нужен precise route.
path_prefixЦелое URL subtree идет на один backend.
strip_prefixBackend не должен видеть public prefix.
rewrite_prefixBackend ожидает другой internal prefix.
methodsRoute должен принимать только selected HTTP methods.

Пример 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 для браузерных приложений

Включайте CORS только в том случае, если приложения браузера из известного источника должны вызывать этот маршрут.

[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 локально отвечает на корректные CORS preflight-запросы; отклонённые preflight-запросы возвращают 403, не достигая приложения.
  • Не объединяйте происхождение подстановочного знака с учетными данными.
  • CORS не является аутентификацией, авторизацией или защитой CSRF.

Production notes для эксплуатации

  • Держите application на loopback или в private network.
  • Задайте request body limits перед открытием uploads.
  • Use trusted proxy settings only for networks you control.
  • Предпочитайте explicit routes одному большому fallback, когда разные paths требуют разных safety rules.
Русский