http.cache - Caddy User Guide

http.cache
Plugin

The cache directive adds http caching

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 - default_max_age: 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.

http.cache Plugin

Examples

http.cache
Plugin