Configuration Basics

Fluxheim uses TOML. Unknown fields are rejected, so spelling mistakes fail roimh restart.

Príomhchruth

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

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

I gcás imscaradh iltionónta, cumasaigh [server.host_routing].strict = true ionas go dtugann aitheantas óstaigh atá in easnamh nó neamhbhailí 400 ar ais agus go dtugann óstaigh anaithnide 421 ar ais seachas an suíomh réamhshocraithe a bhaint amach.

Conas atá config eagraithe

Réimse	Cad a bhaineann ann
`server`	Listeners, global limits, trusted proxy handling, and redirects.
`tls`	Domhanda TLS backend agus compatibility beartas.
`cache`	Process-wide cache defaults and storage tiers.
`vhosts`	Hostnames, routes, web roots, proxy settings, PHP, TLS, and access policy.
`metrics`	Prometheus agus export éisteoirí do operational visibility.

Cruth bealaigh

[[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"]

A bealach has one matcher agus one action. Exact cosáin win first, then longest prefixes, then regex bealaí when regex support is enabled, then one fallback bealach.

Slándáil freagartha HTTP

Tá próifílí slándála freagartha HTTP roghnach. Tosaigh le baseline; bain úsáid as leithlisiú tras-bhunaidh ach amháin tar éis gach script, cló, íomhá, sreabhadh sínithe isteach agus acmhainn leabaithe a thástáil.

[headers.response.hardening]
profile = "baseline"

Próifíl	Cad a dhéanann sé
`off`	Coinníonn sé na ceanntásca cruaithe roghnacha díchumasaithe.
`baseline`	Cuirtear leithlisiú coimeádach brabhsálaí leis agus mainneachtainí beartais acmhainne atá oiriúnach don chuid is mó de shuíomhanna.
`cross-origin-isolated`	Cumasaíonn sé leithlisiú dian tras-bhunaidh d'fheidhmchláir a bhfuil tástáil déanta ar gach spleáchas seachtrach.

Ní chumasaíonn ceachtar den phróifíl HSTS nó CSP. Cumraigh iad siúd ar leithligh tar éis iad a thástáil i gcoinne an fhíorláithreáin.

Meiteashonraí freagartha bunaithe ar chaighdeáin

Díchumasaítear meiteashonraí freagartha de réir réamhshocraithe. Cumasaigh ach na réimsí atá uait; Díorthaíonn Fluxheim iad as an toradh taisce iarbhír, teip seachfhreastalaí, agus bearta freagartha deiridh gan eochracha taisce, seoltaí inneall, ainmneacha DNS, nó earráidí amh a nochtadh.

[headers.response.metadata]
identifier = "edge-gateway"
cache_status = true
proxy_status = true
content_digest = true
repr_digest = true

Réimse	Cad a thuairiscíonn sé
`Cache-Status`	Torthaí taisce RFC 9211 mar bhuail, chailleann, cur ar aghaidh sean, athbhailíochtú, dul in éag, agus seachbhóthar.
`Proxy-Status`	Sonraí íseal-cardinality RFC 9209 maidir le teipeanna ginte ag Fluxheim.
`Content-Digest`	RFC 9530 SHA-256 thar ábhar teachtaireacht deiridh HTTP tar éis comhbhrú.
`Repr-Digest`	SHA-256 ach amháin nuair a shealbhaíonn Fluxheim an ionadaíocht iomlán roghnaithe.

Seatanna beo agus aischur

Is féidir le seatanna fíordheimhnithe cumraíocht bhailíochtaithe a fhoilsiú, an ródaire reatha a athsholáthar agus filleadh ar an leagan roimhe gan gnáth-imlonnuithe ródaithe amháin a atosú. Úsáideann gach iarratas an ghlúin chéanna ródaire ó thús go deireadh.

Coinnigh an siopa seat in eolaire príobháideach tiomnaithe; diúltaítear d’eolairí neamhphríobháideacha agus do fhréamhacha córais comhaid atá ann cheana féin.
Bain úsáid as uasghrádú próisis nuair a bhíonn seirbhísí sláinte nó fionnachtana ualach-chothromaithe cúlra gníomhach.
Rith seiceálacha sláine pictiúr tar éis é a fhoilsiú nó a rolladh siar agus deimhnigh go bhfuil an ghlúin roghnaithe ar marthain don atosú.

Léigh an conradh pictiúr iomlán

Nósanna sábháilte

Run fluxheim --check-config before reloads.
Use one vhost per suíomh nó application boundary.
Keep rúin in comhaid, environment, nó coimeádán rúin, not in poiblí docs.
Coinnigh comhaid chumraíochta agus gach máthair-eolaire atá ann faoi úinéireacht iontaofa agus gan cead scríofa don ghrúpa ná d’úsáideoirí eile.
Cuir próiseas nua in áit an phróisis nuair a athraíonn TLS, éisteoirí, sruthanna, UDP, ACME, glanadh taisce, rianú nó socruithe próisis PHP-FPM bainistithe; is féidir le gnáthródú agus polasaí le linn iarratais athluchtú seat a úsáid.
Use bealach-level teorainneacha do uploads agus expensive application cosáin.
Keep admin agus méadrachtaí éisteoirí príobháideach.