ngx_http_proxy_module
實現將請求轉發到其他服務器。
proxy_pass
語法:
proxy_pass URL
默認:
-
上下文:locaiton,location中的if,limit_except
為location
映射的服務器設置協議、地址、URI。
協議可以是
http
或者https
;地址可以是域名或者IP,可以同時指定端口;
-
地址也可以是以
unix
為前綴,包含在:
中間的UNIX域名套接字路徑;proxy_pass http://unix:/tmp/backend.socket:/uri/;
-
如果
proxy_pass
指令中帶有URI,當請求被轉發到服務器時,客戶端原請求中標準的URI將會被指令中URI替換;location /name/ { proxy_pass http://127.0.0.1/remote/; }
如果
proxy_pass
指令中沒有URI,當請求被轉發到服務器時,將會使用客戶端原請求中的URI;-
不可替換URI的情況
location
通過正字表達式定義;-
location
內部通過rewrite指令修改過URI;location /name/ { rewrite /name/([^/]+) /users?name=$1 break; proxy_pass http://127.0.0.1; }
-
proxy_pass
指令中使用變量;location /name/ { proxy_pass http://127.0.0.1$request_uri; }
proxy_redirect
語法:proxy_redirect default;
? proxy_redirect off;
? proxy_redirect redirect replacement;
默認:proxy_redirect default;
上下文:http, server, location
設置對代理服務器響應頭中的Location
和Refresh
字段的重寫。
-
該指令實現將代理服務器響應頭中的字段“
Location: http://localhost:8000/two/some/uri/
”重寫為“Location: http://frontend/one/some/uri/
”;proxy_redirect http://localhost:8000/two/ http://frontend/one/;
-
如果省略
repacement
字符串,如果默認服務器不是80
端口,那么將會插入默認服務器的名稱和端口;proxy_redirect http://localhost:8000/two/ /;
-
指定
default
參數的情況下,使用location
和proxy_pass
的參數。如下兩個指令是等價的location /one/ { proxy_pass http://upstream:port/two/; proxy_redirect default;
location /one/ { proxy_pass http://upstream:port/two/; proxy_redirect http://upstream:port/two/ /one/;
proxy_pass
指令中有變量的情況下,proxy_redirect
指令不能指定default
參數;-
replacement
中可以使用變量,redirect
從1.1.11版本開始也可以使用變量;proxy_redirect http://localhost:8000/ http://$host:$server_port/;
proxy_redirect http://$proxy_host:8000/ /;
-
從1.1.11版本開始
proxy_redirect
指令中允許使用正則表達式-
以
~
起始表示匹配時大小寫敏感;以
~*
起始表示匹配時大小寫不敏感;-
redirect
中可以包含命名和positional captures,然后在replacement
中引用;proxy_redirect ~^(http://[^:]+):\d+(/.+)$ $1$2; proxy_redirect ~*/user/([^/]+)/(.+)$ http://$1.example.com/$2;
-
-
可以同時指定多個
proxy_redirect
,如果指定了off
參數,表示當前級別下的所有proxy_redirect
指令將失效;proxy_redirect off; proxy_redirect default; proxy_redirect http://localhost:8000/ /; proxy_redirect http://www.example.com/ /;
-
下面指令實現給相對路徑上增加主機名;
proxy_redirect / /;
proxy_set_header
語法: proxy_set_header field value;
默認: proxy_set_header Host $proxy_host;
? proxy_set_header Connection close;
上下文: http, server, location
轉發請求到代理服務器時該指令允許重新定義或者追加消息頭中的字段。
value
的內容可以使文本、變量或者二者的組合;如果當前指令中沒有定義
proxy_set_header
指令,則可以繼承上一級別中的定義;-
默認情況只重新定義兩個字段;
proxy_set_header Host $proxy_host; proxy_set_header Connection close;
其中緩存的情況,原始請求中的“If-Modified-Since”, “If-Unmodified-Since”, “If-None-Match”, “If-Match”, “Range”, 和“If-Range”不會轉發到代理服務器;
-
不改變請求頭中的"Host"字段的設置
proxy_set_header Host $http_host;
如果客戶端請求頭中沒有
http_host
字段,則不會轉發到服務器,這種情況下使用$host
變量相對更好,$host
變量相當于請求頭中Host
字段中服務器名稱,或者請求頭中沒有Host
字段時等價于主服務器的名稱;proxy_set_header Host $host;
-
設置將服務器器名稱和端口一起轉發到代理服務器;
proxy_set_header Host $host:$proxy_port;
-
如果請求頭中的字段
value
為空字符串,則不會轉發到服務器;proxy_set_header Accept-Encoding "";
ngx_http_proxy_module自帶參數
自帶參數可以通過proxy_set_header
指令使用。
$proxy_host
在proxy_pass
指令中定義的代理服務器的名稱和端口
$proxy_port
在proxy_pass
指令中定義的代理服務器的端口,或者是指定協議的默認端口
$proxy_add_x_forwarded_for
表示客戶端請求頭中的X-Forwarded-For
字段,該字段中包含$removte_addr
變量,通過逗號,
分隔。如果客戶端請求頭中沒有出現X-Forwarded-For字段,
remote_addr`。
ngx_http_proxy_module中的其他參數請參考官方網站
其他文章列表
spring web service系列1
spring web service系列2
spring web service系列3
maven配置文件settings.xml詳解
Nginx轉發請求過程解析
Nginx中的負載均衡算法
Nginx upstream指令配置說明
Nginx中虛擬服務器server指令配置說明
Nginx中ngx_http_core_module相關指令配置說明
Java自帶JVM監控工具jstat使用詳細說明
Java自帶JVM監控工具jps使用詳細說明
Java自帶故障分析工具jmap工具使用說明
Java自帶故障分析工具jhat工具使用說明