Nginx location 匹配

Nginx location 匹配

Nginx 经常用,不过一直感觉配置挺玄学,,,以往都贯彻 “能用就行” 的原则,不求甚解。

今天把 location 部分整理下,供以后查阅。

位置

location 模块 一般位于 http/server 下,用于对请求的分发处理。

nginx
1http {
2    gzip on;
3    # ...
4
5    server {
6        listen 80;
7        # ...
8
9        location / {
10            # config
11        }
12    }
13}

语法

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

location 会尝试根据用户请求中的 URI 来匹配上面的 /uri 表达式,如果可以匹配,就选择 location {} 中的配置来处理用户请求。

  1. = 表示 URI 作为字符串,与参数中的 uri 做完全匹配。

    • 感觉用的地方不多
  2. ~ 表示区分大小写的正则匹配。

    • 可以使用 $1 ($ + groupIndex)来取子组
  3. ~* 表示不区分大小写的正则匹配。

    • 同上
  4. ^~ 前缀匹配。目的是优先于正则表达式的匹配。

    • 这个和普通匹配规则类似,但是优先级如右:[普通] < [正则] < [^~]
  5. @ 仅表示用 Nginx 服务内部请求之间的重定向,不讨论了。

URL 尾部的 /

有时候写这玩意儿经常忘记后面 / 的作用,然后就去查一下,过段时间又忘记了,又查...

location 尾部的 /

  1. location 尾部没有 / 时。
    • location /a/b 为例。
    • 可以匹配:
      • /a/bc
      • /a/b/c
  2. location 尾部有 / 时,表示一个目录。
    • location /a/b/ 为例。
    • 可以匹配:
      • /a/b/
      • /a/b/c
    • 不能匹配:
      • /a/bc

proxy_pass 尾部的 /

严格来说并不是以 proxy_pass 后面的 url 是否添加 / 来判断匹配。
proxy_pass 后面的地址,host:port 后面如果有 任意以/开头的字符串,就表示有 uri,实际转发规则如下:

  1. 无 uri, [proxy_pass][location][location_postfix]

  2. 有 uri, [proxy_pass][location][location_postfix]

即有 uri 的 proxy_pass,会把 location 定义的地址替换掉。

example:

nginx
1# 1. 无 uri, `[proxy_pass][location][location_postfix]`
2server {
3    listen 80;
4
5    location /proxy/ {
6        proxy_pass 127.0.0.1:8080;
7    }
8}
9
10# url:   127.0.0.1:80/proxy/info
11# proxy: 127.0.0.1:8080/proxy/info
12
13
14# 2. 有 uri,`[proxy_pass][location_postfix]`,location部分被替换掉
15server {
16    listen 80;
17
18    location /proxy1/ {
19        proxy_pass 127.0.0.1:8080/api;
20    }
21
22    location /proxy2/ {
23        proxy_pass 127.0.0.1:8080/api/;
24    }
25}
26
27# url:   127.0.0.1:80/proxy1/info
28# proxy: 127.0.0.1:8080/apiinfo
29# 过程: 127.0.0.1:8080/api/proxy1/info,然后替换掉 /proxy1/,得到  127.0.0.1:8080/apiinfo
30
31# url:   127.0.0.1:80/proxy2/info
32# proxy: 127.0.0.1:8080/api/info
33# 过程: 127.0.0.1:8080/api//proxy2/info,然后替换掉 /proxy2/,得到  127.0.0.1:8080/api/info

托管静态资源

这种对于前端来说最常见了,一般用 root|alias + try_files 的组合。

文件路径的定义

有 root 和 alias 两种方式,差别是 root 会保留 [location] 的匹配,而 alias 会去掉。

root

  • 语法: root path;
  • 默认: root html;
  • 配置块: http、server、location、if

example:

nginx
1location /download/ {
2    root /opt/web/html/;
3}
4
5# url:  host:port/download/hello.txt
6# dist: /opt/web/html/download/hello.txt
7
8# location 所定义的 /download/ 这一层会保留下来。

alias

  • 语法: alias path;
  • 配置块: location

example:

nginx
1location /download/ {
2    alias /opt/web/html/;
3}
4
5# url:  host:port/download/hello.txt
6# dist: /opt/web/html/hello.txt
7
8# location 所定义的 /download/ 这一层就被干掉了。

访问首页

有时访问站点的 URI 是 /,这种情况一般返回首页。 这与上述的 root、alias 都不同。

nginx
1location / {
2    root path;
3    index index.html index.php;
4}
5
6# 当访问 host:port 的时候,会依次尝试返回 index.html、index.php

try_files

这是必定会用到的一个命令,用于定义资源查找规则。比如常常有这么个情景:

如果应用使用 history 路由,那么对于请求能用 url 找到就返回这个资源,否则返回 /index.html。

nginx
1location /app {
2    root /root/www/;
3    try_files $uri /index.html =404;
4}

当用户访问 /app 的时候,会先尝试访问 /root/www/app 文件,再尝试 /root/www/app/index.html

注意,try_files 中的 /index.html 是相对于 root 的,而 root 不能跟 alias 一起用...

root 没有 alias 那么灵活,因此使用 try_files 就有了一些限制。暂时没有找到屏蔽 root 的方式,以后再补充吧。

to-be-continued
avatar

闲暇时候的文章

会写一些 代码、心情、生活、食物 等东西,分享所学,验证所得,

如果碰巧你找到感兴趣的东西,可以来瞅瞅。

Copyright © 2017 - 2024 xieshuang. All Rights Reserved. Power by k8s + nestjs + next + vue + typescript.
鄂ICP备20008501号-1