nginx Location配置總結(轉)

本文部分轉自:http://cssor.com/nginx-location-configuration.html

一. 開頭 

語法規則： location [=|~|~*|^~] /uri/ { … }

= 開頭表示精確匹配

^~  匹配 以指定字符串開頭的url路徑。nginx不對url作編碼，所以請求爲/static/20%/aa，能夠被規則^~ /static/ /aa匹配到（注意是空格）。

~ 開頭表示區分大小寫的正則匹配

~*  開頭表示不區分大小寫的正則匹配

!~和!~*分別爲區分大小寫不匹配及不區分大小寫不匹配 的正則

/ 通用匹配，任何請求都會匹配到。

多個location配置的狀況下匹配順序爲（參考資料而來，還未實際驗證，試試就知道了，沒必要拘泥，僅供參考）：

首先匹配 =，其次匹配^~, 其次是按文件中順序的正則匹配，最後是交給 / 通用匹配。當有匹配成功時候，中止匹配，按當前匹配規則處理請求。

例子，有以下匹配規則：

   

location =/ {
#規則A
}
location = /login {
#規則B
}
location ^~ /static/{
#規則C
}
location ~ \.(gif|jpg|png|js|css)$ {
#規則D
}
location ~* \.png$ {
#規則E
}
location !~ \.xhtml$ {
#規則F
}
location !~* \.xhtml$ {
#規則G
}
location /{
#規則H
}

 

那麼產生的效果以下：

訪問根目錄/， 好比http://localhost/ 將匹配規則A

訪問 http://localhost/login 將匹配規則B，http://localhost/register 則匹配規則H

訪問 http://localhost/static/a.html 將匹配規則C

訪問 http://localhost/a.gif, http://localhost/b.jpg 將匹配規則D和規則E，可是規則D順序優先，規則E不起做用， 而 http://localhost/static/c.png 則優先匹配到 規則C

訪問 http://localhost/a.PNG 則匹配規則E， 而不會匹配規則D，由於規則E不區分大小寫。

訪問 http://localhost/a.xhtml 不會匹配規則F和規則G，http://localhost/a.XHTML不會匹配規則G，由於不區分大小寫。規則F，規則G屬於排除法，符合匹配規則可是不會匹配到，因此想一想看實際應用中哪裏會用到。

訪問 http://localhost/category/id/1111 則最終匹配到規則H，由於以上規則都不匹配，這個時候應該是nginx轉發請求給後端應用服務器，好比FastCGI（php），tomcat（jsp），nginx做爲方向代理服務器存在。
因此實際使用中，我的以爲至少有三個匹配規則定義，以下：　　

#直接匹配網站根，經過域名訪問網站首頁比較頻繁，使用這個會加速處理，官網如是說。
#這裏是直接轉發給後端應用服務器了，也能夠是一個靜態首頁
# 第一個必選規則
location =/ {
　　proxy_pass http://tomcat:8080/index
}
 
# 第二個必選規則是處理靜態文件請求，這是nginx做爲http服務器的強項
# 有兩種配置模式，目錄匹配或後綴匹配,任選其一或搭配使用
location ^~/static/{
　　root /webroot/static/;
}
location ~* \.(gif|jpg|jpeg|png|css|js|ico)$ {
　　root /webroot/res/;
}
 
#第三個規則就是通用規則，用來轉發動態請求到後端應用服務器
#非靜態文件請求就默認是動態請求，本身根據實際把握
#畢竟目前的一些框架的流行，帶.php,.jsp後綴的狀況不多了
location /{
　　proxy_pass http://tomcat:8080/
}

 對於以上基礎推薦配置，有一個補充，就是關於轉發有一點須要注意。例以下面配置，對一個目錄轉發：　　

location ^~/outer/{
#case A： url最後以/結尾
proxy_pass http://tomcat:8080/
#case B： url最後沒有/
#proxy_pass http://tomcat:8080
}

 

關鍵在於最後的/，訪問localhost/outer/in.html，其中case A 會轉發到tomcat:8080/in.html， 而case B 會轉發到 tomcat:8080/outer/in.html，因此務必注意了。

二. 經常使用參數

  1. proxy_next_upstream

     nginx把任務分發給下層服務器，當下層某臺服務器在必定時期內(fail_timeout)連續返回超過規定次數(max_fails)錯誤代碼時，將這臺服務器禁用fail_timeout的時間。
     

相關配置:  

upstream echo_back {
  # 表示下層服務器 在60s內返回超過3次指定類型的錯誤以後,就將該臺服務器禁用60s.

  server 127.0.0.1:10251 max_fails=3  fail_timeout=60s;
  server 127.0.0.1:10252 max_fails=3  fail_timeout=60s;
}

  # 規定錯誤類型

proxy_next_upstream  http_500 http_502 http_503 http_504 error timeout invalid_header;

        

   2. proxy_pass 

      指定下層服務器地址或者對應的upstream模塊名     

upstream tomcat_web1 {
     server 127.0.0.1:8001  weight=10 max_fails=2 fail_timeout=30s;
}
server
{
      listen                   80;
      server_name              www.web1.com;
location / {
           proxy_pass  http://tomcat_web1;
      }
}

      關於此項參數的配置有一個注意點:   

下面四種狀況分別用http://192.168.1.4/proxy/test.html 進行訪問。

第一種：

location  /proxy/ {

          proxy_pass http://127.0.0.1:81/;

}

會被代理到http://127.0.0.1:81/test.html 這個url 

第二種(相對於第一種，最後少一個 /):

location  /proxy/ {

          proxy_pass http://127.0.0.1:81;

}

會被代理到http://127.0.0.1:81/proxy/test.html 這個url 

第三種：

location  /proxy/ {

          proxy_pass http://127.0.0.1:81/ftlynx/;

}

會被代理到http://127.0.0.1:81/ftlynx/test.html 這個url。 

第四種狀況(相對於第三種，最後少一個 / )：

location  /proxy/ {

          proxy_pass http://127.0.0.1:81/ftlynx;

}

會被代理到http://127.0.0.1:81/ftlynxtest.html 這個url 

3. proxy_set_header   

   該指令是nginx 的ngx_http_proxy_module模塊用於讀取配置信息並保存到指定變量裏。
   全部設置的值和http請求相同，除了Host外還有X-Forward-For，Host的含義是代表請求的目標主機名，
   X_Forward_For字段表示該條http請求是有誰發起的；
   常見用法以下，$http_host 和 $remote_addr分別被Http頭中的Host屬性和X-Forward-For屬性賦值

proxy_set_header Host $http_host;
proxy_set_header X-Forward-For $remote_addr;