Ajuste configuration Basics
O Fluxheim usa TOML. Campos desconhecidos são rejeitados, por isso erros de escrita falham antes do restart.
Forma principal
[server]
listen = ["0.0.0.0:8080"]
default_vhost = "site"
[[vhosts]]
name = "site"
hosts = ["example.com"]Como a config é organizada
| Área | O que pertence aí |
|---|---|
server | Listeners, global limits, trusted proxy handling, and redirects. |
tls | Serviço backend TLS global e política de compatibilidade. |
cache | Process-wide cache defaults and storage tiers. |
vhosts | Hostnames, routes, web roots, proxy settings, PHP, TLS, and access policy. |
metrics | Prometheus e export listeners para visibilidade operacional. |
Forma da 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"]Uma route tem um matcher e uma action. Exact paths ganham primeiro, depois prefixes mais longos, depois regex routes quando regex support está ativo, e por fim uma fallback route.
Hábitos seguros
- Executar
fluxheim --check-configantes de reloads. - Use um vhost por site ou fronteira de aplicação.
- Mantenha secrets em ficheiros, ambiente ou container secrets, não em docs públicos.
- Use limites ao nível da route para uploads e paths de aplicação caros.
- Mantenha listeners admin e metrics privados.