一、介紹ngx_headers_more

ngx_headers_more用于添加、設(shè)置和清除輸入和輸出的頭信息。nginx源碼中沒(méi)有包含該模塊，需要另行添加。

該模塊是ngx_http_headers_module模塊的增強(qiáng)版，提供了更多的實(shí)用工具，比如復(fù)位或清除內(nèi)置頭信息，如Content-Type, Content-Length, 和Server。

可以允許你使用-s選項(xiàng)指定HTTP狀態(tài)碼，使用-t選項(xiàng)指定內(nèi)容類型，通過(guò)more_set_headers 和 more_clear_headers 指令來(lái)修改輸出頭信息。如：

more_set_headers -s 404 -t 'text/html' 'X-Foo: Bar';

輸入頭信息也可以這么修改，如:

location /foo {more_set_input_headers 'Host: foo' 'User-Agent: faked';# now $host, $http_host, $user_agent, and # $http_user_agent all have their new values. }

-t選項(xiàng)也可以在more_set_input_headers和more_clear_input_headers 指令中使用。

不像標(biāo)準(zhǔn)頭模塊，該模塊的指示適用于所有的狀態(tài)碼，包括4xx和5xx的。add_header只適用于200,201,204,206,301,302,303,304,或307。

標(biāo)準(zhǔn)頭模塊ngx_http_headers_module參見(jiàn): 《ngx_http_headers_module模塊add_header和expires指令》

二、安裝ngx_headers_more

wget 'http://nginx.org/download/nginx-1.5.8.tar.gz' tar -xzvf nginx-1.5.8.tar.gz cd nginx-1.5.8/# Here we assume you would install you nginx under /opt/nginx/. ./configure --prefix=/opt/nginx \--add-module=/path/to/headers-more-nginx-modulemake make install

ngx_headers_more 包下載地址：http://github.com/agentzh/headers-more-nginx-module/tags

ngx_openresty包含該模塊。

三、指令說(shuō)明

more_set_headers

語(yǔ)法:more_set_headers [-t <content-type list>]... [-s <status-code list>]... <new-header>...

默認(rèn)值：no

配置段：http, server, location, location if

階段：輸出報(bào)頭過(guò)濾器

替換(如有)或增加（如果不是所有）指定的輸出頭時(shí)響應(yīng)狀態(tài)代碼與-s選項(xiàng)相匹配和響應(yīng)的內(nèi)容類型的-t選項(xiàng)指定的類型相匹配的。

如果沒(méi)有指定-s或-t，或有一個(gè)空表值，無(wú)需匹配。因此，對(duì)于下面的指定，任何狀態(tài)碼和任何內(nèi)容類型都講設(shè)置。

more_set_headers "Server: my_server";

具有相同名稱的響應(yīng)頭總是覆蓋。如果要添加頭，可以使用標(biāo)準(zhǔn)的add_header指令代替。

單個(gè)指令可以設(shè)置/添加多個(gè)輸出頭。如:

more_set_headers 'Foo: bar' 'Baz: bah';

在單一指令中，選項(xiàng)可以多次出現(xiàn)，如:

more_set_headers -s 404 -s '500 503' 'Foo: bar';

等同于:

more_set_headers -s '404 500 503' 'Foo: bar';

新的頭是下面形式之一:

Name: Value

Name:

Name

最后兩個(gè)有效清除的頭名稱的值。Nginx的變量允許是頭值，如:

set $my_var "dog";

more_set_headers "Server: $my_var";

注意：more_set_headers允許在location的if塊中，但不允許在server的if塊中。下面的配置就報(bào)語(yǔ)法錯(cuò)誤：

# This is NOT allowed! server {if ($args ~ 'download') {more_set_headers 'Foo: Bar';}... }

more_clear_headers

語(yǔ)法：more_clear_headers [-t <content-type list>]... [-s <status-code list>]... <new-header>...

默認(rèn)值：no

配置段：http, server, location, location if

階段：輸出報(bào)頭過(guò)濾器

清除指定的輸出頭:

more_clear_headers -s 404 -t 'text/plain' Foo Baz;

等同于

more_set_headers -s 404 -t 'text/plain' "Foo: " "Baz: ";

或

more_set_headers -s 404 -t 'text/plain' Foo Baz

也可以使用通配符*, 如:

more_clear_headers 'X-Hidden-*';

清除開(kāi)始由"X-Hidden-" 任何輸出頭。

more_set_input_headers

語(yǔ)法：more_set_input_headers [-r] [-t <content-type list>]... <new-header>...

默認(rèn)值：no

配置段：http, server, location, location if

階段：?rewrite tail

非常類似more_set_headers,不同的是它工作在輸入頭(或請(qǐng)求頭),它僅支持-t選項(xiàng)。

注意:使用-t選項(xiàng)的是過(guò)濾請(qǐng)求頭的Content-Type,而不是響應(yīng)頭的。

more_clear_input_headers

語(yǔ)法：more_clear_input_headers [-t <content-type list>]... <new-header>...

默認(rèn)值：no

配置段：http, server, location, location if

階段：?rewrite tail

清除指定輸入頭，如:

more_clear_input_headers -s 404 -t 'text/plain' Foo Baz; 等同于 more_set_input_headers -s 404 -t 'text/plain' "Foo: " "Baz: "; 或 more_set_input_headers -s 404 -t 'text/plain' Foo Baz

四、ngx_headers_more局限性

1.不同于標(biāo)準(zhǔn)頭模塊，該模塊不會(huì)對(duì)下面頭有效:Expires, Cache-Control,和Last-Modified。

2.使用此模塊無(wú)法刪除Connection的響應(yīng)報(bào)頭。唯一方法是更改src/http/ngx_http_header_filter_module.c文件。

五、使用ngx_headers_more

# set the Server output header more_set_headers 'Server: my-server';# set and clear output headers location /bar {more_set_headers 'X-MyHeader: blah' 'X-MyHeader2: foo';more_set_headers -t 'text/plain text/css' 'Content-Type: text/foo';more_set_headers -s '400 404 500 503' -s 413 'Foo: Bar';more_clear_headers 'Content-Type';# your proxy_pass/memcached_pass/or any other config goes here ... }# set output headers location /type {more_set_headers 'Content-Type: text/plain';# ... }# set input headers location /foo {set $my_host 'my dog';more_set_input_headers 'Host: $my_host';more_set_input_headers -t 'text/plain' 'X-Foo: bah';# now $host and $http_host have their new values ...# ... }# replace input header X-Foo *only* if it is already exists more_set_input_headers -r 'X-Foo: howdy';

六、應(yīng)用ngx_headers_more

修改web服務(wù)器是什么軟件、什么版本，同時(shí)隱藏Content-Type、Accept-Range、Content-Length頭信息。

more_set_headers "Server: ttlsa.com Web Server"; more_clear_headers "Content-Type:"; more_clear_headers "Accept-Ranges: "; more_clear_headers "Content-Length: ";

404狀態(tài)碼添加header

配置如下:

more_set_headers "Server: ttlsa.com Web Server"; more_set_headers -s 404 "Error: Not found"; more_clear_headers "Content-Type:"; more_clear_headers "Accept-Ranges: "; more_clear_headers "Content-Length: ";

總結(jié)

以上是生活随笔為你收集整理的nginx定制header返回信息模块ngx_headers_more的全部?jī)?nèi)容，希望文章能夠幫你解決所遇到的問(wèn)題。

如果覺(jué)得生活随笔網(wǎng)站內(nèi)容還不錯(cuò)，歡迎將生活随笔推薦給好友。