首页 > 系统相关 >3.4 nginxLOCATION块配置

3.4 nginxLOCATION块配置

时间:2024-07-09 15:22:58浏览次数:11  
标签:匹配 配置 正则 3.4 nginxLOCATION location test http root

nginxlocation的匹配模式有以下几种:

  • 精确匹配:以=开头,只有完全匹配才能生效,例子location = /uri

  • 非正则匹配:以^~开头,^表示非、~表示正则,例子location ^~ /uri

  • 正则匹配:

    • ~开头,表示区分大小写的正则匹配,例子location ~ pattern
    • !~开头,表示区分大小写不匹配的正则,例子location !~ pattern
    • ~*开头,表示不区分大小写的正则匹配,例子location ~* pattern
    • !~*开头,表示不区分大小写不匹配的正则,例子location !~* pattern
  • 普通匹配:不带任何修饰符,例子location /urilocation /

我们暂且把非正则匹配和普通匹配称为前缀匹配

nginx中location匹配流程图

1 匹配模式优先级

location = /uri    =开头表示精确匹配,只有完全匹配上才能生效。
location ^~ /uri   ^~ 开头对URL路径进行前缀匹配,并且在正则之前。无正则普通匹配(^ 表示“非”,~ 表示“正则”,字符意思是:不要继续匹配正则)
location ~ pattern  ~开头表示区分大小写的正则匹配。!~为区分大小写不匹配的正则
location ~* pattern  ~*开头表示不区分大小写的正则匹配。!~*为不区分大小写不匹配的正则
location /uri     不带任何修饰符,也表示前缀匹配,但是在正则匹配之后。
location /      通用匹配,任何未匹配到其它location的请求都会匹配到,相当于switch中的default。
 

注意: 前缀匹配,如果有包含关系时,按最大匹配原则进行匹配。比如在前缀匹配:location /dir1与location /dir1/dir2,如有请求http://localhost/dir1/dir2/file将最终匹配到location /dir1/dir2

优先级: (location =) > (location 完整路径) > (location ^~ 路径) > (location ~,~* 正则顺序) > (location 部分起始路径) > (/)

上述的优先级不完全正确

具体规则:

等号类型(=)的优先级最高。一旦匹配成功,则不再查找其他location的匹配项

剩下的几种匹配优先级略复杂,具体可以查看Nginx官方文档(http://nginx.org/en/docs/http/ngx_http_core_module.html#location)

  • ^~和普通匹配。

    使用前缀匹配,不支持正则表达式,如果有多个location匹配成功的话,不会终止匹配过程,会记忆表达式最长的那个。

  • 如果上一步得到的最长的location为^~类型,则表示阻断正则表达式,不再匹配正则表达式

  • 如果上一步得到的最长的location不是^~类型,继续匹配正则表达式,只要有一个正则成功,则使用这个正则的location,立即返回结果,并结束解析过程

“最长”命中

^~和普通命中,都是优先使用匹配最长的结果,示例如下:

例子1

location /test_1 {
    return 400;
}
location ^~ /test {
    return 401;
}
 

如上如果path为/test_1,返回的是400,说明^~优先级并不比普通匹配高

例子2

location /test_1 {
    return 400;
}
location ^~ /test {
    return 401;
}
location ~ /test {
    return 402;
}
 

如上如果path为/test_1,返回的是402,此时^~和普通匹配只记住了最长一个location /test_1,不会阻止正则

如果path为/test,返回401,此时^~和普通匹配只记住了最长一个location ^~ /test,会阻止正则

2 路径替换

规则

配置proxy_pass时,可以实现URL路径的部分替换。

proxy_pass的目标地址,默认不带/,表示只代理域名,url和querystring部分不会变(把请求的path拼接到proxy_pass目标域名之后作为代理的URL)。

如果在目标地址后增加/,则表示把path中location匹配成功的部分剪切掉之后再拼接到proxy_pass目标地址。

比如请求 /a/b.html

location /a {
    proxy_pass http://server;
}
 
location /a/ {
    proxy_pass http://server/;
}
 

如上两个匹配成功后,实际代理的目标url分别是

http://server/a/b.html (把/a/b.html拼接到http://server之后)

http://server/b.html (把/a/b.html的/a/去掉之后,拼接到http://server/之后)

通过 Nginx Server 访问 http://nginx/nginx_location/some/path

proxy_pass直接映射到主机的 /test

建议location和proxy_pass后面都加上/,否则容易引起混乱。

locationproxy_pass实际访问目标
/nginx_location/ http://server/test/ http://server/test/some/path

要求

注意的是,对于location为正则表达式的匹配,proxy_pass的目标地址不可以带/

比如,如下配置会报错:

location ~ /abc(.*) {
    proxy_pass   http://127.0.0.1/;
}
 

如果是正则表达式,想要实现proxy_pass的路径替换,可以使用如下方式:

location ~ /abc(.*) {
    proxy_pass   http://127.0.0.1/$1;
}
 

3 root和alias的使用

nginx指定文件路径有两种方式root和alias,

root与alias主要区别在于nginx如何解释location后面的uri,

这会使两者分别以不同的方式将请求映射到服务器文件上。

3.1 最基本的区别

alias 指定的目录是准确的,给location指定一个目录。

root 指定目录的上级目录,并且该上级目录要含有locatoin指定名称的同名目录。

以root方式设置资源路径:

语法: root path;
配置块: http、server、location、if
 

以alias 方式设置资源路径

语法: alias path;
配置块: location
 

Example:

location /img/ {
	alias /var/www/image/;
}
#若按照上述配置的话,则访问/img/目录里面的文件时,ningx会自动去/var/www/image/目录找文件
location /img/ {
	root /var/www/image;
}
#若按照这种配置的话,则访问/img/目录下的文件时,nginx会去/var/www/image/img/目录下找文件
 

注意:

1.使用alias时,目录名后面一定要加”/“。
2.使用alias标签的目录块中不能使用rewrite的break。
3.alias在使用正则匹配时,必须捕捉要匹配的内容并在指定的内容处使用。
4.alias只能位于location块中
 

所以使用nginx设置root时要注意一个问题,就是如果该root设置的前端目录不是根目录,那么在写root的绝对地址时,要把前端目录的部分省略掉。 我们用设置虚拟目录指向的alias来和root比较一下就非常明显了

location /abc/ {   alias /home/html/abc/; }  
 

在这段配置下,http://test/abc/a.html就指定的是 /home/html/abc/a.html。这段配置亦可改成

location /abc/ {   root /home/html/;} 
 

可以看到,使用root设置目录的绝对路径时,少了/abc,也就是说,使用root来设置前端非根目录时,nginx会组合root和location的路径,即 /home/html/abc/。

4 try_files指令

Syntax:	try_files file ... uri;
try_files file ... =code;
Default:	—
Context:	server, location
 

示例

try_files $uri $uri/ /test/;
 

功能:依次试图访问多个url对应的文件(由root或者alias指令指定),当文件存在是直接返回文件内容,如果所有文件都不存在,则按最后一个URL结果或者code返回

5 stub_status

配置示例

location /basic_status {
	stub_status;
}
 

ngx_http_stub_status_module模块內建的状态页 用于输出nginx的基本状态信息;

server{
....
	location /ngxstatus {
		stub_status;
	}
}
 

信息页返回数值:

Active connections: 291
server accepts handled requests
16630948 16630948 31070465
Reading: 6 Writing: 179 Waiting: 106
 
  • Active connections: 活动状态的连接数;
  • accepts:已经接受的客户端请求的总数;
  • handled:已经处理完成的客户端请求的总数;
  • requests:客户端发来的总的请求数;
  • Reading:处于读取客户端请求报文首部的连接的连接数;
  • Writing:处于向客户端发送响应报文过程中的连接数;
  • Waiting:处于等待客户端发出请求的空闲连接数;
 

标签:匹配,配置,正则,3.4,nginxLOCATION,location,test,http,root
From: https://www.cnblogs.com/david-cloud/p/18291981

相关文章

  • 3.1 nginx全局块和events块配置
    1example#运行Nginx进程的用户usernginx;worker_processes8;worker_cpu_affinityauto;#定义存储某类型的全局错误的日志位置#nginx日志分为很多级别[debug|info|notice|warn|error|crit|alert|emerg]error_log/var/log/nginx/error.logerror;......
  • Rancher 安装配置
    安装添加HelmChart仓库helmrepoaddrancher-stablehttp://rancher-mirror.oss-cn-beijing.aliyuncs.com/server-charts/stable 为Rancher创建Namespacekubectlcreatenamespacecattle-system 添加TLS密文下载nginx使用的key和pem传到服务器,并......
  • Prometheus Operator 安装配置
    一、概述首先Prometheus整体监控结构略微复杂,一个个部署并不简单。另外监控Kubernetes就需要访问内部数据,必定需要进行认证、鉴权、准入控制,那么这一整套下来将变得难上加难,而且还需要花费一定的时间,如果你没有特别高的要求,还是建议选用开源比较好的一些方案。在k8s初期使用Hea......
  • Harbor 安装配置
    #下载helmchartshelmrepoaddharborhttps://helm.goharbor.iohelmrepoupdatehelmpullharbor/harbor--version=1.9.4tar-xvfharbor-1.9.4.tgz#配置tlssecret##下载nginx使用的key和pem传到服务器,并重命名为tls.xxx##使用openssl把pem证书转换......
  • 【饼图交通方式】用ECharts的graphic配置打造个性化
    利用ECharts的graphic配置打造个性化图表内容概要ECharts是一款强大的数据可视化工具,它提供了丰富的配置选项来定制图表。本文将重点介绍graphic配置的使用,展示如何通过在饼图中添加个性化的图形元素,例如中心图像,来增强图表的视觉效果。效果预览适用人群数据可视化工......
  • Calico 安装配置
    架构简单说一下Calico架构,Calico是一个基于三层的数据中心网络方案,可作为CNI插件为运行于Kubernetes中的容器提供基于TCP/IP三层的网络通信方案,也可与OpenStack这种IaaS云架构集成,利用BGP,IPIP等协议为工作负载提供网络联通功能,能够提供高效可控的VM、容器、物理......
  • Helm 安装配置
    安装下载二进制文件exporthelmversion=3.7.2wgethttps://get.helm.sh/helm-v${helmversion}-linux-amd64.tar.gztar-xvfhelm-v${helmversion}-linux-amd64.tar.gzmvlinux-amd64/helm/usr/bin/ 设置补全命令helmcompletionbash#将输出的文件拷贝到``/etc/......
  • 4.6 pipeline 生产配置实例
    pipeline配置java项目pipeline{agent{label'slave'}options{timestamps()disableConcurrentBuilds()buildDiscarder(logRotator(numToKeepStr:'20',daysToKee......
  • 2 Ansible Inventory配置详解
    在使用Ansible来批量管理主机的时候,通常我们需要先定义要管理哪些主机或者主机组,而这个用于管理主机与主机组的文件就叫做Inventory,也叫主机清单。AnsibleInventory是包含静态Inventory和动态Inventory两部分的,静态Inventory指的是在文件中指定的主机和组,动态Inventory......
  • 如何解决数据库配置问题
    识别配置问题收集错误信息:首先,收集数据库配置过程中出现的所有错误信息和日志。这些信息通常会在数据库服务器的日志文件、系统日志或应用程序日志中记录。分析问题性质:分析错误信息以确定问题的性质。这可能涉及检查数据库连接问题、性能瓶颈、配置参数不当等。检查配置文......