Nginx 路径匹配规则

off999 2025-01-20 15:41 21 浏览 0 评论

Nginx路径匹配符号

= 表示精确匹配
^~ 表示uri以某个常规字符串开头,大多情况下用来匹配url路径，nginx不对url做编码，因此请求为/static/20%/aa，可以被规则^~ /static/ /aa匹配到（注意是空格）。
~ 正则匹配(区分大小写)
~* 正则匹配(不区分大小写)
!~ 区分大小写不匹配
!~* 不区分大小写不匹配
/ 任何请求都会匹配

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

符号优先级

首先匹配 =，其次匹配^~, 其次是按文件中顺序的正则匹配，最后是交给 / 通用匹配。当有匹配成功时候，停止匹配，按当前匹配规则处理请求。

示例

location  = / {
  # 精确匹配 / ，主机名后面不能带任何字符串
  [ 规则 A ] 
}

location  / {
  # 因为所有的地址都以 / 开头，所以这条规则将匹配到所有请求
  # 但是正则和最长字符串会优先匹配
  [ 规则 B ] 
}

location /documents/ {
  # 匹配任何以 /documents/ 开头的地址，匹配符合以后，还要继续往下搜索
  # 只有后面的正则表达式没有匹配到时，这一条才会采用这一条
  [ 规则 C ] 
}

location ~ /documents/Abc {
  # 匹配任何以 /documents/ 开头的地址，匹配符合以后，还要继续往下搜索
  # 只有后面的正则表达式没有匹配到时，这一条才会采用这一条
  [ 规则 D ] 
}

location ^~ /images/ {
  # 匹配任何以 /images/ 开头的地址，匹配符合以后，停止往下搜索正则，采用这一条。
  [ 规则 E ] 
}

location ~* \.(gif|jpg|jpeg)$ {
  # 匹配所有以 gif,jpg或jpeg 结尾的请求
  # 然而，所有请求 /images/ 下的图片会被 [规则 E] 处理，因为 ^~ 优先级更高
  [ 规则 F ] 
}

location /images/ {
  # 字符匹配到 /images/，继续往下，会发现 ^~ 存在
  [ 规则 G ] 
}

location /images/abc {
  # 最长字符匹配到 /images/abc，继续往下，会发现 ^~ 存在
  [ 规则 H ] 
}

location ~ /images/abc/ {
  # 只有去掉 [规则 E] 才有效：先最长匹配 [规则 H] 开头的地址，继续往下搜索，匹配到这一条正则，采用
  [ 规则 I ] 
}

其他简单示例

# 微信授权文件通用匹配规则
location ~(MP_verify_)*\.(txt)$ {
    root   /usr/share/nginx/file;
}

匹配MPverify****.txt文件，中间任意字符，并在/usr/share/nginx/file目录中寻找对应文件

# 静态文件工程配置
location ^~ /static/ {
    root   /data/product/static;
    index  index.html index.htm;
}

匹配/static开头路径，并在/data/product/static寻找对应文件

# 静态文件配置
location ~* \.(html|htm|gif|jpg|jpeg|bmp|png|ico|txt|js|css)$ {  
    root /data/product/static/;  
}

配置proxy_pass时路径拼接规则

在nginx中配置proxypass时，如果是按照^~匹配路径时,要注意proxypass后的url最后的/

当加上了/，相当于是绝对根路径，则nginx不会把location中匹配的路径部分代理走;
如果没有/，则会把匹配的路径部分也给代理走

server {
    listen 80;
    server_name test.huangjian.com;

    location ^~ /bpm {
        proxy_set_header    Host $host;
        proxy_set_header    X-Real-IP  $remote_addr;
        proxy_pass http://127.0.0.1:8081/;
    }
}

加上/ 请求地址http://test.huangjian.com/bpm/index，会转发到http://127.0.0.1:8081/index

server {
    listen 80;
    server_name test.huangjian.com;

    location ^~ /bpm {
        proxy_set_header    Host $host;
        proxy_set_header    X-Real-IP  $remote_addr;
        proxy_pass http://127.0.0.1:8081;
    }
}