http-cache-turbo #
Built-in full-page micro-cache for nginx — Varnish-style page caching without Varnish, served straight from shared memory; must be the last dynamic module loaded. Full write-up: cache pages in nginx with cache-turbo →.
Source: our fork on GitHub
Read more: deep-dive article on deb.myguard.nl
Directives
cache_turbo #
syntax: cache_turbo 1 arg; · context: server, location
Enables cache-turbo in this location and binds it to a shared-memory zone; accepts "off" or an optional "auto" backend-preset shorthand.
cache_turbo_admin #
syntax: cache_turbo_admin 1 arg; · context: location
Turns the location into an admin/control endpoint for the named cache_turbo shared-memory zone.
cache_turbo_auto_vary #
syntax: cache_turbo_auto_vary on | off (on/off flag); · context: server, location
Boolean directive — set to "on" or "off".
cache_turbo_autotune #
syntax: cache_turbo_autotune on | off (on/off flag); · context: server, location
Boolean directive — set to "on" or "off".
cache_turbo_autotune_interval #
syntax: cache_turbo_autotune_interval 1 arg (duration in seconds); · context: server, location
Duration in seconds; accepts s / m / h / d suffixes.
cache_turbo_backend #
syntax: cache_turbo_backend 1+ args; · context: server, location
Composes one or more CMS auto-classify presets (generic, wordpress, woocommerce, joomla) by setting bits in backend_presets.
cache_turbo_background_update #
syntax: cache_turbo_background_update on | off (on/off flag); · context: server, location
Boolean directive — set to "on" or "off".
cache_turbo_beta #
syntax: cache_turbo_beta 1 arg (integer); · context: server, location
Integer value.
cache_turbo_bypass #
syntax: cache_turbo_bypass 1+ args; · context: server, location
Sets a predicate that, when it evaluates true, skips serving from cache and forwards the request to origin.
cache_turbo_honor_cache_control #
syntax: cache_turbo_honor_cache_control on | off (on/off flag); · context: server, location
Boolean directive — set to "on" or "off".
cache_turbo_key #
syntax: cache_turbo_key 1 arg; · context: server, location
Compiles a complex-value expression used to build the cache key for matching requests.
cache_turbo_lock #
syntax: cache_turbo_lock on | off (on/off flag); · context: server, location
Boolean directive — set to "on" or "off".
cache_turbo_lock_timeout #
syntax: cache_turbo_lock_timeout 1 arg (duration in ms); · context: server, location
Duration in milliseconds; accepts ms / s / m suffixes.
cache_turbo_lock_ttl #
syntax: cache_turbo_lock_ttl 1 arg (duration in seconds); · context: server, location
Duration in seconds; accepts s / m / h / d suffixes.
cache_turbo_max_size #
syntax: cache_turbo_max_size 1 arg (size (k/m/g)); · context: server, location
Size in bytes; accepts k / m / g suffixes.
cache_turbo_memcached #
syntax: cache_turbo_memcached 1+ args; · context: http, server, location
Selects the memcached L2 backend with host:port plus prefix=/timeout= params; mutually exclusive with cache_turbo_redis.
cache_turbo_min_uses #
syntax: cache_turbo_min_uses 1 arg (integer); · context: server, location
Integer value.
cache_turbo_no_store #
syntax: cache_turbo_no_store 1+ args; · context: server, location
Sets a predicate that, when true, prevents the response from being stored in cache.
cache_turbo_normalize_strip #
syntax: cache_turbo_normalize_strip 1+ args; · context: server, location
Appends extra denylist parameter-name patterns to strip when normalizing the cache key's query string.
cache_turbo_normalize_strip_all #
syntax: cache_turbo_normalize_strip_all on | off (on/off flag); · context: server, location
Boolean directive — set to "on" or "off".
cache_turbo_normalize_vary #
syntax: cache_turbo_normalize_vary 1+ args; · context: server, location
Selects which Vary buckets (encoding and/or device) are appended to the normalized cache-key arguments.
cache_turbo_preset #
syntax: cache_turbo_preset 1 arg; · context: server, location
Selects a named default-tuning band (micro, conservative, balanced, aggressive) for cache knobs not explicitly overridden.
cache_turbo_purge #
syntax: cache_turbo_purge on | off (on/off flag); · context: server, location
Boolean directive — set to "on" or "off".
cache_turbo_redis #
syntax: cache_turbo_redis 1+ args; · context: http, server, location
Configures the Redis L2 backend from a redis(s):// DSN or host:port, with optional auth/db/TLS/prefix/timeout params.
cache_turbo_safe_key #
syntax: cache_turbo_safe_key on | off (on/off flag); · context: server, location
Boolean directive — set to "on" or "off".
cache_turbo_suppress_native #
syntax: cache_turbo_suppress_native on | off (on/off flag); · context: server, location
Boolean directive — set to "on" or "off".
cache_turbo_tag #
syntax: cache_turbo_tag 1 arg; · context: server, location
Compiles a complex-value expression producing whitespace/comma-separated cache tags recorded against the stored object for later purge.
cache_turbo_valid #
syntax: cache_turbo_valid 1+ args; · context: server, location
Sets the fresh-cache TTL, either as the default/200 TTL or per listed HTTP status code(s).
cache_turbo_vary_safe #
syntax: cache_turbo_vary_safe on | off (on/off flag); · context: server, location
Boolean directive — set to "on" or "off".
cache_turbo_zone #
syntax: cache_turbo_zone 2 args; · context: http
Declares a named shared-memory zone (name=NNN and size) used to hold cache_turbo's cache state.