ngx_http_proxy_module

實(shí)現(xiàn)將請(qǐng)求轉(zhuǎn)發(fā)到其他服務(wù)器。

proxy_pass

語法： proxy_pass URL

默認(rèn)： -

上下文：locaiton，location中的if，limit_except

為location映射的服務(wù)器設(shè)置協(xié)議、地址、URI。

• 協(xié)議可以是http或者https；

• 地址可以是域名或者IP，可以同時(shí)指定端口；

• 地址也可以是以unix為前綴，包含在:中間的UNIX域名套接字路徑；

  proxy_pass http://unix:/tmp/backend.socket:/uri/;
  

• 如果proxy_pass指令中帶有URI，當(dāng)請(qǐng)求被轉(zhuǎn)發(fā)到服務(wù)器時(shí)，客戶端原請(qǐng)求中標(biāo)準(zhǔn)的URI將會(huì)被指令中URI替換；

  location /name/ {
      proxy_pass http://127.0.0.1/remote/;
  }
  

• 如果proxy_pass指令中沒有URI，當(dāng)請(qǐng)求被轉(zhuǎn)發(fā)到服務(wù)器時(shí)，將會(huì)使用客戶端原請(qǐng)求中的URI；

• 不可替換URI的情況

  • location通過正字表達(dá)式定義；

  • location內(nèi)部通過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;

默認(rèn)：proxy_redirect default;

上下文：http, server, location

設(shè)置對(duì)代理服務(wù)器響應(yīng)頭中的Location和Refresh字段的重寫。

• 該指令實(shí)現(xiàn)將代理服務(wù)器響應(yīng)頭中的字段“Location: http://localhost:8000/two/some/uri/”重寫為“Location: http://frontend/one/some/uri/”；

  proxy_redirect http://localhost:8000/two/ http://frontend/one/;
  

• 如果省略repacement字符串，如果默認(rèn)服務(wù)器不是80端口，那么將會(huì)插入默認(rèn)服務(wù)器的名稱和端口；

  proxy_redirect http://localhost:8000/two/ /;
  

• 指定default參數(shù)的情況下，使用location和proxy_pass的參數(shù)。如下兩個(gè)指令是等價(jià)的

  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參數(shù)；

• 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指令中允許使用正則表達(dá)式

  • 以~起始表示匹配時(shí)大小寫敏感；

    • 以~*起始表示匹配時(shí)大小寫不敏感；

    • redirect中可以包含命名和positional captures，然后在replacement中引用；

      proxy_redirect ~^(http://[^:]+):\d+(/.+)$ $1$2;
      proxy_redirect ~*/user/([^/]+)/(.+)$      http://$1.example.com/$2;
      

• 可以同時(shí)指定多個(gè)proxy_redirect，如果指定了off參數(shù)，表示當(dāng)前級(jí)別下的所有proxy_redirect指令將失效；

  proxy_redirect off;
  proxy_redirect default;
  proxy_redirect http://localhost:8000/  /;
  proxy_redirect http://www.example.com/ /;
  

• 下面指令實(shí)現(xiàn)給相對(duì)路徑上增加主機(jī)名；

  proxy_redirect / /;
  

proxy_set_header

語法： proxy_set_header field value;

默認(rèn)： proxy_set_header Host $proxy_host;

? proxy_set_header Connection close;

上下文： http, server, location

轉(zhuǎn)發(fā)請(qǐng)求到代理服務(wù)器時(shí)該指令允許重新定義或者追加消息頭中的字段。

• value的內(nèi)容可以使文本、變量或者二者的組合；

• 如果當(dāng)前指令中沒有定義proxy_set_header指令，則可以繼承上一級(jí)別中的定義；

• 默認(rèn)情況只重新定義兩個(gè)字段；

  proxy_set_header Host       $proxy_host;
  proxy_set_header Connection close;
  

• 其中緩存的情況，原始請(qǐng)求中的“If-Modified-Since”, “If-Unmodified-Since”, “If-None-Match”, “If-Match”, “Range”, 和“If-Range”不會(huì)轉(zhuǎn)發(fā)到代理服務(wù)器；

• 不改變請(qǐng)求頭中的"Host"字段的設(shè)置

  proxy_set_header Host       $http_host;
  

  如果客戶端請(qǐng)求頭中沒有http_host字段，則不會(huì)轉(zhuǎn)發(fā)到服務(wù)器，這種情況下使用$host變量相對(duì)更好，$host變量相當(dāng)于請(qǐng)求頭中Host字段中服務(wù)器名稱，或者請(qǐng)求頭中沒有Host字段時(shí)等價(jià)于主服務(wù)器的名稱；

  proxy_set_header Host       $host;
  

• 設(shè)置將服務(wù)器器名稱和端口一起轉(zhuǎn)發(fā)到代理服務(wù)器；

  proxy_set_header Host       $host:$proxy_port;
  

• 如果請(qǐng)求頭中的字段value為空字符串，則不會(huì)轉(zhuǎn)發(fā)到服務(wù)器；

  proxy_set_header Accept-Encoding "";
  

ngx_http_proxy_module自帶參數(shù)

自帶參數(shù)可以通過proxy_set_header指令使用。

$proxy_host

在proxy_pass指令中定義的代理服務(wù)器的名稱和端口

$proxy_port

在proxy_pass指令中定義的代理服務(wù)器的端口，或者是指定協(xié)議的默認(rèn)端口

$proxy_add_x_forwarded_for

表示客戶端請(qǐng)求頭中的X-Forwarded-For字段，該字段中包含$removte_addr變量，通過逗號(hào),分隔。如果客戶端請(qǐng)求頭中沒有出現(xiàn)X-Forwarded-For字段，remote_addr`。

ngx_http_proxy_module中的其他參數(shù)請(qǐng)參考官方網(wǎng)站

其他文章列表

spring web service系列1
spring web service系列2
spring web service系列3
maven配置文件settings.xml詳解
Nginx轉(zhuǎn)發(fā)請(qǐng)求過程解析
Nginx中的負(fù)載均衡算法
Nginx upstream指令配置說明
Nginx中虛擬服務(wù)器server指令配置說明
Nginx中ngx_http_core_module相關(guān)指令配置說明
Java自帶JVM監(jiān)控工具jstat使用詳細(xì)說明
Java自帶JVM監(jiān)控工具jps使用詳細(xì)說明
Java自帶故障分析工具jmap工具使用說明
Java自帶故障分析工具jhat工具使用說明