一文弄懂Nginx的location匹配

frolc 發布于2019-07-25 14:10 / 1604人閱讀

摘要：修飾符表示精確匹配。結果沒有找到，因此使用先前標記的最長匹配，即配置。首先進行前綴字符的查找，找到最長匹配項，繼續進行正則查找，找到匹配項。主要用于內部重定向，不能用來處理正常的請求。因為根據約定，尾部的表示目錄，沒有表示文件。

由于團隊在進行前后端分離，前端接管了Nginx和node層，在日常的工作中，跟Nginx打交道的時候挺多的。之前對location的匹配規則是一知半解的，為了搞明白location是如何匹配的，查了些資料總結此文。希望能給大家帶來幫助。

語法規則

location [ = | ~ | ~* | ^~ ] uri { ... }
location @name { ... }

語法規則很簡單，一個location關鍵字，后面跟著可選的修飾符，后面是要匹配的字符，花括號中是要執行的操作。

修飾符

= 表示精確匹配。只有請求的url路徑與后面的字符串完全相等時，才會命中。

~ 表示該規則是使用正則定義的，區分大小寫。

~* 表示該規則是使用正則定義的，不區分大小寫。

^~ 表示如果該符號后面的字符是最佳匹配，采用該規則，不再進行后續的查找。

匹配過程

對請求的url序列化。例如，對%xx等字符進行解碼，去除url中多個相連的/，解析url中的.，..等。這一步是匹配的前置工作。

location有兩種表示形式，一種是使用前綴字符，一種是使用正則。如果是正則的話，前面有~或~*修飾符。

具體的匹配過程如下：

首先先檢查使用前綴字符定義的location，選擇最長匹配的項并記錄下來。

如果找到了精確匹配的location，也就是使用了=修飾符的location，結束查找，使用它的配置。

然后按順序查找使用正則定義的location，如果匹配則停止查找，使用它定義的配置。

如果沒有匹配的正則location，則使用前面記錄的最長匹配前綴字符location。

基于以上的匹配過程，我們可以得到以下兩點啟示：

使用正則定義的location在配置文件中出現的順序很重要。因為找到第一個匹配的正則后，查找就停止了，后面定義的正則就是再匹配也沒有機會了。

使用精確匹配可以提高查找的速度。例如經常請求/的話，可以使用=來定義location。

示例

接下來我們以一個例子來具體說明一下匹配過程。

假如我們有下面的一段配置文件：

location = / {
    [ configuration A ]
}

location / {
    [ configuration B ]
}

location /user/ {
    [ configuration C ]
}

location ^~ /images/ {
    [ configuration D ]
}

location ~* .(gif|jpg|jpeg)$ {
    [ configuration E ]
}

請求/精準匹配A，不再往下查找。

請求/index.html匹配B。首先查找匹配的前綴字符，找到最長匹配是配置B，接著又按照順序查找匹配的正則。結果沒有找到，因此使用先前標記的最長匹配，即配置B。

請求/user/index.html匹配C。首先找到最長匹配C，由于后面沒有匹配的正則，所以使用最長匹配C。
請求/user/1.jpg匹配E。首先進行前綴字符的查找，找到最長匹配項C，繼續進行正則查找，找到匹配項E。因此使用E。

請求/images/1.jpg匹配D。首先進行前綴字符的查找，找到最長匹配D。但是，特殊的是它使用了^~修飾符，不再進行接下來的正則的匹配查找，因此使用D。這里，如果沒有前面的修飾符，其實最終的匹配是E。大家可以想一想為什么。

請求/documents/about.html匹配B。因為B表示任何以/開頭的URL都匹配。在上面的配置中，只有B能滿足，所以匹配B。

location @name的用法

@用來定義一個命名location。主要用于內部重定向，不能用來處理正常的請求。其用法如下：

location / {
    try_files $uri $uri/ @custom
}
location @custom {
    # ...do something
}

上例中，當嘗試訪問url找不到對應的文件就重定向到我們自定義的命名location（此處為custom）。

值得注意的是，命名location中不能再嵌套其它的命名location。

URL尾部的/需不需要

關于URL尾部的/有三點也需要說明一下。第一點與location配置有關，其他兩點無關。

location中的字符有沒有/都沒有影響。也就是說/user/和/user是一樣的。

如果URL結構是https://domain.com/的形式，尾部有沒有/都不會造成重定向。因為瀏覽器在發起請求的時候，默認加上了/。雖然很多瀏覽器在地址欄里也不會顯示/。這一點，可以訪問baidu驗證一下。

如果URL的結構是https://domain.com/some-dir/。尾部如果缺少/將導致重定向。因為根據約定，URL尾部的/表示目錄，沒有/表示文件。所以訪問/some-dir/時，服務器會自動去該目錄下找對應的默認文件。如果訪問/some-dir的話，服務器會先去找some-dir文件，找不到的話會將some-dir當成目錄，重定向到/some-dir/，去該目錄下找默認文件。可以去測試一下你的網站是不是這樣的。

總結

location的配置有兩種形式，前綴字符和正則。查找匹配的時候，先查找前綴字符，選擇最長匹配項，再查找正則。正則的優先級高于前綴字符。

正則的查找是按照在配置文件中的順序進行的。因此正則的順序很重要，建議越精細的放的越靠前。

使用=精準匹配可以加快查找的順序，如果根域名經常被訪問的話建議使用=。

云服務器 GPU云服務器 nginx匹配優先級弄懂 Locator Location

文章版權歸作者所有，未經允許請勿轉載,若此文章存在違規行為，您可以聯系管理員刪除。

轉載請注明本文地址：http://specialneedsforspecialkids.com/yun/39791.html

[手把手系列之]Docker 部署 vue 項目

摘要：部署項目寫在前面作為輕量級虛擬化技術，擁有持續集成版本控制可移植性隔離性和安全性等優勢。容器可以被創建啟動停止刪除暫停等。重新運行應用容器直接基于鏡像來啟動容器，運行命令將宿主機的掛載到容器的目錄上。Docker 部署 vue 項目 1.寫在前面： Docker 作為輕量級虛擬化技術，擁有持續集成、版本控制、可移植性、隔離性和安全性等優勢。本文使用Docker來部署一個vue的前端應用，并盡...

VPointer 2019-05-22 16:41 評論0 收藏0
在開發環境下使用nginx重寫uri及代理功能

摘要：本文同步在個人博客上，歡迎關注這篇文章整理了在前端開發中，在開發環境下使用重寫及代理功能的方法。表示該規則是使用正則定義的，區分大小寫。因此牢記在上下文中使用，而在上下文中使用。本文同步在個人博客shymean.com上，歡迎關注這篇文章整理了在前端開發中，在開發環境下使用nginx重寫uri及代理功能的方法。參考 nginx中文文檔前端開發者必備的 Nginx 知識 Ngin...

LMou 2019-05-21 19:27 評論0 收藏0
徹底弄懂跨域問題

摘要：用于告知瀏覽器可以將預先檢查請求返回結果緩存的時間，在緩存有效期內，瀏覽器會使用緩存的預先檢查結果判斷是否發送跨域請求。跨域，老生常談的問題簡述作為一只前端菜鳥，跨域方面只懂得JSONP和CORS，并未曾深入了解。但隨著春招越來越近，就算是菜鳥也要猛振翅膀。近幾日仔細研究了跨域問題，寫下這篇文章，希望對開發者們有所幫助。在讀本文前，希望您對以下知識略有了解。瀏覽器同源策略 n...

rose 2019-07-25 14:36 評論0 收藏0
徹底弄懂跨域問題

摘要：瀏覽器同源策略我們為何要研究跨域問題因為瀏覽器的同源策略規定某域下的客戶端在沒明確授權的情況下，不能讀寫另一個域的資源。跨域，老生常談的問題簡述作為一只前端菜鳥，跨域方面只懂得JSONP和CORS，并未曾深入了解。但隨著春招越來越近，就算是菜鳥也要猛振翅膀。近幾日仔細研究了跨域問題，寫下這篇文章，希望對開發者們有所幫助。在讀本文前，希望您對以下知識略有了解。瀏覽器同源策略 n...

CoorChice 2019-08-23 14:41 評論0 收藏0
從一份配置清單詳解Nginx服務器配置

摘要：在本文中，我們繼續延續前文，從前文給出的一份示例配置清單開始，詳解一下服務器的各種配置指令的作用和用法。是否允許同時接收多個網絡連接指令格式該指令默認為狀態，意指每個一次只能接收一個新到達的網絡連接。本文已獲得原作者CodeSheep授權。showImg(https://segmentfault.com/img/remote/1460000015646704); 概述在前面《Ngi...

Achilles 2019-07-25 14:21 評論0 收藏0