Web Accelerating Cache

Module: mod_cache


mod_cache site comes back again since feb. 29, 2008
mod_cache provides a shared web cache for mod_proxy and uses a configuration similar to Squid Cache. mod_cache has several key benefits:

  • Simple: mod_cache sets lighttpd flags between request handling stages. The request is then handled by mod_staticfile, mod_proxy, or other modules.
  • Robust: mod_cache stores caches to the filesystem rather than to memory in order to avoid memory leaks/exhaustion.
  • Fast: Lighttpd uses the Sendfile system call, which writes the file to the network interface directly.
  • Powerful: mod_cache can be used in conjunction with other lighttpd plugins (except mod_deflate and mod_secdownload). For example; using mod_compress to compress cached files, using mod_access/mod_trigger_b4_dl to implement anti-hot-link restrictions, or using mod_flv_streaming to do native flv file streaming.

With the shared web cache, mod_proxy is able to deliver content from the local cache without having to re-download bulky files, thus simultaneously increasing the speed from the user's perspective while reducing bandwidth up-stream of the server.

This is not intended to be a reverse-proxy as one is rarely useful with Lightttpd, as Lighttpd is designed to handle a large number of concurrent requests with minimal resource usage by loading external applications (eg. FastCGI) only when needed, and gracefully handling slow user transfers without blocking. For more information on optimizing the performance of Lighttpd, see:


This module is a 3rd party module and is not included in the official distribution. You can download the patch from here:

or you can download the following patched versions of lighttpd:

The PCRE library is needed to build mod_cache.

Always check for updates before attemping to install this or any other 3rd party module.

If the official source is not available there is a google group dedicated to mod_cache:


See []

directory arrays which want to save cache files.

cache.bases=("/data/cache", "/data2/cache")

Default: not set

enable or disable mod_cache.


    cache.enable = "disable" 
    $HTTP["host"] == "" {
      cache.enable = "enable" 

Default: enable
domain pcre regex arrays which mod_cache will cache.

e.g.: = ("$")

Default: not set (all domains are cached)
ignore '?' in request url or not.

e.g.: = "enable" # mod_cache treats "/uri?q1" or "/uri?q2" as "/uri". *

Default: disable.

writes mod_cache debugging messages to error.log or not

Default: disable.

PCRE regex hosts IP which are allowed to PURGE cache file


   cache.purge-host = "^(192\.168\.|222\.120\.35\.)" # Allow PURGE from 192.168/16 and 222.120.35/24, plus hardcoded 10/8 and
Default: not set (10/8 and are hardcoded to ip lists which allow to PURGE)

don't include hostname in cache saving filename

Default: disable.

arrays of "url_pcre_regex" => "minutes options". Zero minute means cache forever. multi options are allowed.

refresh-pattern options are:

Option Description
ignore-reload do not update cache when browser sends 'Cache-Control: no-cache' header
update-on-refresh update cache when browser sends 'Cache-Control: no-cache' header
override-expire ignore backend's 'Expire' header while determining whether to cache
ignore-cache-control-header ignore backend's 'Cache-Control' headers while determining whether to cache
no-expire-header do not set expires header on matched uri. without this options mod_cache set expire header based refresh-pattern rule
fetchall-for-range-request download all content of file if browser sends 'Range: xxx-yyybytes' header. it is useful for multi-thread downloaders(such as flashget)
flv-streaming to work with mod_flv_streaming
nocache do not cache matched url


Updated by gstrauss over 1 year ago · 32 revisions