1. 程式人生 > 實用技巧 >Nginx location語法規則

Nginx location語法規則

一 location規則

1.1 location語法

基本語法: location [=|~|~*|^~]/uri/{...} 修飾符釋義:
  1 =	#表示精確嚴格匹配,只有請求的url路徑與後面的字串完全相等時,才會命中。同時若這個查詢匹配,將停止搜尋並立即處理此請求。
  2 ~	#表示該規則是使用正則定義的,且區分大小寫;
  3 ^~	#表示uri以某個常規字串開頭,匹配 URI 路徑。且nginx不對url做編碼,如請求為/static/20%/aa,可以被規則^~ /static/ /aa匹配到(注意是空格);
  4 ~*	#表示該規則是使用正則定義的,且不區分大小寫;
  5 /	#使用者所使用的代理(一般為瀏覽器);
  1 $http_x_forwarded_for	#通過代理伺服器來記錄客戶端的ip地址;
  2 $http_referer		#記錄使用者是從哪個連結訪問過來的。

1.2 location匹配過程

對請求的url序列化。例如,對%xx等字元進行解碼,去除url中多個相連的/,解析url中的.,..等。這一步是匹配的前置工作。 location有兩種表示形式,一種是使用字首字元,一種是使用帶~或~*修飾符的正則。 其相應的匹配過程如下:
  1. 如果找到了精確匹配的location,也就是使用了=修飾符的location,結束查詢,使用它的配置。
  2. 所有剩下的常規字串,採用最長匹配;
  3. 繼續判斷正則表示式的解析結果,按配置裡的正則表示式順序為準,由上至下開始匹配,一旦匹配成功1個,立即返回結果,並結束解析過程。
  4. 如果第3條規則產生匹配的話,結果被使用。否則,使用第2條規則的結果。
注意:普通命中順序無所謂,是因為按命中的長短來確定。正則命中,順序有所謂,因為是從前入往後命中的。 基於以上的匹配過程,我們可以得到以下兩點啟示:
  1. 使用正則定義的location在配置檔案中出現的順序很重要。因為找到第一個匹配的正則後,查詢就停止了,後續定義的匹配(不管精度如何)都不再進行查詢。
  2. 使用精確匹配可以提高查詢的速度。例如經常請求/的話,可以使用=來定義location。

1.3 location匹配優先順序

由location匹配規則可知,其匹配優先順序為:(location =) > (location 完整路徑) > (location ^~ 路徑) > (location ~,~* 正則順序) > (location 部分起始路徑) > (/) 。

二 location規則示例

2.1 環境預設

  1 [root@nginx01 ~]# vi /etc/nginx/conf.d/location.conf
  2 server {
  3     listen  80;
  4     server_name  location.linuxds.com;
  5     access_log  /var/log/nginx/location.access.log  main;
  6     error_log   /var/log/nginx/location.error.log  warn;
  7     location = / {
  8         add_header Content-Type text/plain;
  9         return 200 'A';
 10 # 精確匹配 / ,主機名後面不能帶任何字串
 11     }
 12     location = /login {
 13         add_header Content-Type text/plain;
 14         return 200 'B';
 15     }
 16     location ^~ /static/ {
 17         add_header Content-Type text/plain;
 18         return 200 'C';
 19 # 匹配任何以 /static/ 開頭的地址,匹配以後,不在往下檢索正則,立即採用這一條。
 20     }
 21     location ^~ /static/files {
 22         add_header Content-Type text/plain;
 23         return 200 'D';
 24 # 匹配任何以 /static/files 開頭的地址,匹配以後,不在往下檢索正則,立即採用這一條。
 25     }
 26     location ~ \.(gif|jpg|png|js|css|txt) {
 27         add_header Content-Type text/plain;
 28         return 200 'E';
 29     }
 30     location ~* \.txt$ {
 31         add_header Content-Type text/plain;
 32         return 200 'F';
 33 # 匹配所有以 txt 結尾的請求
 34 # 然而,所有請求 /static/ 下的txt會被 規則 C 處理,因為 ^~ 到達不了這一條正則。
 35     }
 36     location /image {
 37         add_header Content-Type text/plain;
 38         return 200 'G';
 39 # 匹配任何以 /image/ 開頭的地址,匹配符合以後,還要繼續往下搜尋;
 40 # 只有後面的正則表示式沒有匹配到時,這一條才會採用這一條。
 41     }
 42     location / {
 43         add_header Content-Type text/plain;
 44         return 200 'H';
 45 # 因為所有的地址都以 / 開頭,所以這條規則將匹配到所有請求。
 46 # 但是正則和最長字串會優先匹配。
 47     }
 48 }
  1 [root@nginx ~]# nginx -t -c /etc/nginx/nginx.conf	#檢查配置檔案
  2 [root@nginx ~]# nginx -s reload				#過載配置檔案

2.2 匹配測試

訪問:http://location.linuxds.com/,將匹配規則A: 訪問:http://location.linuxds.com/login,將匹配規則B: 訪問:http://location.linuxds.com/static/test.html,將匹配規則C: 訪問:http://location.linuxds.com/static/files/test.txt,將匹配規則D: 解釋:雖然也符合規則C,但基於最大匹配原則,因此優先選擇規則D。 訪問:http://location.linuxds.com/test.txt,將匹配規則E: 解釋:雖然也符合規則F,但正則中基於順序優先,因此優先選擇規則E。 訪問:http://location.linuxds.com/static/test.txt,將匹配規則C: 解釋:雖然也符合規則F,但基於匹配優先順序^~ > ~,~*,因此優先選擇規則C。 訪問:http://location.linuxds.com/test.TXT,將匹配規則G: 解釋:規則E區分大小寫,規則F不區分大小寫,因此優先選擇規則F。 訪問:http://location.linuxds.com/image/test.txt,將匹配規則E: 解釋:雖然也符合規則Y,但基於正則匹配優先,因此優選選擇規則E。 訪問:http://location.linuxds.com/image/test.tiff,將匹配規則G: 解釋:沒有更高優先順序的其他規則(正則或=),因此匹配規則G。 訪問:http://location.linuxds.com/work/1234,將匹配規則I: 解釋:如上除H之外所有規則都不匹配,所有的地址都以 / 開頭,所以這條規則將作為最後匹配規則。 參考: http://www.zzvips.com/article/33760.html https://juejin.im/post/5ce5e1f65188254159084141 http://www.zzvips.com/article/33760.html https://www.nginx.cn/doc/standard/httpcore.html #官方參考

三 正則與判斷

參考:https://blog.csdn.net/weixin_33726943/article/details/86007331