server 和 location 中的 root，和location语法

最新推荐文章于 2025-07-03 22:21:00 发布

gtestcandle

最新推荐文章于 2025-07-03 22:21:00 发布

阅读量711

点赞数

CC 4.0 BY-SA版权

分类专栏： nginx 文章标签：服务器运维

原文链接：https://zhuanlan.zhihu.com/p/452952181

nginx 专栏收录该内容

3 篇文章

订阅专栏

本文详细解析了Nginx配置中的server与location区块中的root指令使用方式，包括不同匹配符号 (=|~|~*|^~) 的含义及优先级，帮助理解如何高效地配置Nginx。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

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 配置。

Location语法

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

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

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

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

= 表示精确匹配，比如：

location = /test {
  return 200 "hello";
}

# /test ok
# /test/ not ok
# /test2 not ok
# /test/2 not ok

~ 表示区分大小写的正则匹配，比如：

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 的时候，

location 的定义分为两种：

前缀字符串（prefix string）
正则表达式（regular expression），具体为前面带 ~* 和 ~ 修饰符的

而匹配 location 的顺序为：

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

再总结一下就是：

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

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

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

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 也能匹配到，但正则的优先级更高