Fluxheim/Документация/Конфигурацияuration Basics

Конфигурацияuration Basics

Fluxheim използва TOML. Непознати полета се отхвърлят, така че правописни грешки падат преди restart.

Основна форма

[server]
listen = ["0.0.0.0:8080"]
default_vhost = "site"

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

Как е организиран config

Област	Какво принадлежи там
`server`	Listeners, global limits, trusted proxy handling, and redirects.
`tls`	Глобален TLS backend и compatibility policy.
`cache`	Process-wide cache defaults and storage tiers.
`vhosts`	Hostnames, routes, web roots, proxy settings, PHP, TLS, and access policy.
`metrics`	Prometheus и export listener-и за operational visibility.

Форма на route

[[vhosts.routes]]
name = "app"
path_prefix = "/app/"
methods = ["GET", "HEAD", "POST"]
max_request_body_bytes = "16MiB"

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

Route има един matcher и едно action. Exact path-овете печелят първи, после най-дългите prefix-и, после regex route-ове, когато regex support е включен, и накрая fallback route.

Сигурни навици

Стартирай fluxheim --check-config преди reload.
Използвай един vhost за site или application boundary.
Дръж secret-и във file, environment или container secrets, не в public docs.
Използвай route-level лимити за upload и скъпи application path-ове.
Дръж admin и metrics listener-и private.