Nginx作為一個高性能的Web服務器和反向代理服務器，廣泛用于負載均衡、請求轉發等場景。在配置Nginx時，路由匹配規則是非常重要的概念，它決定了請求如何被轉發到不同的處理邏輯或后端服務中。本文將詳細介紹Nginx的路由匹配規則及其優先級，幫助你更好地理解如何配置路由以及如何調試和優化Nginx配置。

一、 Nginx的路由匹配規則概述

在Nginx的配置中，路由匹配通常是通過location指令實現的。Nginx會根據請求的URI（Uniform Resource Identifier）與配置中的location塊進行匹配，從而決定請求如何處理。

例如，下面是一個簡單的server塊，其中包含了多個location塊：

location / {

root /var/www/html;

}

location /images/ {

root /var/www/images;

}

location /static/ {

root /var/www/static;

}

• 在上面的配置中，location塊根據請求的URI（例如/images/abc.jpg）來匹配適當的處理邏輯。每個location塊包含一個匹配規則，Nginx會根據規則優先級從上到下逐一檢查，直到找到一個最匹配的location塊。

二、 Nginx的路由匹配規則類型

Nginx的location指令支持幾種不同的匹配模式，不同的模式有不同的匹配邏輯和優先級。理解這些規則的優先級是配置Nginx路由的關鍵。

2.1 精確匹配（=）

精確匹配是指請求的URI必須完全匹配配置中的location塊。如果URI與location塊的字符串完全一致，則會匹配此location塊。

例如:

location = /hello {

return 200 "Hello, World!";

}

• 當訪問/hello時，Nginx將返回Hello, World!，其他任何URI（如/hello/）都不會匹配該location塊。

2.2 前綴匹配（/）

前綴匹配是Nginx中最常見的匹配方式，它會匹配URI的前綴部分。

例如：

location /images/ {

root /var/www/images;

}

• 當請求的URI以/images/開頭時（例如/images/photo.jpg），就會匹配此location塊。需要注意的是，前綴匹配是從左到右進行匹配的，且Nginx會尋找最長的前綴匹配。

2.3 正則匹配（~ and ~* and ^~）

Nginx還支持使用正則表達式來進行匹配。正則表達式匹配通常用于更復雜的場景，例如匹配動態的路徑或查詢參數。

• ~ 表示區分大小寫的正則匹配。

• ~* 表示不區分大小寫的正則匹配。

• ^~ 前綴匹配標記(~)例如

location ~ \.php$ {

fastcgi_pass unix:/var/run/php/php7.4-fpm.sock;

}

• 此規則會匹配所有以.php結尾的請求，并將其轉發給PHP-FPM處理。正則匹配會根據location塊中的正則表達式從請求的URI中提取信息。

2.4 正則匹配優先級

正則匹配的優先級較高，在同一層級下，如果正則匹配成功，Nginx會立即使用該location塊，不再繼續向下查找其他規則。

location ~* \.jpg$ {

root /var/www/images;

}

location /images/ {

root /var/www/images;

}

2.5 最長前綴匹配

當多個location規則能夠匹配同一個請求時，Nginx會選擇最長的前綴匹配規則。如果前綴匹配的長度相同，則選擇最先出現的規則。

location /images/ {

root /var/www/images;

}

location /images/photo/ {

root /var/www/photos;

}

• 對于請求/images/photo/abc.jpg，Nginx會選擇/images/photo/規則，因為它是最長的前綴匹配。

2.6 默認匹配（default）

Nginx還提供了一個默認的location規則，用于處理無法匹配任何特定規則的請求。在location塊中可以使用default來定義默認行為：

location / {

root /var/www/html;

}

location /default {

return 404;

}

• 如果沒有任何其他規則匹配的請求，會使用默認的location塊進行處理。

三、 Nginx路由匹配規則的優先級

理解Nginx路由匹配的優先級非常重要，下面是Nginx匹配規則的優先級順序：

• 精確匹配（=）：Nginx首先會檢查所有精確匹配的location規則。如果找到匹配，則直接使用該規則。

• 正則匹配（~ 和 ~）：其次，Nginx會查找所有正則匹配的location規則，并按順序應用正則表達式。Nginx會先匹配區分大小寫的正則表達式（~），然后匹配不區分大小寫的正則表達式（~）。

• 前綴匹配（/）：如果以上規則沒有匹配，Nginx會繼續查找最長的前綴匹配。最長的前綴匹配會優先被選擇。

• 默認匹配：如果沒有任何匹配的規則，Nginx會使用默認的location塊（通常是location /）處理請求。

以下展示不同匹配規則的應用：

server {

listen 80;

server_name example.com;

# 精確匹配

location = /hello {

return 200 "Hello, World!";

}

# 正則匹配

location ~* \.jpg$ {

root /var/www/images;

}

# 前綴匹配

location /images/ {

root /var/www/images;

}

# 默認匹配

location / {

root /var/www/html;

}

}

• 在這個示例中，Nginx首先檢查是否有精確匹配的/hello路徑，如果匹配，則返回"Hello, World!"。如果請求路徑以.jpg結尾，則會匹配正則表達式規則并返回圖片。如果沒有匹配到前兩個規則，則會嘗試匹配/images/路徑，最終如果沒有匹配到，則會返回默認的/路徑。

其他匹配示例

location ~ ^/(cn|tw|de|fr|es|pt|jp|it|ar)/ai/object-remover/ {

rewrite ^/(cn|tw|de|fr|es|pt|jp|it|ar)/ai/object-remover/(.*)$ /$1/application/object-remover/$2 break;

proxy_pass https://xxx.xxx.com;

proxy_set_header Host $host;

proxy_set_header X-Real-IP $remote_addr;

proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;

# Rewrite all requests to use j4.flexclip.com as the base URL

}

• 此規則會匹配所有 /cn/ai/object-remover/、/tw/ai/object-remover/、/fr/ai/object-remover/ 等的請求。

整段配置的功能是：

• URI 匹配與重寫：

• 任何匹配 /cn/ai/object-remover/、/tw/ai/object-remover/ 等路徑的請求，都將會被重寫。

• 重寫后的路徑將會變成 /語言代碼/application/object-remover/原始路徑，例如 /cn/application/object-remover/abc/xyz。

• 請求轉發：

• 重寫后的請求將通過 proxy_pass 被轉發到 https://xxx.xxx.com。

• 請求頭設置：

• 在轉發請求時，設置了原始請求的 Host、客戶端的 X-Real-IP 和 X-Forwarded-For 頭。

四、 總結

Nginx的路由匹配規則通過精確匹配、前綴匹配、正則匹配和默認匹配進行請求處理。理解這些匹配規則的優先級和使用場景，將有助于你更高效地配置Nginx并避免潛在的錯誤。通過靈活地組合這些匹配規則，你可以實現非常復雜的路由邏輯，滿足各種業務需求。

希望這篇文章能夠幫助你了解Nginx匹配規則。如果你有任何疑問或建議，歡迎在評論區留言討論！

原文來源：https://mp.weixin.qq.com/s/gWmF2I6qaxpDWIKNz6WSKA