Nginx的location指令是配置請(qǐng)求路由的核心機(jī)制，其匹配規(guī)則直接影響請(qǐng)求的處理流程。下面基于官方文檔和實(shí)戰(zhàn)經(jīng)驗(yàn)的總結(jié)：

一、Location匹配規(guī)則與優(yōu)先級(jí)

1. 匹配模式

Nginx支持5種location修飾符，優(yōu)先級(jí)從高到低為：

2. 優(yōu)先級(jí)順序

Nginx按以下順序匹配location塊：

精確匹配（=）
僅當(dāng)請(qǐng)求URI與location后的字符串完全匹配時(shí)生效。正則匹配（~/~*）
按配置文件中的書(shū)寫(xiě)順序依次匹配，首個(gè)匹配的正則生效。最長(zhǎng)前綴匹配（^~）
選擇匹配URI前綴最長(zhǎng)的location塊。普通前綴匹配
按最長(zhǎng)匹配原則選擇，若多個(gè)location匹配，選擇最先定義的。默認(rèn)匹配（location /）
兜底處理未匹配其他規(guī)則的請(qǐng)求。

3. 匹配示例

假設(shè)配置如下：

location = /exact { ... }          # 精確匹配
location ^~ /prefix { ... }        # 最長(zhǎng)前綴匹配
location ~ \.png$ { ... }          # 正則匹配（區(qū)分大小寫(xiě)）
location /general { ... }          # 普通前綴匹配
location / { ... }                 # 默認(rèn)匹配

• 請(qǐng)求/exact → 匹配location = /exact。
• 請(qǐng)求/prefix/long → 匹配location ^~ /prefix（^~優(yōu)先級(jí)高于普通前綴）。
• 請(qǐng)求/image.PNG → 匹配location ~* \.(jpg|png)$（不區(qū)分大小寫(xiě)的正則）。
• 請(qǐng)求/general/path → 匹配location /general。

二、Proxy_pass路徑處理規(guī)則

proxy_pass指令用于將請(qǐng)求轉(zhuǎn)發(fā)到后端服務(wù)，其路徑拼接邏輯與location配置緊密相關(guān)。

1. 路徑拼接規(guī)則

關(guān)鍵規(guī)則：

• 帶/：proxy_pass的URL以/結(jié)尾時(shí)，替換location匹配的部分。
• 不帶/：proxy_pass的URL不帶/時(shí)，追加location匹配后的完整路徑。

2. 路徑截取與重寫(xiě)

通過(guò)rewrite指令可動(dòng)態(tài)修改轉(zhuǎn)發(fā)路徑：

location ~* ^/api/v1/ {
    rewrite ^/api/v1/(.*) /$1 break;  # 截取/api/v1/后的路徑
    proxy_pass http://backend;
}

請(qǐng)求/api/v1/user/123 → 轉(zhuǎn)發(fā)到http://backend/user/123。

3. 特殊場(chǎng)景處理

Unix Socket轉(zhuǎn)發(fā)：

location /unix/ {
    proxy_pass http://unix:/var/run/backend.sock:/;
}

避免301重定向：

location /app {
    proxy_pass http://backend;
}
# 請(qǐng)求/app（無(wú)結(jié)尾/）時(shí)，Nginx可能自動(dòng)重定向到/app/
# 使用精確匹配避免：
location = /app {
    proxy_pass http://backend;
}

三、配置優(yōu)化與最佳實(shí)踐

精確匹配優(yōu)先
將location =塊置于配置文件頂部，減少正則匹配開(kāi)銷(xiāo)。

正則匹配順序
將高頻請(qǐng)求的正則規(guī)則前置，提升匹配效率。

路徑設(shè)計(jì)一致性
確保location和proxy_pass的URL格式（是否帶/）一致，避免路徑拼接錯(cuò)誤。

監(jiān)控
使用error_log和access_log跟蹤匹配過(guò)程，優(yōu)化配置。

四、完整配置示例

server {
    listen 80;
    server_name example.com;
    # 精確匹配靜態(tài)文件
    location = /favicon.ico {
        log_not_found off;
        access_log off;
        root /var/www/icons;
    }
    # 最長(zhǎng)前綴匹配API請(qǐng)求
    location ^~ /api/ {
        proxy_pass http://api_server;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
    # 正則匹配圖片資源（不區(qū)分大小寫(xiě)）
    location ~* \.(jpg|png|gif)$ {
        expires 30d;
        root /var/www/images;
    }
    # 默認(rèn)匹配
    location / {
        root /var/www/html;
        index index.html;
    }
}

配置說(shuō)明：

• 精確匹配favicon.ico，關(guān)閉日志提升性能。
• ^~ /api/匹配所有以/api/開(kāi)頭的請(qǐng)求，轉(zhuǎn)發(fā)到后端服務(wù)。
• 正則匹配圖片文件，設(shè)置30天緩存。
• 未匹配的請(qǐng)求由location /處理，返回靜態(tài)文件。

到此這篇關(guān)于Nginx Location映射規(guī)則總結(jié)歸納的文章就介紹到這了,更多相關(guān)Nginx Location映射規(guī)則內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

最新評(píng)論