ngx_http_proxy_module

實現(xiàn)將請求轉發(fā)到其他服務器。

proxy_pass

語法： proxy_pass URL

默認： -

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

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

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

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

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

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

• 如果proxy_pass指令中帶有URI，當請求被轉發(fā)到服務器時，客戶端原請求中標準的URI將會被指令中URI替換；

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

• 如果proxy_pass指令中沒有URI，當請求被轉發(fā)到服務器時，將會使用客戶端原請求中的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字段的重寫。

• 該指令實現(xiàn)將代理服務器響應頭中的字段“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參數(shù)的情況下，使用location和proxy_pass的參數(shù)。如下兩個指令是等價的

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

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

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

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

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

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

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

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

  proxy_redirect / /;
  

proxy_set_header

語法： proxy_set_header field value;

默認： proxy_set_header Host $proxy_host;

? proxy_set_header Connection close;

上下文： http, server, location

轉發(fā)請求到代理服務器時該指令允許重新定義或者追加消息頭中的字段。

• 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”不會轉發(fā)到代理服務器；

• 不改變請求頭中的"Host"字段的設置

  proxy_set_header Host       $http_host;
  

  如果客戶端請求頭中沒有http_host字段，則不會轉發(fā)到服務器，這種情況下使用$host變量相對更好，$host變量相當于請求頭中Host字段中服務器名稱，或者請求頭中沒有Host字段時等價于主服務器的名稱；

  proxy_set_header Host       $host;
  

• 設置將服務器器名稱和端口一起轉發(fā)到代理服務器；

  proxy_set_header Host       $host:$proxy_port;
  

• 如果請求頭中的字段value為空字符串，則不會轉發(fā)到服務器；

  proxy_set_header Accept-Encoding "";
  

ngx_http_proxy_module自帶參數(shù)

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

$proxy_host

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

$proxy_port

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

$proxy_add_x_forwarded_for

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

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

其他文章列表

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