1. 首页
  2. 文章中心
  3. Web服务器 & 运维

Nginx配置location语法规则

75 阅读 0 评论
我是靠谱客的博主 淡然仙人掌，最近开发中收集的这篇文章主要介绍Nginx配置location语法规则，觉得挺不错的，现在分享给大家，希望可以做个参考。

概述

语法规则

基本语法：

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

修饰符释义：

修饰符释义
=表示精确匹配后面的url
~表示正则匹配，但是区分大小写
~*表示正则匹配，不区分大小写
^~表示普通字符匹配，如果该选项匹配，只匹配该选项，不匹配别的选项，一般用来匹配目录
@“@” 定义一个命名的 location，使用在内部定向时，例如 error_page
/通用匹配，任何请求都会匹配到

上述匹配规则的优先匹配顺序：

  • = 前缀的指令严格匹配这个查询。如果找到，停止搜索；
  • 所有剩下的常规字符串，最长的匹配。如果这个匹配使用 ^~ 前缀，搜索停止；
  • 正则表达式，在配置文件中定义的顺序；
  • 如果第 3 条规则~*产生匹配的话，结果被使用。否则，使用第 2 条规则~的结果。

匹配案例

通过精确匹配

配置文件内容：

server {
    listen  80;
    ...

    location /test.html {
        root /www/wwwroot/nginx/html;
    }

    location = /test.html {
        root /www/wwwroot/nginx/test.html;
    }

    ...
}

两个location匹配条件一样，都是/test.html，但是第二个为精确匹配到静态文件路径，因此第一个不会执行，会执行第二个。

指定静态资源路径用的关键字root，还可以用alias，那么root和alias的区别是什么？

  • 用root属性指定的值是要加入到最终路径中的，匹配条件会拼接到路径中
  • 用alias属性指定的值不需要加入到最终路径中

根据上述配置文件内容，请求的条件为test.html，通过root指定的路径为/www/wwwroot/nginx/html，因此在匹配的时候，这个路径下就必须要有test.html这个文件才可以，否则就会找不到而报错，如果用alias，那么通过浏览器进行请求的时候，alias也是指定到/www/wwwroot/nginx/html路径下，但是会匹配默认的index.html，而无须强制匹配test.html，但是此时就不能使用=来进行精确匹配，现在将root改为alias

server {
    listen  80;
    ...

    location /test.html {
        alias /www/wwwroot/nginx/html/;
    }

    ...
}

注意：alias指定的路径结尾要加/

来个root和alias的区别例子

server {
    listen  80;
    ...

    location /html/ {
        root /www/wwwroot/nginx;
    }

    ...
}

访问 域名/html 的时候，将跳转到/www/wwwroot/nginx/html/目录下的index.html文件

server {
    listen  80;
    ...

    location /html_alias/ {
        alias /www/wwwroot/nginx/html/;
    }

    ...
}

访问 域名/html_alias 的时候，将跳转到/www/wwwroot/nginx/html/目录下的index.html文件

通过^~方式实现匹配

server {
    listen  80;
    ...

    location ^~ /a/ {
        return 111;
    }

    location ^~ /a/b/ {
        return 222;
    }

    ...
}
  • 如果访问 域名/a 返回 111
  • 如果访问 域名/a/b 返回 222
  • 如果访问 域名/a/b/sdf 返回 222

从结果看，两条规则同时被匹配成功，但是第二条规则比较长，因此第二条规则优先被匹配，如果^~匹配成功了，那么表示阻断正则表达式，不再进行正则匹配。

通过~方式实现匹配

在匹配最长规则的时候，除了通过^~来实现匹配，还有通过普通匹配来实现。

当最长规则是通过普通匹配的时候，将会继续正则匹配， 只要有一个正则成功，则使用这个正则的location，停止继续匹配，返回结果。

server {
    listen  80;
    ...

    location ^~ /a/ {
        return 111;
    }

    location /a/b/ {
        return 222;
    }

    location ~ /a/b/ {#区分大小写的正则匹配
        return 333;
    }
    ...
}
  • 如果访问 域名/a 返回 111
  • 如果访问 域名/a/b 返回 333
  • 如果访问 域名/a/b/sdf 返回 333

从结果看，可以看出请求/a/b/的时候，首先会到达第二条规则(最长规则)，由于第二条规则为普通匹配(不是^~匹配)，因此会继续去匹配正则，也就是第三条规则，因此最终返回333。

通过~*方式实现匹配

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

server {
    listen  80;
    ...

    location ^~ /a/ {
        return 111;
    }

    location /a/b/ {
        return 222;
    }

    location ~* /a/b/ {#不区分大小写的正则匹配
        return 333;
    }
    ...
}
  • 如果访问 域名/a/b/sdf 返回 333
  • 如果访问 域名/A/B/sdf 返回 333

从结果看，无论匹配的是大写还是小写，都会返回333

常用方法还有匹配图片后缀，并返回指定信息，如：

server {
    listen  80;
    ...

    location ~* .(gif|jpg|png) {#不区分大小写，并以gif|jpg|png后缀结尾
        return 444;
    }
    ...
}
  • 如果访问 域名/a.jpg 返回 444
  • 如果访问 域名/A.JPG 返回 444

通过/ 实现通用匹配

  1. proxy_pass（代理转发）最后面没有斜杠,匹配路径有斜杠(/aaa/)
server {
    listen  80;
    ...

    location /aaa/ {
        proxy_pass  http://127.0.0.1:8081;
        proxy_rediect off;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For  $proxy_add_x_forwarded_for;
    }
    ...
}

proxy_pass最后面没有斜杠/，此时通过浏览器请求http://域名/aaa/，那么实际访问的地址就是 http://127.0.0.1:8081/aaa/，会将匹配路径/aaa一起加过去。

  1. proxy_pass最后面有斜杠/，匹配路径也有斜杠(/aaa/)
server {
    listen  80;
    ...

    location /aaa/ {
        proxy_pass  http://127.0.0.1:8081/;
        proxy_rediect off;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For  $proxy_add_x_forwarded_for;
    }
    ...
}

proxy_pass最后面有斜杠/，此时通过浏览器请求http://域名/aaa/，那么实际访问的地址就是 http://127.0.0.1:8081，会将/aaa抛弃的。

  1. proxy_pass后面还有其他路径但是最后没有 /， 匹配路径也有斜杠(/aaa/)
server {
    listen  80;
    ...

    location /aaa/ {
        proxy_pass  http://127.0.0.1:8081/bbb;
        proxy_rediect off;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For  $proxy_add_x_forwarded_for;
    }
    ...
}

此时通过浏览器访问http://域名/aaa/index.html，实际请求的是http://127.0.0.1:8081/bbbindex.html(注意位置是默认路径下，不是bbb路径下，如果proxy_pass的路径为/bbb/ccc，那么实际请求的就是bbb路径下的cccindex.html)

  1. proxy_pass后面还有其他路径但是最后有 /， 匹配路径也有斜杠(/aaa/)
server {
    listen  80;
    ...

    location /aaa/ {
        proxy_pass  http://127.0.0.1:8081/bbb/;
        proxy_rediect off;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For  $proxy_add_x_forwarded_for;
    }
    ...
}

此时通过浏览器访问：http://域名/aaa/index.html，实际访问的是http://127.0.0.1:8081/bbb/index.html

  1. location匹配路径末尾没有 /，proxy_pass后面也没有/
server {
    listen  80;
    ...

    location /aaa {
        proxy_pass  http://127.0.0.1:8081;
        proxy_rediect off;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For  $proxy_add_x_forwarded_for;
    }
    ...
}

此时访问http://域名/aaa，默认将请求到http://127.0.0.1:8081/aaa/index.html的内容

最后

以上就是淡然仙人掌为你收集整理的Nginx配置location语法规则的全部内容，希望文章能够帮你解决Nginx配置location语法规则所遇到的程序开发问题。

如果觉得靠谱客网站的内容还不错，欢迎将靠谱客网站推荐给程序员好友。

本图文内容来源于网友提供，作为学习参考使用，或来自网络收集整理，版权属于原作者所有。
点赞(50)

相关文章

Nginx如何将带后缀的url进行匹配
Nginx如何将带后缀的url进行匹配
注意：TP5 获取header自动转小写问题
注意：TP5 获取header自动转小写问题
转载：nginx 的location配置规则1 先普通 location ，再正则 location403 ForbiddenWelcome to nginx!404 Not Found403 Forbidden2 普通 location 的“隐式”严格匹配404 Not Found3 普通 location 的“显式”严格匹配和“ ^~ ” 前缀4 正则 location 与编辑顺序5 “@” 前缀 Named Location 使用FoundFound
转载：nginx 的location配置规则1 先普通 location ，再正则 location403 ForbiddenWelcome to nginx!404 Not Found403 Forbidden2 普通 location 的“隐式”严格匹配404 Not Found3 普通 location 的“显式”严格匹配和“ ^~ ” 前缀4 正则 location 与编辑顺序5 “@” 前缀 Named Location 使用FoundFound
nginx之URI重写与if的使用1.URI重写2.if
nginx之URI重写与if的使用1.URI重写2.if
Nginx配置location语法规则
Nginx配置location语法规则
Nginx的location规则
Nginx的location规则
nginx location配置规则
nginx location配置规则
nginx配置中location的匹配规则
nginx配置中location的匹配规则

评论列表共有 0 条评论

立即
投稿
返回
顶部