User Guide

http.cache
Plugin

The cache directive adds http caching

Full documentation

Examples

basic example
yoursite.caddy { cache proxy / localhost:8080 }

This is the most basic usage. It will cache successful responses and save them in a temp folder.

It will respect cache-control headers if present. If no expiration is specified it will use a default of 5 minutes.

advanced usage
caddy.test { proxy / yourserver:5000 cache { match_path /assets match_header Content-Type image/jpg image/png status_header X-Cache-Status default_max_age 15m path /tmp/caddy-cache } }

You can specify more advanced options such as:

  • match_path: It will cache given path unless a header specifies otherwise (cache-control: private)

  • match_header: It will cache responses with given header. In the example: every response with Content-Type image/jpg OR image/png will be cached unless a header specifies otherwise

  • status_header: Is the header name to set with the cache status. The value will be one of the following: hit, miss, skip or bypass

  • defaultmaxage: It specifies the default expiration for cached responses when headers do not specify it.

  • path: where to store the responses. Make sure it exists and it is writable by caddy process.

Related Links
Documentation

Access the full documentation for this plugin off-site:

Docs
Plugin Help

Get help from the maintainers of the http.cache plugin:

Support
Plugin Website

Visit http.cache's website for more information:

Website
Plugin Author: Nicolas
Last Updated: 27 Jul 2017, 11:23 PM
This plugin is independent of the Caddy project and is not endorsed or maintained by Caddy developers. Use at your own risk. Do not file issues for this plugin on Caddy's bug tracker.