Nginx中proxy_pass/proxy_redirect/proxy_set_header配置说明

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

设置对代理服务器响应头中的LocationRefresh字段的重写。

  • 该指令实现将代理服务器响应头中的字段“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参数的情况下,使用locationproxy_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工具使用说明

你可能感兴趣的:(Nginx中proxy_pass/proxy_redirect/proxy_set_header配置说明)