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

बैकएंड	इसका उपयोग तब करें जब
`memory`	You need the fastest cache and can keep objects in RAM.
`disk`	You need cache capacity that survives process restarts.
`tiered`	आप गर्म वस्तुओं के लिए मेमोरी और बड़ी क्षमता के लिए डिस्क चाहते हैं।
`storage-bin`	आप उच्च मंथन की उम्मीद करते हैं और सीमित डिस्क आवंटन चाहते हैं।
`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

नियंत्रण	उद्देश्य
`lock`	Collapse concurrent misses so one request fills the cache.
`range.slice`	Cache fixed byte slices for large files and resumable downloads.
`peer_fill`	मूल का उपयोग करने से पहले एक किनारे को दूसरे किनारे से भरने दें।
`origin_protection`	उच्च दबाव के दौरान समवर्ती मूल को सीमित करें।
`cache_purger`	बाउंडेड बैचों में पुरानी डिस्क प्रविष्टियों को साफ़ करें।

Use cache carefully

Authorization या Proxy-Authorization वाले अनुरोध हमेशा साझा-कैश लुकअप और स्टोरेज को बायपास करते हैं।
विकृत या विरोधाभासी प्रतिक्रिया Cache-Control निर्देशों को कॉन्फ़िगर किए गए टीटीएल पर वापस आने के बजाय अस्वीकार कर दिया जाता है; s-maxage को max-age पर प्राथमिकता मिलती है।
must-revalidate, proxy-revalidate, और s-maxage ताजगी समाप्त होने के बाद बासी पुन: उपयोग पर रोक लगाते हैं।
Keep cache keys bounded and predictable.
हर चल रहे Fluxheim process के लिए एक storage-bin root रखें; ownership advisory filesystem lock का उपयोग करती है, इसलिए सत्यापित external locking के बिना साझा multi-writer root असुरक्षित हैं।
जब सामग्री बार-बार बदलती है तो पर्ज या संक्षिप्त टीटीएल का उपयोग करें।
Bypass on cookies, preview headers, and unsafe query strings.

एन्क्रिप्टेड-कैश अपग्रेड नोट

Fluxheim 1.7.12 एन्क्रिप्टेड डिस्क कैश ऑब्जेक्ट को टिकाऊ नॉन स्टेट के साथ रूट-बाउंड डेटा और इंडेक्स कुंजियों में ले जाता है। पुराने एन्क्रिप्टेड रूट के विरुद्ध पहला स्टार्टअप, और प्रत्येक स्थानीय-कुंजी रोटेशन, जानबूझकर ट्रैफ़िक परोसने से पहले उस कैश को कोल्ड-पर्ज करता है।

एन्क्रिप्टेड कैश को डिस्पोजेबल एक्सेलेरेशन के रूप में मानें, रिकॉर्ड के स्रोत के रूप में नहीं।
प्रत्येक कैश रूट को लगातार निजी भंडारण दें और स्वतंत्र रूटों के बीच गैर-स्थिति की प्रतिलिपि न बनाएं।
चाबियों को अपग्रेड करने या घुमाने के बाद पहले वार्म-अप के लिए मूल क्षमता की योजना बनाएं।