一份简单够用的 Nginx Location 配置讲解

语言: CN / TW / HK

前言

Location 是 Nginx 中一个非常核心的配置,这篇重点讲解一下 Location 的配置问题以及一些注意事项。

语法

关于 Location,举个简单的配置例子:

http {   
  server {  
      listen 80;  
        server_name www.yayujs.com;  
        location / {  
          root /home/www/ts/;  
          index index.html;  
        }  
  }  
}

大致的意思是,当你访问 www.yayujs.com 的 80 端口的时候,返回 /home/www/ts/index.html 文件。

我们看下 Location 的具体语法:

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

重点看方括号中的 [ = | ~ | ~* | ^~ ],其中 | 分隔的内容表示你可能会用到的语法,其中:

  • = 表示精确匹配,比如:
location = /test {  
  return 200 "hello";  
}  

# /test ok  
# /test/ not ok  
# /test2 not ok  
# /test/2 not ok
*   ~ 表示区分大小写的正则匹配,比如:

```bash
location ~ ^/test$ {  
  [ configuration ]   
}  

# /test ok  
# /Test not ok  
# /test/ not ok  
# /test2 not ok
  • ~* 表示不区分大小写的正则匹配
location ~* ^/test$ {       
    [ configuration ]   
}  

# /test ok  
# /Test ok  
# /test/ not ok  
# /test2 not ok
  • ^~ 表示 uri 以某个字符串开头
location ^~ /images/ {      
    [ configuration ]   
}  

# /images/1.gif ok

而当你不使用这些语法的时候,只写 uri 的时候:

/ 表示通用匹配:

location / {       
    [ configuration ]   
}  

# /index.html ok
location /test {  
    [ configuration ]   
}  

# /test ok  
# /test2 ok  
# /test/ ok

匹配顺序

当存在多个 location 的时候,他们的匹配顺序引用 Nginx 官方文档就是:

翻译整理后就是:

location 的定义分为两种:

  • 前缀字符串(prefix string)
  • 正则表达式(regular expression),具体为前面带 ~* 和 ~ 修饰符的

而匹配 location 的顺序为:

  1. 检查使用前缀字符串的 locations,在使用前缀字符串的 locations 中选择最长匹配的,并将结果进行储存
  2. 如果符合带有 = 修饰符的 URI,则立刻停止匹配
  3. 如果符合带有 ^~ 修饰符的 URI,则也立刻停止匹配。
  4. 然后按照定义文件的顺序,检查正则表达式,匹配到就停止
  5. 当正则表达式匹配不到的时候,使用之前储存的前缀字符串

再总结一下就是:

在顺序上,前缀字符串顺序不重要,按照匹配长度来确定,正则表达式则按照定义顺序。

在优先级上,= 修饰符最高,^~ 次之,再者是正则,最后是前缀字符串匹配。

我们举几个简单的例子复习下:

server {  
    location /doc {  
        [ configuration A ]   
    }  
    location /docu {  
        [ configuration B ]   
    }  
}  

# 请求 /document 使用 configuration B  
# 虽然 /doc 也能匹配到,但在顺序上,前缀字符串顺序不重要,按照匹配长度来确定
server {  

    location ~ ^/doc {  
        [ configuration A ]   
    }  
    location ~ ^/docu {  
        [ configuration B ]   
    }  
}  

# 请求 /document 使用 configuration A  
# 虽然 ~ ^/docu 也能匹配到,但正则表达式则按照定义顺序
server {  
    location ^~ /doc {  
        [ configuration A ]   
    }  
    location ~ ^/docu {  
        [ configuration B ]   
    }  
}  

# 请求 /document 使用 configuration A  
# 虽然 ~ ^/docu 也能匹配到,但 ^~ 的优先级更高
server {  
    location /document {  
        [ configuration A ]   
    }  
    location ~ ^/docu {  
        [ configuration B ]   
    }  
}  

# 请求 /document 使用 configuration B  
# 虽然 /document 也能匹配到,但正则的优先级更高

root 与 alias 的区别

当我们这样设置 root 的时候:

location /i/ {  
    root /data/w3;  
}

当请求 /i/top.gif ,/data/w3/i/top.gif 会被返回。

当我们这样设置 alias 的时候:

location /i/ {  
    alias /data/w3/images/;  
}

当请求 /i/top.gif ,/data/w3/images/top.gif 会被返回。

乍一看两者很像,但细一看,就能看出两者的区别,root 是直接拼接 root + location 而 alias 是用 alias 替换 location,所以 root 中最后的路径里有 /i/,而 alias 中最后的路径里没有 /i/ 。

所以如果你这样使用 allias 定义一个路径:

location /images/ {  
    alias /data/w3/images/;  
}

其实使用 root 会更好:

location /images/ {  
    root /data/w3;  
}

server 和 location 中的 root

server 和 location 中都可以使用 root,举个例子:

http {   
  server {  
      listen 80;  
        server_name www.yayujs.com;  
        root /home/www/website/;  
        location / {  
          root /home/www/ts/;  
          index index.html;  
        }  
  }  
}

如果两者都出现,是怎样的优先级呢?

简单的来说,就是就近原则,如果 location 中能匹配到,就是用 location 中的 root 配置,忽略 server 中的 root,当 location 中匹配不到的时候,则使用 server 中的 root 配置。

作者:冴羽

(版权归原作者所有,侵删)

本文链接:http://www.yunweipai.com/40863.html