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字段,proxy_add_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工具使用說明

最后編輯于
?著作權歸作者所有,轉載或內容合作請聯系作者
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發布,文章內容僅代表作者本人觀點,簡書系信息發布平臺,僅提供信息存儲服務。
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市,隨后出現的幾起案子,更是在濱河造成了極大的恐慌,老刑警劉巖,帶你破解...
    沈念sama閱讀 228,156評論 6 531
  • 序言:濱河連續發生了三起死亡事件,死亡現場離奇詭異,居然都是意外死亡,警方通過查閱死者的電腦和手機,發現死者居然都...
    沈念sama閱讀 98,401評論 3 415
  • 文/潘曉璐 我一進店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人,你說我怎么就攤上這事。” “怎么了?”我有些...
    開封第一講書人閱讀 176,069評論 0 373
  • 文/不壞的土叔 我叫張陵,是天一觀的道長。 經常有香客問我,道長,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 62,873評論 1 309
  • 正文 為了忘掉前任,我火速辦了婚禮,結果婚禮上,老公的妹妹穿的比我還像新娘。我一直安慰自己,他們只是感情好,可當我...
    茶點故事閱讀 71,635評論 6 408
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著,像睡著了一般。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發上,一...
    開封第一講書人閱讀 55,128評論 1 323
  • 那天,我揣著相機與錄音,去河邊找鬼。 笑死,一個胖子當著我的面吹牛,可吹牛的內容都是我干的。 我是一名探鬼主播,決...
    沈念sama閱讀 43,203評論 3 441
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了?” 一聲冷哼從身側響起,我...
    開封第一講書人閱讀 42,365評論 0 288
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后,有當地人在樹林里發現了一具尸體,經...
    沈念sama閱讀 48,881評論 1 334
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內容為張勛視角 年9月15日...
    茶點故事閱讀 40,733評論 3 354
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發現自己被綠了。 大學時的朋友給我發了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 42,935評論 1 369
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖,靈堂內的尸體忽然破棺而出,到底是詐尸還是另有隱情,我是刑警寧澤,帶...
    沈念sama閱讀 38,475評論 5 358
  • 正文 年R本政府宣布,位于F島的核電站,受9級特大地震影響,放射性物質發生泄漏。R本人自食惡果不足惜,卻給世界環境...
    茶點故事閱讀 44,172評論 3 347
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧,春花似錦、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 34,582評論 0 26
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至,卻和暖如春,著一層夾襖步出監牢的瞬間,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 35,821評論 1 282
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人。 一個月前我還...
    沈念sama閱讀 51,595評論 3 390
  • 正文 我出身青樓,卻偏偏與公主長得像,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當晚...
    茶點故事閱讀 47,908評論 2 372

推薦閱讀更多精彩內容