詳解Nginx location 匹配規則


語法規則

location [=|~|~*|^~] /uri/ { … }

前綴匹配時,Nginx 不對 url 做編碼,因此請求為 /static/20%/aa ,可以被規則 ^~ /static/ /aa 匹配到(注意是空格)

匹配成功后,url的 域名+port 替換為root指定的目錄,

以請求https://www.cnblogs.com:8080/benwu/articles/2283622.html為例,
1: location配置如下

location /benwu {   root /home/files/; }

匹配到/benwu,url中的域名+port替換為root指定的目錄,即將請求地址中的https://www.cnblogs.com:8080被替換為了/home/files/,
所以在服務器端實際訪問的路徑是:/home/files/benwu/articles/2283622.html

2: location配置如下

location /benwu/articles {   root /home/files/; }

匹配到 /benwu/articles,url的域名+port替換為root指定的目錄,即url中的https://www.cnblogs.com:8080被替換為了/home/files,
所以實際訪問的路徑仍然是:/home/files/benwu/articles/2283622.html。
root在替換時不會替換匹配到的路徑

 

多個 location 配置的情況下匹配順序為

首先精確匹配 = ,如果匹配成功,則停止其他匹配
其次前綴匹配 ^~
其次是按文件中順序的正則匹配
然后匹配不帶任何修飾的前綴匹配。
最后是交給 / 通用匹配
當有匹配成功時候,停止匹配,按當前匹配規則處理請

location匹配順序
"="前綴指令匹配,如果匹配成功,則停止其他匹配
普通字符串指令匹配,順序是從長到短,匹配成功的location如果使用^~,則停止其他匹配(正則匹配)
正則表達式指令匹配,按照配置文件里的順序,成功就停止其他匹配
如果第三步中有匹配成功,則使用該結果,否則使用第二步結果
最后是交給 / 通用匹配

注意點
匹配的順序是先匹配普通字符串,然后再匹配正則表達式。另外普通字符串匹配順序是根據配置中字符長度從長到短,也就是說使用普通字符串配置的location順序是無關緊要的,反正最后nginx會根據配置的長短來進行匹配,但是需要注意的是正則表達式按照配置文件里的順序測試。找到第一個比配的正則表達式將停止搜索。

一般情況下,匹配成功了普通字符串location后還會進行正則表達式location匹配。有兩種方法改變這種行為,其一就是使用“=”前綴,這時執行的是嚴格匹配,並且匹配成功后立即停止其他匹配,同時處理這個請求;另外一種就是使用“^~”前綴,如果把這個前綴用於一個常規字符串那么告訴nginx 如果路徑匹配那么不測試正則表達式。

匹配模式及順序

=    #用於標准uri前,需要請求字串與uri完全匹配,如果匹配成功就停止向下匹配並立即處理請求。
~    #區分大小寫
~*    #不區分大寫
!~    #區分大小寫不匹配
!~*   #不區分大小寫不匹配
^    #匹配正則開頭
$    #匹配正則結尾
\    #轉義字符。可以轉. * ?等
*    #代表任意長度的任意字符

location = /uri      #開頭表示精確匹配,只有完全匹配上才能生效。
location ^~ /uri    #開頭對URL路徑進行前綴匹配,並且在正則之前。
location ~ pattern          #開頭表示區分大小寫的正則匹配。
location ~* pattern        #開頭表示不區分大小寫的正則匹配。
location /uri             #不帶任何修飾符,也表示前綴匹配,但是在正則匹配之后。
location /                       #通用匹配,任何未匹配到其它location的請求都會匹配到,相當於switch中的default。

#不區分大小寫匹配任何以gif、jpg、jpeg結尾的請求
location ~* .(gif|jpg|jpeg)$ {  
     
}

#區分大小寫匹配以.txt結尾的請求,並設置此location的路徑是/usr/local/nginx/html/。也就是以.txt結尾的請求將訪問/usr/local/nginx/html/ 路徑下的txt文件
location ~ ^.+\.txt$ {
    root /usr/local/nginx/html/;
}

# ^~ 以 /admin/ 開頭的請求,都會匹配上
location ^~ /admin/ {
   root /xvdb/mobai/
}

此時 /xvdb/mobai/目錄中必須要有 admin 文件夾

#匹配成功: http://www.cnblogs.com/admin/index.jsp
#匹配成功: http://www.cnblogs.com/admin/login.jsp

#忽略大小寫,包含/Images/
location ~* /Images/ {
}
#匹配成功: http://www.cnblogs.com/test/Images/     
#匹配成功: http://www.cnblogs.com/images/    


#不加任何規則則時,默認是大小寫敏感,前綴匹配,相當於加了“^”與“~”
location /index/ {
}
#匹配成功: http://www.cnblogs.com/index
#匹配成功: http://www.cnblogs.com/index/index.html
#匹配失敗: http://www.cnblogs.com/test/index
#匹配失敗: http://www.cnblogs.com/Index

 
#精確匹配, 只匹配http://www.cnblogs.com
location = / {
}
#匹配成功: http://www.cnblogs.com 
#匹配失敗: http://www.cnblogs.com/index

# 匹配到所有url
location / {

}

例子,有如下匹配規則:

location = / { echo "規則A"; } location = /login { echo "規則B"; } location^~ /static/ { echo "規則C"; } location^~ /static/files { echo "規則X"; } location ~ \.(gif|jpg|png|js|css)$ { echo "規則D"; } location ~* \.png$ { echo "規則E"; } location /img { echo "規則Y"; } location / { echo "規則F"; }

那么產生的效果如下:

訪問根目錄 / ,比如 http://localhost/ 將匹配 規則A
訪問 http://localhost/login 將匹配 規則B , http://localhost/register 則匹配 規則F
訪問 http://localhost/static/a.html 將匹配 規則C
訪問 http://localhost/static/files/a.exe 將匹配 規則X ,雖然 規則C 也能匹配到,但因為最大匹配原則,最終選中了 規則X 。你可以測試下,去掉規則 X ,則當前 URL 會匹配上 規則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/img/a.gif 會匹配上 規則D ,雖然 規則Y 也可以匹配上,但是因為正則匹配優先,而忽略了 規則Y 。
訪問 http://localhost/img/a.tiff 會匹配上 規則Y 。
訪問 http://localhost/category/id/1111 則最終匹配到規則 F ,因為以上規則都不匹配,這個時候應該是 Nginx 轉發請求給后端應用服務器,比如 FastCGI(php),tomcat(jsp),Nginx 作為反向代理服務器存在。

 

詳解nginx的root與alias 

以請求https://www.cnblogs.com:8080/benwu/articles/2283622.html為例,
測試1: location配置如下

location /benwu {   root /home/files/; }

匹配到/benwu,將url中的 前綴(ip/域名)+port+匹配到的路徑 替換為alias指定的目錄,
即url中的https://www.cnblogs.com:8080/benwu 被替換為了/home/files/,所以實際訪問的路徑為/home/files/articles/2283622.html

測試2: location配置如下

location /benwu/articles {   root /home/files/; }

匹配到/home/files,將url中的 前綴(ip/域名)+port+匹配到的路徑 替換為alias指定的目錄,
即url中的https://www.cnblogs.com:8080/benwu 被替換為了/home/files/,所以實際訪問的路徑為/home/files/2283622.html
alias在替換時會替換匹配到的路徑

alias其余特性,最左匹配、index、location解析url工作流程、末尾’/'與root一致。

 

所以實際使用中,筆者覺得至少有三個匹配規則定義,如下:

# 直接匹配網站根,通過域名訪問網站首頁比較頻繁,使用這個會加速處理,官網如是說。
# 這里是直接轉發給后端應用服務器了,也可以是一個靜態首頁
# 第一個必選規則 

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/
}


rewrite 語法

last – 基本上都用這個 Flag
break – 中止 Rewirte,不再繼續匹配
redirect – 返回臨時重定向的 HTTP 狀態 302
permanent – 返回永久重定向的 HTTP 狀態 301


1、下面是可以用來判斷的表達式:

-f 和 !-f   用來判斷是否存在文件
-d 和 !-d   用來判斷是否存在目錄
-e 和 !-e   用來判斷是否存在文件或目錄
-x 和 !-x   用來判斷文件是否可執行


2、下面是可以用作判斷的全局變量

例:

http://localhost:88/test1/test2/test.php?k=v
$host:localhost $server_port:88 $request_uri:/test1/test2/test.php?k=v
$document_uri:/test1/test2/test.php
$document_root:D:\nginx/html
$request_filename:D:\nginx/html/test1/test2/test.php

redirect 語法

server { listen 80; server_name start.igrow.cn; index index.html index.php; root html; if ($http_host !~ "^star\.igrow\.cn$") { rewrite ^(.*) http://star.igrow.cn$1 redirect;
 } } 

防盜鏈 

location ~* \.(gif|jpg|swf)$ { valid_referers none blocked start.igrow.cn sta.igrow.cn; if ($invalid_referer) { rewrite ^/ http://$host/logo.png;
 } }

根據文件類型設置過期時間 

location ~* \.(js|css|jpg|jpeg|gif|png|swf)$ { if (-f $request_filename) { expires 1h; break; } }

 

參考文檔:http://www.zzvips.com/article/33760.html

 


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM