快捷導(dǎo)航

nginx中的路徑匹配location規(guī)則詳解

更新時(shí)間：2025年04月07日 09:40:12 作者：huangSir-devops

Nginx的匹配規(guī)則用location指令來(lái)實(shí)現(xiàn),Nginx 的location指令用于匹配請(qǐng)求的 URI（請(qǐng)求路徑）,并根據(jù)匹配結(jié)果執(zhí)行特定的處理指令,這篇文章主要介紹了nginx中的路徑匹配規(guī)則詳解（location規(guī)則）,需要的朋友可以參考下

Nginx的路徑匹配規(guī)則

Nginx的匹配規(guī)則用location指令來(lái)實(shí)現(xiàn)，Nginx 的location指令用于匹配請(qǐng)求的 URI（請(qǐng)求路徑），并根據(jù)匹配結(jié)果執(zhí)行特定的處理指令。location是實(shí)現(xiàn)動(dòng)靜分離、URL 重寫(xiě)、反向代理等功能的核心模塊之一.

location匹配規(guī)則分類(lèi)

location支持多種匹配模式，包括精確匹配、前綴匹配、正則匹配等

精確匹配（=）

優(yōu)先級(jí)最高。當(dāng)請(qǐng)求的URI與location后面的字符串完全相同時(shí)，Nginx會(huì)選擇這個(gè)location塊進(jìn)行處理。(這個(gè)好理解，就是路徑完全匹配，一模一樣，優(yōu)先級(jí)最高)
示例

location = /favicon.ico {
    # 處理/favicon.ico的請(qǐng)求
}

只有當(dāng)請(qǐng)求URI嚴(yán)格為/favicon.ico時(shí)，上述location塊才會(huì)被使用。

最長(zhǎng)前綴匹配（^~）

第二優(yōu)先級(jí)。請(qǐng)求的URI以某個(gè)location后面的字符串開(kāi)頭，并且這個(gè)字符串是最長(zhǎng)的（或者使用了^~修飾符），Nginx會(huì)選擇這個(gè)location塊。但請(qǐng)注意，^~修飾符實(shí)際上會(huì)停止后續(xù)的正則匹配搜索。
示例

   location ^~ /hello {
     return  601;
   }
    location ^~ /hellow {
     return  602;
   }
   location ^~ /hello/world {
     return  603;
   }
    location ~ /hello {
     return  604;
   }

對(duì)于請(qǐng)求/hello，滿(mǎn)足 601和 604，實(shí)際返回601，就是因?yàn)閊~優(yōu)先級(jí)高于正則匹配；
對(duì)于請(qǐng)求/hellow，滿(mǎn)足 601和 602，實(shí)際返回602，因?yàn)樽铋L(zhǎng)前綴匹配原則；

正則表達(dá)式匹配（~和~*）

第三優(yōu)先級(jí)。正則表達(dá)式匹配允許定義更復(fù)雜的URI匹配模式。~表示區(qū)分大小寫(xiě)的正則匹配，而~*表示不區(qū)分大小寫(xiě)的正則匹配。
Nginx會(huì)按照配置文件中的順序逐個(gè)檢查正則表達(dá)式location塊，直到找到第一個(gè)匹配的塊。因此，正則表達(dá)式的順序很重要。

示例：

location ~ \.(gif|jpg|png)$ {
    # 處理以.gif、.jpg或.png結(jié)尾的請(qǐng)求（區(qū)分大小寫(xiě)）
}
location ~* \.(GIF|JPG|PNG)$ {
    # 處理以.GIF、.JPG或.PNG結(jié)尾的請(qǐng)求（不區(qū)分大小寫(xiě)）
}

對(duì)于請(qǐng)求/images/photo.jpg，第一個(gè)location塊將被匹配（如果請(qǐng)求是區(qū)分大小寫(xiě)的）。

普通前綴匹配（無(wú)修飾符）

第四優(yōu)先級(jí)。普通前綴匹配也按照配置文件中出現(xiàn)的先后順序進(jìn)行匹配，先出現(xiàn)的location指令優(yōu)先匹配。
示例：

   location /hello {
     return  601;
   }
   location /hellow {
     return  602;
   }

對(duì)于請(qǐng)求/hellow，滿(mǎn)足 601和 602，實(shí)際返回602，證明滿(mǎn)足長(zhǎng)前綴匹配原則

默認(rèn)匹配（/）

優(yōu)先級(jí)最低。如果請(qǐng)求的URI與任何特定的location塊都不匹配，Nginx將使用默認(rèn)的location塊（如果有的話(huà)）。通常，默認(rèn)的location塊是一個(gè)不帶任何修飾符的location /塊。
示例：

location / {
    # 處理所有其他請(qǐng)求
}

總結(jié)

Nginx的location匹配規(guī)則優(yōu)先級(jí)可以總結(jié)為：

精確匹配（=）
最長(zhǎng)前綴匹配（^~），但會(huì)停止后續(xù)的正則匹配搜索
正則表達(dá)式匹配（~和~*），按配置順序
普通前綴匹配（無(wú)修飾符），也按配置順序
默認(rèn)匹配（/）

注意事項(xiàng)

正則匹配與順序：正則 location 的匹配順序很重要，因?yàn)?Nginx 會(huì)按照配置文件中定義的順序進(jìn)行匹配。
proxy_pass 的路徑替換：在配置 proxy_pass 時(shí)，需要注意 location 后面的 URI 是否包含斜杠（/），這會(huì)影響請(qǐng)求的轉(zhuǎn)發(fā)路徑。通常建議 location 和 proxy_pass 要么都加斜杠，要么都不加。
性能優(yōu)化：將精確匹配放在前面，可以減少不必要的正則匹配，提高 Nginx 的處理效率。

到此這篇關(guān)于nginx中的路徑匹配location規(guī)則詳解的文章就介紹到這了,更多相關(guān)nginx 路徑匹配規(guī)則內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

您可能感興趣的文章: