Nginx Location映射规则总结归纳
❃博主首页 ：
「码到三十五」
，同名公众号 :「码到三十五」，wx号 : 「liwu0213」
☠博主专栏 ：
<源码解读>
<面试攻关>
♝博主的话 ： 搬的每块砖，皆为峰峦之基；公众号搜索「码到三十五」关注这个爱发技术干货的coder，一起筑基
☠博主专栏 ：
♝博主的话 ： 搬的每块砖，皆为峰峦之基；公众号搜索「码到三十五」关注这个爱发技术干货的coder，一起筑基
Nginx的location指令是配置请求路由的核心机制，其匹配规则直接影响请求的处理流程。下面基于官方文档和实战经验的总结：
一、Location匹配规则与优先级
1. 匹配模式
Nginx支持5种location修饰符，优先级从高到低为：
| 修饰符 | 说明 | 示例 |
|---|---|---|
= | 精确匹配（最高优先级） | location = /logo.png |
^~ | 最长前缀匹配（匹配后停止正则检查） | location ^~ /static/ |
~ | 正则匹配（区分大小写，按配置文件顺序匹配） | location ~ .php$ |
~* | 正则匹配（不区分大小写） | `location ~* .(jpg |
| 无 | 普通前缀匹配（按最长匹配原则，优先级最低） | location /blog/ |
2. 优先级顺序
Nginx按以下顺序匹配location块：
- 精确匹配（
=）
仅当请求URI与location后的字符串完全匹配时生效。 - 正则匹配（
~/~*）
按配置文件中的书写顺序依次匹配，首个匹配的正则生效。 - 最长前缀匹配（
^~）
选择匹配URI前缀最长的location块。 - 普通前缀匹配
按最长匹配原则选择，若多个location匹配，选择最先定义的。 - 默认匹配（
location /）
兜底处理未匹配其他规则的请求。
3. 匹配示例
假设配置如下：
location = /exact { ... } # 精确匹配
location ^~ /prefix { ... } # 最长前缀匹配
location ~ .png$ { ... } # 正则匹配（区分大小写）
location /general { ... } # 普通前缀匹配
location / { ... } # 默认匹配
- 请求
/exact→ 匹配location = /exact。 - 请求
/prefix/long→ 匹配location ^~ /prefix（^~优先级高于普通前缀）。 - 请求
/image.PNG→ 匹配location ~* .(jpg|png)$（不区分大小写的正则）。 - 请求
/general/path→ 匹配location /general。
二、Proxy_pass路径处理规则
proxy_pass指令用于将请求转发到后端服务，其路径拼接逻辑与location配置紧密相关。
1. 路径拼接规则
| 场景 | 示例配置 | 请求URI | 转发目标 |
|---|---|---|---|
proxy_pass带/结尾 | location /api/ { proxy_pass http://backend/; } | /api/user | http://backend/user |
proxy_pass不带/ | location /api { proxy_pass http://backend; } | /api/user | http://backend/api/user |
正则location | location ~ ^/app/(.*) { proxy_pass http://app/$1; } | /app/v1/data | http://app/v1/data |
关键规则：
- 带
/：proxy_pass的URL以/结尾时，替换location匹配的部分。 - 不带
/：proxy_pass的URL不带/时，追加location匹配后的完整路径。
2. 路径截取与重写
通过rewrite指令可动态修改转发路径：
location ~* ^/api/v1/ {
rewrite ^/api/v1/(.*) /$1 break; # 截取/api/v1/后的路径
proxy_pass http://backend;
}
- 请求
/api/v1/user/123→ 转发到http://backend/user/123。
3. 特殊场景处理
- Unix Socket转发：
location /unix/ { proxy_pass http://unix:/var/run/backend.sock:/; } - 避免301重定向：
location /app { proxy_pass http://backend; } # 请求/app（无结尾/）时，Nginx可能自动重定向到/app/ # 使用精确匹配避免： location = /app { proxy_pass http://backend; }
三、配置优化与最佳实践
- 精确匹配优先
将location =块置于配置文件顶部，减少正则匹配开销。 - 正则匹配顺序
将高频请求的正则规则前置，提升匹配效率。 - 路径设计一致性
确保location和proxy_pass的URL格式（是否带/）一致，避免路径拼接错误。 - 监控
使用error_log和access_log跟踪匹配过程，优化配置。
四、完整配置示例
server {
listen 80;
server_name example.com;
# 精确匹配静态文件
location = /favicon.ico {
log_not_found off;
access_log off;
root /var/www/icons;
}
# 最长前缀匹配API请求
location ^~ /api/ {
proxy_pass http://api_server;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
}
# 正则匹配图片资源（不区分大小写）
location ~* .(jpg|png|gif)$ {
expires 30d;
root /var/www/images;
}
# 默认匹配
location / {
root /var/www/html;
index index.html;
}
}
配置说明：
- 精确匹配
favicon.ico，关闭日志提升性能。 ^~ /api/匹配所有以/api/开头的请求，转发到后端服务。- 正则匹配图片文件，设置30天缓存。
- 未匹配的请求由
location /处理，返回静态文件。
本文地址：https://www.vps345.com/11000.html
上一篇：Linux 文件权限
