nginx 的 location 模块

刘某的Cloud2024-03-12 23:28

目录

一、匹配规则

1.基础匹配

2.精确匹配

3.前缀匹配

4.正则表达式匹配

二、优先级顺序

三、示例

1.精确匹配

2.前缀匹配

3.正则匹配

4.默认匹配

第一种情况：proxy_pass最后面没有斜杠,匹配路径有斜杠(/bbb/)

[第二种情况： proxy_pass最后面有斜杠 "/"，匹配路径也有斜杠(/bbb/)](#第二种情况： proxy_pass最后面有斜杠 “/”，匹配路径也有斜杠(/bbb/))

[第三种情况：proxy_pass后面还有其他路径但是最后没有 "/"， 匹配路径也有斜杠(/bbb/)](#第三种情况：proxy_pass后面还有其他路径但是最后没有 “/”， 匹配路径也有斜杠(/bbb/))

[第四种情况： proxy_pass后面还有其他路径但是最后有 "/"， 匹配路径也有斜杠(/bbb/)](#第四种情况： proxy_pass后面还有其他路径但是最后有 “/”， 匹配路径也有斜杠(/bbb/))

[第五种情况：location匹配路径末尾没有 "/"，proxy_pass后面也没有"/"](#第五种情况：location匹配路径末尾没有 “/”，proxy_pass后面也没有“/”)

一、匹配规则

1.基础匹配

  • location / { ... }：这是最基本的匹配，匹配所有请求。因为它没有指定具体的文件或目录，所以通常作为后备选项出现。

2.精确匹配

  • location = /exact/path { ... }：精确匹配这个路径。如果请求的 URI 完全等于 /exact/path，则使用这个 location 块的配置处理此请求。这具有最高的优先级。

3.前缀匹配

  • location /prefix/ { ... }：前缀匹配请求的 URI 的开始部分。如果请求的 URI 以 /prefix/ 开始，这个 location 块将被用来处理请求。
  • location ^~ /prefix/ { ... }：前缀匹配，但它会停止正则表达式匹配，即使正则表达式可能会更具体匹配。如果该 location 匹配，Nginx 不会考虑之后的正则 location 块。

4.正则表达式匹配

  • location ~ /regex/ { ... }：大小写敏感的正则匹配。
  • location ~* /regex/ { ... }：大小写不敏感的正则匹配。
  • location / { ... } 正则表达式匹配会在普通字符串前缀匹配后进行。如果有多个正则表达式 location 都匹配请求，则使用第一个匹配的 location 块。

二、优先级顺序

Nginx 处理请求时 location 匹配的优先级顺序如下：

  1. 首先进行精确匹配 location =
  2. 其次按文件中出现顺序匹配所有正则表达式 location ~ 和 location ~*
  3. 然后进行最长的前缀匹配 location ^~
  4. 最后是通常的前缀匹配 location /prefix/
  5. 如果前面的匹配都没有找到，就使用默认的 location /

三、示例

1.精确匹配

bash 复制代码 
server {
    listen 80;
    listen [::]:80;
    server_name welcome.com;
    access_log /etc/nginx/vhost/logs/access_welcome.log;
    error_log /etc/nginx/vhost/logs/error_welcome.log;
    
    location /test.html {
        root /usr/share/nginx/html;
    }

    location = /test.html {
        #通过 root 路径，会将条件拼接进来
        root /var/www/html;
        index index.html;
    }

    error_page 404 /404.html;    
    location = /404.html {
        root /usr/share/nginx/test_html;
    }
    
    error_page 500 502 503 504 /50x.html;
    location = /50x.html {
    }
}
# 第一个和第二个location匹配条件一样，都是/test.html
# 但第二个为精准匹配到静态路径，因此第一个不会执行，会执行第二个。
bash 复制代码 
server {
    listen 80;
    listen [::]:80;
    server_name welcome.com;
    access_log /etc/nginx/vhost/logs/access_welcome.log;
    error_log /etc/nginx/vhost/logs/error_welcome.log;
    
    location /test.html {
       #通过alias指定路径，无需拼接条件
       #alias指定的路径结尾要加"/"
       alias /usr/share/nginx/test_html/;
    }

    error_page 404 /404.html;    
    location = /404.html {
        root /usr/share/nginx/test_html;
    }
    
    error_page 500 502 503 504 /50x.html;
    location = /50x.html {
    }
}

# 指定静态资源路径除了使用关键字root，还可以用alias。
# 那么root和alias的区别是什么？
# 用root属性指定的值是要加入到最终路径中的，匹配条件会拼接到路径中
# 用alias属性指定的值不需要加入到最终路径中

# 请求的条件为test.html，通过root指定的路径为/usr/share/nginx/test_html，因此在匹配的时候，这个路径下就必须要有test.html这个文件才可以，否则就会找不到而报错，如果用alias，那么通过浏览器进行请求的时候，alias也是指定到/usr/share/nginx/test_htm路径下，但是会匹配默认的index.html，而无须强制匹配test.html。

# 不能使用"="来进行精确匹配

2.前缀匹配

bash 复制代码 
server {
    listen 80;
    listen [::]:80;
    server_name welcome.com;
    access_log /etc/nginx/vhost/logs/access_welcome.log;
    error_log /etc/nginx/vhost/logs/error_welcome.log;
    
    location ^~ /a/ {
        root /data/webroot/;
    }

    location ^~ /a/www/ {
        root /data/webroot/;
    }
    
}

# 当请求为 http://welcome.com/a/ 时，访问 /data/webroot/a/ 下的index.html文件
# 当请求为 http://welcome.com/a/www/ 时，访问 /data/webroot/a/www/ 下的index.html文件
# 如果^~匹配成功了，那么表示阻断正则表达式，不再进行正则匹配

3.正则匹配

bash 复制代码 
# 正则表达式匹配，大小写敏感
server {
    listen 80;
    listen [::]:80;
    server_name welcome.com;
    access_log /etc/nginx/vhost/logs/access_welcome.log;
    error_log /etc/nginx/vhost/logs/error_welcome.log;
    
    location ~ \.(gif|jpg|png)$ {
        root /var/www/images;
    }

    error_page 404 /404.html;    
    location = /404.html {
        root /usr/share/nginx/test_html;
    }
    
    error_page 500 502 503 504 /50x.html;
    location = /50x.html {
    }
}
bash 复制代码 
# 正则表达式匹配，大小写不敏感
server {
    listen 80;
    listen [::]:80;
    server_name welcome.com;
    access_log /etc/nginx/vhost/logs/access_welcome.log;
    error_log /etc/nginx/vhost/logs/error_welcome.log;
    
    location ~* \.(css|js)$ {
        root /var/www/assets;
    }

    error_page 404 /404.html;    
    location = /404.html {
        root /usr/share/nginx/test_html;
    }
    
    error_page 500 502 503 504 /50x.html;
    location = /50x.html {
    }
}

4.默认匹配

第一种情况：proxy_pass最后面没有斜杠,匹配路径有斜杠(/bbb/)

bash 复制代码 
server {
    listen 80;
    listen [::]:80;
    server_name welcome.com;
    access_log /etc/nginx/vhost/logs/access_welcome.log;
    error_log /etc/nginx/vhost/logs/error_welcome.log;
    
    #默认匹配
    location /bbb/ {
        proxy_pass http://127.0.0.1:9190;
        proxy_redirect    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://10.9.2.248/bbb/
# 那么实际访问的地址就是 http://127.0.0.1:9190/bbb/，会将匹配路径/bbb一起加过去。

第二种情况： proxy_pass最后面有斜杠 "/"，匹配路径也有斜杠(/bbb/)

bash 复制代码 
server {
    listen 80;
    listen [::]:80;
    server_name welcome.com;
    access_log /etc/nginx/vhost/logs/access_welcome.log;
    error_log /etc/nginx/vhost/logs/error_welcome.log;
    
    #默认匹配
    location /bbb/ {
        proxy_pass http://127.0.0.1:9190/;
        proxy_redirect    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://10.9.2.248/bbb/
# 那么实际访问的地址就是 http://127.0.0.1:9190，会将/bbb抛弃的，

第三种情况：proxy_pass后面还有其他路径但是最后没有 "/"， 匹配路径也有斜杠(/bbb/)

bash 复制代码 
server {
    listen 80;
    listen [::]:80;
    server_name welcome.com;
    access_log /etc/nginx/vhost/logs/access_welcome.log;
    error_log /etc/nginx/vhost/logs/error_welcome.log;
    
    #默认匹配
    location /bbb/ {
        proxy_pass http://127.0.0.1:9190/ccc;
        proxy_redirect    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://10.9.2.248/bbb/index.html
# 实际请求的是http://127.0.0.1/index.html
# 位置是默认路径下，不是ccc路径下
# 如果proxy_pass的路径为/ccc/ddd，那么实际请求的就是ccc路径下的cccindex.html

第四种情况： proxy_pass后面还有其他路径但是最后有 "/"， 匹配路径也有斜杠(/bbb/)

bash 复制代码 
server {
    listen 80;
    listen [::]:80;
    server_name welcome.com;
    access_log /etc/nginx/vhost/logs/access_welcome.log;
    error_log /etc/nginx/vhost/logs/error_welcome.log;
    
    #默认匹配
    location /bbb/ {
        proxy_pass http://127.0.0.1:9190/ccc/;
        proxy_redirect    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://10.9.2.248/bbb/index.html，
# 实际访问的是http://127.0.0.1/ccc/index.html

第五种情况：location匹配路径末尾没有 "/"，proxy_pass后面也没有"/"

bash 复制代码 
server {
    listen 80;
    listen [::]:80;
    server_name welcome.com;
    access_log /etc/nginx/vhost/logs/access_welcome.log;
    error_log /etc/nginx/vhost/logs/error_welcome.log;
    
    #默认匹配
    location /bbb {
        proxy_pass http://127.0.0.1:9190;
        proxy_redirect    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://10.9.2.248/bbb
# 默认将请求到http://127.0.0.1:9190/bbb/index.html的内容
相关推荐
早起鸟儿1 小时前
docker-Dockerfile 配置
java·linux·运维·docker
虚妄狼1 小时前
【Docker Desktop】Windows11安装 Docker Desktop
运维·docker·容器
Hello.Reader2 小时前
NGINX 四层上游模块`ngx_stream_upstream_module` 实战指南
运维·nginx
tiantianuser2 小时前
RDMA简介7之RoCE v2可靠传输
服务器·fpga开发·verilog·xilinx·rdma·可编程逻辑
IT成长日记2 小时前
【Docker基础】Docker核心概念：命名空间（Namespace）与资源隔离联系
运维·docker·namespace·资源隔离·命令空间
Mikhail_G2 小时前
Python应用八股文
大数据·运维·开发语言·python·数据分析
再ZzZ3 小时前
Docker安装PaddleOCR并提供接口服务(CPU)
运维·docker·容器
国际云，接待4 小时前
微软云注册被阻止怎么解决？
服务器·网络·microsoft·云原生·微软·云计算
love530love4 小时前
是否需要预先安装 CUDA Toolkit？——按使用场景分级推荐及进阶说明
linux·运维·前端·人工智能·windows·后端·nlp
m0_694845574 小时前
日本云服务器租用多少钱合适
linux·运维·服务器·安全·云计算
热门推荐
01DeepSeek各版本说明与优缺点分析02Coze扣子平台完整体验和实践（附国内和国际版对比）03KGG转MP3工具|非KGM文件|解密音频04扣子（coze）实战|我用扣子搭建了一个自动分析小红薯笔记内容的AI应用|详细步骤拆解05【图像处理与机器视觉】XJTU期末考点06YOLOv8入门 | 重要性能衡量指标、训练结果评价及分析及影响mAP的因素【发论文关注的指标】07ADS仿真低噪声放大器学习笔记08海康Visionmaster-常见问题排查方法-启动阶段09从零安装 LLaMA-Factory 微调 Qwen 大模型成功及所有的坑10基于单片机的智能环境监测系统