快捷導(dǎo)航

Nginx中l(wèi)ocation實現(xiàn)多條件匹配的方法詳解

更新時間：2025年03月05日 15:20:51 作者：huanlis

在 Nginx 中,location 指令用于匹配請求的 URI,雖然 location 本身是基于單一匹配規(guī)則的,但可以通過多種方式實現(xiàn)多個條件的匹配邏輯,下面小編就來為大家介紹一下具體實現(xiàn)方法吧

1. 概述

在 Nginx 中，location 指令用于匹配請求的 URI，并根據(jù)匹配結(jié)果執(zhí)行相應(yīng)的邏輯。雖然 location 本身是基于單一匹配規(guī)則的，但可以通過多種方式實現(xiàn)多個條件的匹配邏輯。

2. 實現(xiàn)多條件匹配的方式

2.1 使用多個 location 塊

Nginx 支持定義多個 location 塊，每個 location 塊可以匹配不同的條件。Nginx 會根據(jù)優(yōu)先級選擇最匹配的 location。

示例：

server {
    listen 80;

    # 匹配 /xianyang/ 路徑
    location /xianyang/ {
        proxy_pass http://10.175.12.236:8080;
        add_header 'Access-Control-Allow-Origin' '*';
    }

    # 匹配 /api/ 路徑
    location /api/ {
        proxy_pass http://10.175.12.237:8080;
        add_header 'Access-Control-Allow-Origin' '*';
    }

    # 默認(rèn)匹配
    location / {
        root html;
        index index.html;
    }
}

server {
    listen 80;

    # 匹配 /xianyang/ 路徑
    location /xianyang/ {
        proxy_pass http://10.175.12.236:8080;
        add_header 'Access-Control-Allow-Origin' '*';
    }

    # 匹配 /api/ 路徑
    location /api/ {
        proxy_pass http://10.175.12.237:8080;
        add_header 'Access-Control-Allow-Origin' '*';
    }

    # 默認(rèn)匹配
    location / {
        root html;
        index index.html;
    }
}

優(yōu)先級規(guī)則：

精確匹配（location = /path）優(yōu)先級最高。
正則表達(dá)式匹配（location ~ /path）次之。
前綴匹配（location /path）優(yōu)先級最低。

2.2 使用正則表達(dá)式匹配多個條件

如果需要在一個 location 塊中匹配多個路徑，可以使用正則表達(dá)式。

示例：

server {
    listen 80;

    # 匹配 /xianyang/ 或 /api/ 路徑
    location ~ ^/(xianyang|api)/ {
        proxy_pass http://10.175.12.236:8080;
        add_header 'Access-Control-Allow-Origin' '*';
    }

    # 默認(rèn)匹配
    location / {
        root html;
        index index.html;
    }
}

說明：

~ 表示啟用正則表達(dá)式匹配。
^/(xianyang|api)/ 表示匹配以 /xianyang/ 或 /api/ 開頭的路徑。

2.3 使用 map 指令動態(tài)選擇后端

如果需要根據(jù)路徑或其他條件動態(tài)選擇后端服務(wù)器，可以使用 map 指令。

示例：

http {
    # 定義 $backend 變量，根據(jù)路徑動態(tài)選擇后端
    map $uri $backend {
        default http://default-backend:8080;

        "~^/xianyang/" http://10.175.12.236:8080;
        "~^/api/" http://10.175.12.237:8080;
    }

    server {
        listen 80;

        location / {
            proxy_pass $backend;  # 使用動態(tài)選擇的 $backend
            proxy_set_header Host $host;
            proxy_set_header X-Real-IP $remote_addr;
        }
    }
}

說明：

map $uri $backend：
- 根據(jù) $uri 的值動態(tài)設(shè)置 $backend。
- ~^/xianyang/ 匹配以 /xianyang/ 開頭的路徑。
- ~^/api/ 匹配以 /api/ 開頭的路徑。

2.4 使用 if 條件實現(xiàn)多個條件

雖然不推薦過度使用 if，但在某些場景下可以通過 if 實現(xiàn)多個條件的匹配。

示例：

server {
    listen 80;

    location / {
        # 根據(jù)路徑動態(tài)選擇后端
        if ($uri ~* "^/xianyang/") {
            proxy_pass http://10.175.12.236:8080;
        }

        if ($uri ~* "^/api/") {
            proxy_pass http://10.175.12.237:8080;
        }

        # 默認(rèn)后端
        if ($uri !~* "^/xianyang/" && $uri !~* "^/api/") {
            root html;
            index index.html;
        }
    }
}

注意事項：

if 的性能較低，盡量避免在 location 中過度使用。
if 條件中不能直接使用 proxy_pass 和其他指令的組合，需要小心使用。

2.5 使用 try_files 實現(xiàn)多條件匹配

如果需要根據(jù)文件或路徑的存在性來選擇不同的處理邏輯，可以使用 try_files。

示例：

server {
    listen 80;

    location / {
        # 嘗試匹配文件，如果不存在則轉(zhuǎn)發(fā)到后端
        try_files $uri @backend;
    }

    location @backend {
        # 根據(jù)路徑選擇后端
        if ($uri ~* "^/xianyang/") {
            proxy_pass http://10.175.12.236:8080;
        }

        if ($uri ~* "^/api/") {
            proxy_pass http://10.175.12.237:8080;
        }

        # 默認(rèn)后端
        proxy_pass http://default-backend:8080;
    }
}

說明：

try_files $uri @backend：
- 嘗試匹配文件路徑 $uri。
- 如果文件不存在，則跳轉(zhuǎn)到 @backend 命名位置。

2.6 使用 include 分離多個 location 配置

如果需要管理多個 location 塊，可以將它們分離到單獨的文件中，并通過 include 指令引入。

示例：

主配置文件：

server {
    listen 80;

    include /etc/nginx/conf.d/*.conf;  # 引入所有 .conf 文件
}

/etc/nginx/conf.d/xianyang.conf：

location /xianyang/ {
    proxy_pass http://10.175.12.236:8080;
    add_header 'Access-Control-Allow-Origin' '*';
}

/etc/nginx/conf.d/api.conf：

location /api/ {
    proxy_pass http://10.175.12.237:8080;
    add_header 'Access-Control-Allow-Origin' '*';
}

說明：

使用 include 可以將配置文件模塊化，便于管理和維護(hù)。

2.7 綜合示例：多條件匹配

以下是一個綜合示例，結(jié)合了前綴匹配、正則表達(dá)式和默認(rèn)后端：

server {
    listen 80;

    # 精確匹配 /xianyang/
    location = /xianyang/ {
        proxy_pass http://10.175.12.236:8080;
        add_header 'Access-Control-Allow-Origin' '*';
    }

    # 匹配 /xianyang/ 或 /api/ 路徑（正則表達(dá)式）
    location ~ ^/(xianyang|api)/ {
        proxy_pass http://10.175.12.236:8080;
        add_header 'Access-Control-Allow-Origin' '*';
    }

    # 默認(rèn)匹配
    location / {
        root html;
        index index.html;
    }
}