Nginx中Location配置超详细讲解

更新时间：2023年01月09日 09:25:04 作者：蹲街式等待

最近一直在做location 配置,遇到优先级别问题（如果配置不当可能存在安全隐患哦）,下面这篇文章主要给大家介绍了关于Nginx中Location配置的相关资料,需要的朋友可以参考下

一、语法

Location 是 Nginx 中一个非常核心的配置，关于Location，举个简单的配置例子：

server {
    listen 80;
    server_name 10.0.7.115;
    location / {
        root /data/app/;
        index index.html;
    }
}

当访问 http://10.0.7.115:80 的时候，返回的是 /data/app/index.html 文件。

Location具体语法：

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

重点看方括号中的 [ = | ~ | ~* | ^~ ]，其中 | 分隔的内容表示你可能会用到的语法，其中：

= 表示精确匹配：

location = /test {
    return 200 "hello";
}

例如：

/test              ok
/test/             not ok
/test2             not ok
/test/2            not ok

~ 表示区分大小写的正则匹配：

location ~ ^/test$ {
    [configuration] 
}

例如：

/test              ok
/Test              not ok
/test/             not ok
/test2             not ok

~* 表示不区分大小写的正则匹配：

location ~* ^/test$ {     
    [configuration] 
}

例如：

/test               ok
/Test               ok
/test/              not ok
/test2              not ok

^~ 表示 uri 以某个字符串开头：

location ^~ /images/ {    
    [configuration] 
}

例如：

/images/1.gif        ok

/ 表示通用匹配：

location / {     
    [configuration] 
}

例如：

/index.html           ok

location /test {
    [configuration] 
}

例如：

/test                 ok
/test2                ok
/test/                ok

二、匹配顺序

Location的定义分为两种：

前缀字符串（prefix string）
正则表达式（regular expression），具体为前面带 ~* 和 ~ 修饰符的

当存在多个 Location 的时候，匹配的顺序为：

检查使用前缀字符串的 locations，在使用前缀字符串的 locations 中选择最长匹配的，并将结果进行储存；

如果符合带有 = 修饰符的URI，则立刻停止匹配；
如果符合带有 ^~ 修饰符的URI，则也立刻停止匹配；
然后按照定义文件的顺序，检查正则表达式，匹配到就停止；
当正则表达式匹配不到的时候，使用之前储存的前缀字符串；

总结：

在顺序上：

前缀字符串顺序不重要，按照匹配长度来确定；
正则表达式则按照定义顺序；

在优先级上：

= 修饰符最高，^~ 次之，再者是正则，最后是前缀字符串匹配。

我们举几个简单的例子进行说明

请求URI如下：

/document

示例一：

配置：

server {
    location /doc {
        [ configuration A ] 
    }
    location /docu {
        [ configuration B ] 
    }
}

匹配结果：

configuration B

注：虽然 /doc 也能匹配到，但在顺序上，前缀字符串顺序不重要，按照匹配长度来确定。

示例二：

server {
    location ~ ^/doc {
        [ configuration A ] 
    }
    location ~ ^/docu {
        [ configuration B ] 
    }
}

匹配结果：

configuration A

注：虽然 ~ ^/docu 也能匹配到，但正则表达式则按照定义顺序。

示例三：

server {
    location ^~ /doc {
        [ configuration A ] 
    }
    location ~ ^/docu {
        [ configuration B ] 
    }
}

匹配结果：

configuration A

注：虽然 ~ ^/docu 也能匹配到，但 ^~ 的 优先级更高。

示例四：

server {
    location /document {
        [ configuration A ] 
    }
    location ~ ^/docu {
        [ configuration B ] 
    }
}

匹配结果：

configuration B

注：虽然 /document 也能匹配到，但正则的优先级更高。

三、root 与 alias 的区别

当我们这样设置 root 的时候：

location /i/ {
    root /data/w3;
}

当请求 /i/top.gif，/data/w3/i/top.gif 会被返回。

当我们这样设置 alias 的时候：

location /i/ {
    alias /data/w3/images/;
}

当请求 /i/top.gif，/data/w3/images/top.gif 会被返回。

两者的区别：

root 是直接拼接 root + location；
alias 是用 alias 替换 location；

四、server 和 location 中的 root

server 和 location 中都可以使用 root，举个例子：

server {
    listen 80;
    server_name 10.0.7.115;
        root /data/app/;
        location / {
          root /data/web/;
          index index.html;
    }
}

如果两者都出现，是怎样的优先级呢？

简单的来说，就是 就近原则，如果 location 中能匹配到，就是用 location 中的 root 配置，忽略 server 中的 root，当 location 中匹配不到的时候，则使用 server 中的 root 配置。

总结

到此这篇关于Nginx中Location配置的文章就介绍到这了,更多相关Nginx Location配置内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

您可能感兴趣的文章:

Nginx 服务器重启关闭重新加载命令
这篇文章主要介绍了Nginx 服务器重启关闭重新加载命令,非常不错，具有参考借鉴价值，需要的朋友可以参考下
2017-03-03
nginx部署后css、js、图片等样式不加载问题的两种解决方案
这篇文章主要介绍了nginx部署后css、js、图片等样式不加载问题的两种解决方案,本文给大家介绍的非常详细,具有一定的参考借鉴价值,需要的朋友可以参考下
2023-12-12
nginx请求时找路径问题解决
当你安装了nginx的时候,为nginx配置了如下的location,想要去访问路径下面的内容,可是总是出现404,找不到文件,这是什么原因呢,今天我们就来解决这个问题,感兴趣的朋友一起看看吧
2023-10-10
Nginx下配置Https证书详细过程
这篇文章主要介绍了Nginx下配置Https证书详细过程，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧
2020-09-09
Nginx中反向代理+负载均衡+服务器宕机解决办法详解
这篇文章主要介绍了Nginx中反向代理+负载均衡+服务器宕机解决办法详解,反向代理保证系统安全,不暴露服务器IP,利用nginx服务器,利用内网ip进行访问,避免出现攻击服务器的情况,需要的朋友可以参考下
2024-01-01
手把手教你利用Nginx搭建属于自己的服务器
最近总是想搭建自己的网站，奈何皮夹里空空如也，服务器也租不起，更别说域名了，于是我就寻思能否自己搭建个服务器，还不要钱呢，本文就来手把手教你如何实现吧
2023-08-08
nginx ingress限速那些事浅析
这篇文章主要为大家介绍了nginx ingress限速的一些知识的浅析，有需要的朋友可以借鉴参考下，希望能够有所帮助，祝大家多多进步，早日升职加薪
2023-04-04
Nginx配置虚拟主机的三种方法
本文主要介绍了Nginx配置虚拟主机的三种方法，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧
2023-06-06
nginx 解决首页跳转问题详解
这篇文章主要介绍了nginx 解决首页跳转问题详解的相关资料,需要的朋友可以参考下
2016-12-12
Nginx配置优化详解
如果你已经安装过Nginx并在生产环境中使用，那么Nginx配置优化你一定也要做，这样才能看到Nginx性能，本文就从基本配置优化开始到高层配置教你如何优化Nginx
2013-11-11