1. 首页

Nginx之location配置总结

nginx.jpeg

前言

Location指令是nginx中最关键的指令之一,location指令的功能是用来匹配不同的url请求,进而对请求做不同的处理和响应,这其中较难理解的是多个location的匹配顺序,本文会作为重点来解释和说明。

开始之前先明确一些约定,我们输入的网址叫做请求uri,nginx用请求uri与location中配置的uri做匹配。

nginx文件结构

首先我们先简单了解nginx的文件结构,nginx的HTTP配置主要包括三个区块,结构如下:


Global: nginx 运行相关 Events: 与用户的网络连接相关 http http Global: 代理,缓存,日志,以及第三方模块的配置 server server Global: 虚拟主机相关 location: 地址定向,数据缓存,应答控制,以及第三方模块的配置

从上面展示的nginx结构中可以看出location属于请求级别配置,这也是我们最常用的配置。

⚠️ 所有的所有的所有的指令,都要以 ; 结尾

配置 location 块

location 语法

Location 块通过指定模式来与客户端请求的URI相匹配。
Location基本语法:

  • 匹配uri类型,有四种参数可选,当然也可以不带参数。
  • 命名location,用@来标识,类似于定义goto语句块。

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

location匹配命令解释

参数 解释
location后没有参数直接跟着URI,表示前缀匹配,代表跟请求中的URI从头开始匹配。
= 用于标准 uri 前,要求请求字符串与其严格匹配,成功则立即处理,nginx停止搜索其他匹配。
^~ 用于标准 uri 前,并要求一旦匹配到就会立即处理,不再去匹配其他的那些个正则 uri,一般用来匹配目录
~ 用于正则 uri 前,表示 uri 包含正则表达式, 区分大小写
~* # 用于正则 uri 前, 表示 uri 包含正则表达式, 不区分大小写
@ ”@“ 定义一个命名的 location,@定义的locaiton名字一般用在内部定向,例如error_page, try_files命令中。它的功能类似于编程中的goto。

location匹配顺序

Nginx有两层指令来匹配请求URI。第一个层次是server指令,它通过域名、ip和端口来做第一层级匹配,当找到匹配的server后就进入此server的location匹配。location的匹配并不完全按照它们在配置文件中出现的顺序来匹配,请求URI会按如下规则跟server里配置的location匹配。

  1. 寻找有没有“=”等号参数完全匹配的location,如果有完全匹配的等号location则停止匹配,执行该location中的指令,不去匹配其它类型的location。
  2. 匹配所有非正则表达式URI的location(包括空,=,^~ 三种参数)。找到请求URI和location URI按前缀匹配最长的location,如果这个最长的location的参数是 ^~,则停止匹配,执行该location中的指令,否则暂存该location。
  3. 匹配正则表达式URI的location(包括~,~*两种参数),按location在配置文件中出现的顺序匹配,如果找到第一个匹配的locaiton则停止匹配,执行该location。
  4. 匹配完所有正则表达式都没有匹配的location,则执行第二步中暂存的最长前缀匹配location。

简单来说按这个规则 location 匹配命令的优先级从高到低依次为(序号越小优先级越高):


1. location = /a {…} #精准匹配 2. location ^~ /a {…} #前缀匹配 3. location ~ /a.* {…} #正则匹配(区分大小写) 4. location ~* /a.* {…} #正则匹配(不区分大小写) 5. location /a {…} #最长前缀匹配,但是优先级低于正则匹配。 /a 和 ^~ /a 会冲突,报错 6. location / {} #任何没有匹配成功的,都会匹配这里处理

让我们用一个例子来说明上面的内容:


# 请求: # / # /index.html # /documents/document.html # /images/1.gif # /documents/1.jpg location = / { # 只匹配 / 的查询. [ configuration A ] } # 能匹配成功: / location / { # 匹配任何请求,因为所有请求都是以”/"开始 # 但是更长字符匹配或者正则表达式匹配会优先匹配 [ configuration B ] } #能匹配成功:/index.html location /documents/ { # 匹配任何以 /documents/ 开头的地址,匹配符合以后,还要继续往下搜索/ # 只有后面的正则表达式没有匹配到时,这一条才会采用这一条/ [ configuration C ] } # 能匹配成功:/documents/document.html location ~ /documents/ABC { # 匹配任何以 /documents/ 开头的地址,匹配符合以后,还要继续往下搜索/ # 只有后面的正则表达式没有匹配到时,这一条才会采用这一条/ [ configuration CC ] } location ^~ /images/ { # 匹配任何以 /images/ 开头的地址,匹配符合以后,停止往下搜索正则,采用这一条。/ [ configuration D ] } # 能成功匹配:/images/1.gif location ~* \.(gif|jpg|jpeg)$ { # 匹配所有以 .gif、.jpg 或 .jpeg 结尾的请求,不区分大小写 # 然而,所有请求 /images/ 下的图片会被 [ config D ] 处理,因为 ^~ 到达不了这一条正则/ [ configuration E ] } # 能成功匹配:/documents/1.jpg location /images/ { # 字符匹配到 /images/,继续往下,会发现 ^~ 存在/ [ configuration F ] } location /images/abc { # 最长字符匹配到 /images/abc,继续往下,会发现 ^~ 存在/ # F与G的放置顺序是没有关系的/ [ configuration G ] } location ~ /images/abc/ { # 只有去掉 [ config D ] 才有效:先最长匹配 [ config G ] 开头的地址,继续往下搜索,匹配到这一条正则,采用/ [ configuration H ] } location ~* /js/.*/\.js //Js中文网 Flutter 中文教程 https://www.javascriptc.com/

匹配问号后的参数

请求URI中问号后面的参数是不能在location中匹配到的,这些参数存储在$query_string变量中,可以用if来判断。
例如,对于参数中带有单引号’进行匹配然后重定向到错误页面。


/plus/list.php?tid=19&mid=1124’ if ( $query_string ~* “.*[;’<>].*” ){ return 404; }

location URI结尾带不带/

这个很多解释不太准确,我有必要多说几句。
对于请求URI结尾是否带有/,一般的处理逻辑是带/表示访问目录,不带/表示访问文件,如果文件不存在也会去匹配目录。例如访问http://www.nginx.cn/images/和…://www.nginx.cn/images,前面的请求会匹配目录,后面的请求会先匹配文件,文件不存再匹配目录
对于locatioin中的URI来说,如果URI的结尾带有/,并且location要执行的命令式是proxy_pass、fastcgi_pass、uwsgi_pass、scgi_pass、memcached_pass、grpc_pass之一。例如:


location /images/ { proxy_pass http://www.redis.com.cn }

对于这种情况,nginx会做特殊处理,不管images命名的文件或目录存在不在,如果你访问http://www.nginx.cn/images会…://www.nginx.cn/images/。
所以如果你想这两种请求对应不同的处理,就要明确增加不带/结尾的location配置。


location /images { proxy_pass http://www.rabbitmq.cn } location /images/ { proxy_pass http://www.redis.com.cn }

Js中文网 – 前端进阶资源教程 www.javascriptC.com,Flutter 中文教程
专注分享前端/Flutter知识,你想要的,在这里都能找到

命名location

带有”@“的location是用来定义一个命名的location,这种location不参与请求匹配,一般用在内部定向。例如用在error_page, try_files命令中。它的功能类似于编程中的goto。


location /images { try_files $uri $uri/ @name; } location @name { … }

实际使用建议

所以实际使用中,个人觉得至少有三个匹配规则定义,如下:

直接匹配网站根,通过域名访问网站首页比较频繁,使用这个会加速处理,官网如是说。

这里是直接转发给后端应用服务器了,也可以是一个静态首页。第一个必选规则:

location = / { proxy_pass http://tomcat:8080/index }
第二个必选规则是处理静态文件请求,这是nginx作为http服务器的强项,有两种配置模式,目录匹配或后缀匹配,任选其一或搭配使用:

location ^~ /static/ { root /webroot/static/; } location ~* \.(gif|jpg|jpeg|png|css|js|ico)$ { root /webroot/res/; }
第三个规则就是通用规则,用来转发动态请求到后端应用服务器,非静态文件请求就默认是动态请求,自己根据实际把握,毕竟目前的一些框架的流行,带.php,.jsp后缀的情况很少了:

location / { proxy_pass http://tomcat:8080/ }

本文参考/引用:
Module ngx_http_core_module – nginx.org
nginx 中文文档 – nginx location匹配规则 – nginx.cn
nginx 一文彻底读懂nginx中的location指令 – nginx.cn
nginx 这一篇就够了 – 哆啦A梦的猜想 – 掘金
nginx 配置location总结及rewrite规则写法 – seanlook – 思否
nginx平台初探(100%) — Nginx开发从入门到精通

推荐阅读:
【专题:JavaScript进阶之路】
JavaScript中各种源码实现(前端面试笔试必备)
深入理解 ES6 Promise
前端性能优化小结(面试干货)
ES6 尾调用和尾递归


作者:云鱼Cloudy
链接:https://segmentfault.com/a/1190000022315733

看完两件小事

如果你觉得这篇文章对你挺有启发,我想请你帮我两个小忙:

  1. 关注我们的 GitHub 博客,让我们成为长期关系
  2. 把这篇文章分享给你的朋友 / 交流群,让更多的人看到,一起进步,一起成长!
  3. 关注公众号 「画漫画的程序员」,公众号后台回复「资源」 免费领取我精心整理的前端进阶资源教程

JS中文网是中国领先的新一代开发者社区和专业的技术媒体,一个帮助开发者成长的社区,目前已经覆盖和服务了超过 300 万开发者,你每天都可以在这里找到技术世界的头条内容。欢迎热爱技术的你一起加入交流与学习,JS中文网的使命是帮助开发者用代码改变世界

本文著作权归作者所有,如若转载,请注明出处

转载请注明:文章转载自「 Js中文网 · 前端进阶资源教程 」https://www.javascriptc.com

标题:Nginx之location配置总结

链接:https://www.javascriptc.com/3997.html

« 通俗简单易懂的 ES6 Iterators 使用指南和示例
日常工作需要且实用的JS日期知识,请收好»
Flutter 中文教程资源

相关推荐

QR code