Headers#
允许在响应头中添加 在响应码为 200、201 (1.3.10)、204、206、301、302、303、304、307 或 308 时,添加指定字段到响应头。参数值可以包含变量。 可以有多个 如果指定了 如果字段值在变量替换后为空字符串,则不会添加该字段。这样可以按条件添加字段: 对于 该指令以同样的方式处理 在响应码为 200、201、206、301、302、303、307 或 308 时,添加指定字段至响应的末尾。参数值可以包含变量。 可以有多个 如果指定了 如果字段值在变量替换后为空字符串,则不会添加该字段。 默认值 http, server, location, if in location 启用或禁用在响应码为 200、201、204、206、301、302、303、304、307 或 308 时添加或修改 此外,可以使用 "@" 前缀指定一天中的某个时间: 时间为负 — "Cache-Control: no-cache"。 时间为正或零 — "Cache-Control: max-age=t",其中 t 是指令中指定的时间,以秒为单位。 将 将 禁止添加或修改 最后的参数值可以包含变量:Expires 和 Cache-Control 头字段,以及任意字段。配置示例#
expires 24h;
expires modified +24h;
expires @24h;
expires 0;
expires -1;
expires epoch;
expires $expires;
add_header Cache-Control private;
指令#
add_header#
add_header 指令。只有在当前级别未定义任何 add_header 指令时,这些指令才会从上一级配置继承。always 参数,则无论响应码如何,都会添加该头字段。map $request_uri $robots_tag {
~^/private/ "noindex, nofollow";
default "";
}
add_header X-Robots-Tag $robots_tag;
ETag 和 Last-Modified 字段,该指令不会再添加第二个字段:如果响应中已有此类字段(例如提供静态文件时设置的,或从代理服务器接收的),该指令会将其替换。如果值为空字符串,该指令会从响应中删除此字段。与添加一样,替换和删除也取决于响应码和 always 参数。Content-Type 字段。如果从代理、FastCGI、uwsgi、SCGI 或 gRPC 服务器接收的字段带有 charset 参数,而新值没有,则该指令会保留该字符集。例如,将 text/html; charset=utf-8 替换为 application/json 后,结果为 application/json; charset=utf-8。add_trailer#
add_trailer 指令。只有在当前级别未定义任何 add_trailer 指令时,这些指令才会从上一级配置继承。always 参数,则无论响应码如何,都会添加该字段。expires#
expires [modified] 时间;expires epoch | max | off;expires off;Expires 和 Cache-Control 响应头字段。参数可以是正或负的 时间。Expires 字段中的时间是当前时间与指令中指定时间的总和。如果使用了 modified 参数,则时间是文件修改时间与指令中指定时间的总和。expires @15h30m;
Cache-Control 字段的内容取决于指定时间的符号:epochExpires 设置为 "Thu, 01 Jan 1970 00:00:01 GMT", Cache-Control 设置为 "no-cache"。maxExpires 设置为 "Thu, 31 Dec 2037 23:55:55 GMT", Cache-Control 设置为 10 年。offExpires 和 Cache-Control 响应头字段。map $sent_http_content_type $expires {
default off;
application/pdf 42d;
~image/ max;
}
expires $expires;