Fluxheim/Dokumentācija/Konfigurācijauration Basics

Konfigurācijauration Basics

Fluxheim izmanto TOML. Nezināmi lauki tiek noraidīti, tāpēc pārrakstīšanās kļūdas izgāžas pirms restartēšanas.

Pamata forma

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

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

Kā config ir organizēts

JomaKas tur pieder
serverListeners, global limits, trusted proxy handling, and redirects.
tlsGlobāls TLS backend un compatibility policy.
cacheProcess-wide cache defaults and storage tiers.
vhostsHostnames, routes, web roots, proxy settings, PHP, TLS, and access policy.
metricsPrometheus un export listeneri operational visibility vajadzībām.

Route forma

[[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 ir viens matcher un viena action. Exact path uzvar pirmais, tad garākie prefix, tad regex route, ja regex atbalsts ir ieslēgts, un tad viens fallback route.

Droši ieradumi

  • Palaist fluxheim --check-config pirms reload.
  • Izmanto vienu vhost katrai vietnei vai lietotnes robežai.
  • Turi secrets failos, environment vai container secrets, nevis publiskā dokumentācijā.
  • Izmanto route-level limitus uploadiem un dārgiem application pathiem.
  • Turi admin un metrics listenerus privātus.
Latviešu