首页教程软件教程正文

实现Nginx中location的多条件匹配的多种方法

uncle 软件教程 2025年08月6日

0 收藏 0 点赞 786 浏览 3706 个字

摘要 :

文章目录一、Nginx中location指令的基础认知二、实现location多条件匹配的多种方式（一）利用多个location块（二）运用正则表达式匹配多个条件（三）借助map指令……

文
章
目
录

一、Nginx中location指令的基础认知
二、实现location多条件匹配的多种方式

（一）利用多个location块
（二）运用正则表达式匹配多个条件
（三）借助map指令动态选择后端
（四）使用if条件实现多条件匹配
（五）通过try_files实现多条件匹配
（六）利用include分离多个location配置
（七）综合示例：多条件匹配

三、总结

在Nginx服务器配置里，location的多条件匹配是个非常实用但又有点复杂的知识点，本文会详细介绍在Nginx中实现location多条件匹配的多种方法。

一、Nginx中location指令的基础认知

在Nginx服务器里，location指令的作用是对请求的网址（URI）进行匹配，然后根据匹配的结果来执行相应的操作，比如把请求转发到不同的后端服务器，或者返回特定的页面内容等。不过，location原本是按照单一的匹配规则来工作的，那怎么实现多个条件的匹配呢？下面就来详细讲讲。

二、实现location多条件匹配的多种方式

（一）利用多个location块

Nginx允许我们定义多个location块，每个location块都可以设置不同的匹配条件。当有请求进来时，Nginx会按照优先级来选择最合适的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\' \'*\';
    }

    # 默认匹配
    location / {
        root html;
        index index.html;
    }
}

这里要注意Nginx的匹配优先级规则：

精确匹配（location = /path）的优先级是最高的。比如location = /specific-url，只有请求的网址完全是/specific-url时才会匹配。
正则表达式匹配（location ~ /path）次之。这种匹配方式更灵活，可以匹配符合特定模式的网址。
前缀匹配（location /path）优先级最低。只要请求网址的开头和配置的路径一致，就会匹配。

（二）运用正则表达式匹配多个条件

要是想在一个location块里匹配多个不同的路径，就可以借助正则表达式。

server {
    listen 80;

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

    # 默认匹配
    location / {
        root html;
        index index.html;
    }
}

这里的~表示开启正则表达式匹配模式，^/(xianyang|api)/的意思是匹配以/xianyang/或者/api/开头的网址路径。

（三）借助map指令动态选择后端

如果需要根据请求的路径或者其他条件来动态地选择后端服务器，map指令就能派上用场啦。

http {
    # 定义 $backend 变量，根据路径动态选择后端
    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;  # 使用动态选择的 $backend
            proxy_set_header Host $host;
            proxy_set_header X-Real-IP $remote_addr;
        }
    }
}

在这段代码里，map $uri $backend表示根据$uri（也就是请求的路径）的值来动态设置$backend变量。当路径以/xianyang/开头时，$backend就被设置为http://10.175.12.236:8080；以/api/开头时，$backend被设置为http://10.175.12.237:8080；其他情况就使用默认的http://default-backend:8080。

（四）使用if条件实现多条件匹配

虽然不太建议过度使用if，但在某些情况下，它也能实现多个条件的匹配。

server {
    listen 80;

    location / {
        # 根据路径动态选择后端
        if ($uri ~* \"^/xianyang/\") {
            proxy_pass http://10.175.12.236:8080;
        }

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

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

不过要注意，if的性能不太好，所以尽量别在location里大量使用。而且if条件里不能直接把proxy_pass和其他指令组合使用，得小心操作。

（五）通过try_files实现多条件匹配

要是想根据文件或路径是否存在来选择不同的处理逻辑，try_files就能帮到你。

server {
    listen 80;

    location / {
        # 尝试匹配文件，如果不存在则转发到后端
        try_files $uri @backend;
    }

    location @backend {
        # 根据路径选择后端
        if ($uri ~* \"^/xianyang/\") {
            proxy_pass http://10.175.12.236:8080;
        }

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

        # 默认后端
        proxy_pass http://default-backend:8080;
    }
}

try_files $uri @backend的作用是先尝试去匹配文件路径$uri，要是文件不存在，就会跳转到@backend这个命名位置继续处理。

（六）利用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\' \'*\';
}

这样做可以让配置文件更模块化，方便管理和维护。

（七）综合示例：多条件匹配

下面是一个综合示例，结合了前缀匹配、正则表达式和默认后端的配置。

server {
    listen 80;

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

    # 匹配 /xianyang/ 或 /api/ 路径（正则表达式）
    location ~ ^/(xianyang|api)/ {
        proxy_pass http://10.175.12.236:8080;
        add_header \'Access-Control-Allow-Origin\' \'*\';
    }

    # 默认匹配
    location / {
        root html;
        index index.html;
    }
}