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-palvelu-palvelu | Käytä sitä, kun |
|---|
memory | You need the fastest cache and can keep objects in RAM. |
disk | You need cache capacity that survives process restarts. |
tiered | Haluat muistia kuumille objekteille ja levyä suurempaan kapasiteettiin. |
storage-bin | Odotat paljon vaihtuvuutta ja haluat rajatun levyallokaation. |
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
| Kontrolli | Tarkoitus |
|---|
lock | Collapse concurrent misses so one request fills the cache. |
range.slice | Cache fixed byte slices for large files and resumable downloads. |
peer_fill | Anna yhden edgen täyttää toiselta edgeltä ennen originin käyttöä. |
origin_protection | Rajoita samanaikaisia origin-fillejä korkean paineen aikana. |
cache_purger | Siivoa stale disk entryt rajatuissa erissä. |
Use cache carefully
- Do not cache private user pages unless the route is explicitly safe.
- Keep cache keys bounded and predictable.
- Käytä purgea tai lyhyitä TTL:iä, kun sisältö muuttuu usein.
- Bypassaa cookieilla, authorizationilla, preview-headereilla ja turvattomilla query stringeillä.