Cache

Use cache when Fluxheim sits in front of an origin and repeated responses should be served faster.

Proxy cache example

[cache]
enabled = true
default_ttl_secs = 300
max_object_bytes = "32MiB"
status_header = "X-Cache-Status"

[cache.memory]
enabled = true
max_size_bytes = "256MiB"

[cache.disk]
enabled = true
path = "/var/cache/fluxheim/site"
max_size_bytes = "10GiB"

Cache backends

Backend-tjeneste	Bruk det når
`memory`	You need the fastest cache and can keep objects in RAM.
`disk`	You need cache capacity that survives process restarts.
`tiered`	Du vil ha minne for varme objekter og disk for større kapasitet.
`storage-bin`	Du forventer mye utskifting og vil ha begrenset diskallokering.
`encrypted disk`	You need cache-at-rest protection for disk objects.

Route cache policy

[[vhosts.routes]]
name = "assets"
path_prefix = "/assets/"
action = "proxy"

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

[vhosts.routes.cache]
enabled = true
status_ttls = { "200" = 3600, "404" = 60 }
content_types = ["text/css", "application/javascript", "image/*"]
extensions = ["css", "js", "png", "webp", "svg"]
include_query = false
stale_while_revalidate_secs = 30
stale_if_error_secs = 120

Advanced cache controls

Kontroll	Formål
`lock`	Collapse concurrent misses so one request fills the cache.
`range.slice`	Cache fixed byte slices for large files and resumable downloads.
`peer_fill`	La én edge fylle fra en annen edge før origin brukes.
`origin_protection`	Begrens samtidige origin-fyllinger under høyt trykk.
`cache_purger`	Rydd gamle diskoppføringer i begrensede batcher.

Use cache carefully

Forespørsler som bærer Authorization eller Proxy-Authorization omgår alltid delt hurtigbufferoppslag og lagring.
Feilaktig eller motstridende respons Cache-Control-direktiver avvises i stedet for å falle tilbake til konfigurerte TTL-er; s-maxage prioriteres over max-age.
must-revalidate, proxy-revalidate og s-maxage forbyr gammel gjenbruk etter at ferskheten utløper.
Keep cache keys bounded and predictable.
Bruk én storage-bin-rot per Fluxheim-prosess som kjører; eierskapet bruker en rådgivende filsystemlås, og delte røtter med flere skrivere er utrygge uten verifisert ekstern låsing.
Bruk purge eller korte TTL-er når innhold endres ofte.
Bypass on cookies, preview headers, and unsafe query strings.

Merknad om oppgradering av kryptert cache

Fluxheim 1.7.12 flytter krypterte diskbufferobjekter til rotbundne data og indeksnøkler med varig nonce-tilstand. Den første oppstarten mot en eldre kryptert rot, og hver rotasjon av lokalnøkkel, kaldtømmer med hensikt den cachen før den betjener trafikk.

Krypterte hurtigbufferdata kan kastes og må ikke behandles som en autoritativ datakilde.
Gi hver cache-rot vedvarende privat lagring og ikke kopier nonce-tilstand mellom uavhengige røtter.
Kontroller at opprinnelsesserveren tåler den første oppvarmingen av hurtigbufferen etter en oppgradering eller nøkkelrotasjon.