HTTP头信息,是实际业务中一个很重要的功能。例如,如果需要将请求结果在浏览器上缓存一段时间,或者在请求代理到后端服务器的过程中生成一个唯一的 ID进行识别。通过对 Nginx进行配置,可以轻松实现这些功能。

ngx_http_headers_module是在 Nginx编译时默认自带的模块,主要包含 add_header和 expires两个指令。

使用语法

expires

expires语法: expires [modified] time; expires epoch | max | off;

默认值: expires off;

环境: http、 server、 location、 if in location

用途:设置 Expires和 Cache-Control响应头字段,主要作用是控制缓存时间,如在浏览器上的缓存时间、 CDN的缓存时间。参数值可以是正数、负数或零;

示例如下:

nginx 请求头大小 nginx headers设置_Nginx


如果要求在浏览器第一次访问后,数据在浏览器上缓存 1h,则配置如下:

nginx 请求头大小 nginx headers设置_nginx 请求头大小_02


此配置只能在 HTTP状态码是 200、 201、 204、 206、 301、 302、 303、 304、 307或 308时才会生效。

即只有当请求处于正常的返回状态时,才会发送缓存头,毕竟在浏览器上缓存一个错误状态不是什么好事情。

在 Nginx 1.7.9版本之后, expires指令可以使用变量来配置响应头,并根据响应头的 Content-Type来定义缓存时间,也就是可以根据不同的条件动态地调整缓存时间。

例如,如果 Content-Type是 application/ pdf,则添加 cache-control: max-age = 3600响应头信息;如果 Content-Type是 image/,则添加 ache-control: max-age = 36000响应头信息;如果没有匹配到对应的 Content-Type,则执行 default的配置 off,即不进行缓存,代码如下:

nginx 请求头大小 nginx headers设置_响应头_03

nginx 请求头大小 nginx headers设置_Nginx模块_04


在上述配置中, map指令会根据响应头 Content_ Type的值对 $expires进行赋值(通过 $ sent_ http_ content_ type获取 Content-Type的值)。

add_ header

语法: add_ header name value [always];

默认值:无

环境: http、 server、 location、 if in location

用途:添加自定义的响应头。

例如,可以用来添加 Cache-Control响应头,以达到 expires指令的效果,不过它不如 expires那样简洁、明了。

示例如下:

nginx 请求头大小 nginx headers设置_nginx 请求头大小_05


在默认情况下, add_ header只能在 HTTP状态码是 200、 201、 204、 206、 301、 302、 303、 304、 307或 308时输出响应头,如果出现 404、 500等异常状态码则无法输出响应头。

但 Nginx 1. 7. 5以上的版本新增了 always参数,使之可以在任何 HTTP状态下输出响应头,示例如下:响应头信息输出如下:测试结果表明,即使发生了 500错误,加入 always参数后依然可以输出 add_header响应头信息。

nginx 请求头大小 nginx headers设置_响应头_06