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工具使用说明