模块 ngx_http_headers_module

ngx_http_headers_module 模块允许向响应头添加“Expires”和“Cache-Control”头字段以及任意字段。

expires    24h;
expires    modified +24h;
expires    @24h;
expires    0;
expires    -1;
expires    epoch;
expires    $expires;
add_header Cache-Control private;

如果响应代码等于 200、201（1.3.10）、204、206、301、302、303、304、307（1.1.16、1.0.13）或 308（1.13.0），则将指定的字段添加到响应头中。参数值可以包含变量。

可以有多个 add_header 指令。如果在当前级别没有定义 add_header 指令，则这些指令将从上一级配置继承。

如果指定了 always 参数（1.7.5），则无论响应代码如何，都将添加头字段。

如果响应代码等于 200、201、206、301、302、303、307 或 308，则将指定的字段添加到响应的末尾。参数值可以包含变量。

可以有多个 add_trailer 指令。如果在当前级别没有定义 add_trailer 指令，则这些指令将从上一级配置继承。

如果指定了 always 参数，则无论响应代码如何，都将添加指定的字段。

expires off;

启用或禁用添加或修改“Expires”和“Cache-Control”响应头字段，前提是响应代码等于 200、201（1.3.10）、204、206、301、302、303、304、307（1.1.16、1.0.13）或 308（1.13.0）。参数可以是正数或负数 时间。

“Expires”字段中的时间计算为当前时间与指令中指定的 time 的总和。如果使用 modified 参数（0.7.0、0.6.32），则时间计算为文件修改时间与指令中指定的 time 的总和。

此外，可以使用“@”前缀（0.7.9、0.6.34）指定一天中的时间。

expires @15h30m;

“Cache-Control”字段的内容取决于指定时间的符号

• 时间为负数 — “Cache-Control: no-cache”。
• 时间为正数或零 — “Cache-Control: max-age=t”，其中 t 是指令中指定的时间，以秒为单位。

epoch 参数将“Expires”设置为“Thu, 01 Jan 1970 00:00:01 GMT”，并将“Cache-Control”设置为“no-cache”。

max 参数将“Expires”设置为“Thu, 31 Dec 2037 23:55:55 GMT”，并将“Cache-Control”设置为 10 年。

off 参数禁用添加或修改“Expires”和“Cache-Control”响应头字段。

最后一个参数值可以包含变量（1.7.9）

map $sent_http_content_type $expires {
    default         off;
    application/pdf 42d;
    ~image/         max;
}

expires $expires;