Nginx中Location配置超详细讲解
蹲街式等待 人气:0一、语法
Location 是 Nginx 中一个非常核心的配置,关于Location,举个简单的配置例子:
server { listen 80; server_name 10.0.7.115; location / { root /data/app/; index index.html; } }
当访问 http://10.0.7.115:80
的时候,返回的是 /data/app/index.html
文件。
Location具体语法:
location [ = | ~ | ~* | ^~ ] uri { ... }
重点看方括号中的 [ = | ~ | ~* | ^~ ]
,其中 |
分隔的内容表示你可能会用到的语法,其中:
=
表示精确匹配:
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
/
表示通用匹配:
location / { [configuration] }
例如:
/index.html ok
location /test { [configuration] }
例如:
/test ok /test2 ok /test/ ok
二、匹配顺序
Location的定义分为两种:
- 前缀字符串(prefix string)
- 正则表达式(regular expression),具体为
前面带 ~* 和 ~ 修饰符
的
当存在多个 Location 的时候,匹配的顺序为:
检查使用前缀字符串的 locations
,在使用前缀字符串的 locations
中选择最长匹配的,并将结果进行储存;
- 如果符合带有
=
修饰符的URI,则立刻停止匹配; - 如果符合带有
^~
修饰符的URI,则也立刻停止匹配; - 然后按照定义文件的顺序,检查正则表达式,匹配到就停止;
- 当正则表达式匹配不到的时候,使用之前储存的前缀字符串;
总结:
在顺序上:
- 前缀字符串顺序不重要,按照匹配长度来确定;
- 正则表达式则按照定义顺序;
在 优先级上:
=
修饰符最高,^~
次之,再者是正则
,最后是前缀字符串
匹配。
我们举几个简单的例子进行说明
请求URI如下:
/document
示例一:
配置:
server { location /doc { [ configuration A ] } location /docu { [ configuration B ] } }
匹配结果:
configuration B
注:虽然 /doc
也能匹配到,但 在顺序上,前缀字符串顺序不重要,按照匹配长度来确定。
示例二:
server { location ~ ^/doc { [ configuration A ] } location ~ ^/docu { [ configuration B ] } }
匹配结果:
configuration A
注:虽然 ~ ^/docu
也能匹配到,但 正则表达式则按照定义顺序。
示例三:
server { location ^~ /doc { [ configuration A ] } location ~ ^/docu { [ configuration B ] } }
匹配结果:
configuration A
注:虽然 ~ ^/docu
也能匹配到,但 ^~
的 优先级更高
。
示例四:
server { location /document { [ configuration A ] } location ~ ^/docu { [ configuration B ] } }
匹配结果:
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
;
四、server 和 location 中的 root
server 和 location 中都可以使用 root,举个例子:
server { listen 80; server_name 10.0.7.115; root /data/app/; location / { root /data/web/; index index.html; } }
如果两者都出现,是怎样的优先级呢?
简单的来说,就是 就近原则
,如果 location
中能匹配到,就是用 location
中的 root
配置,忽略 server
中的 root
,当 location
中匹配不到的时候,则使用 server
中的 root
配置。
总结
加载全部内容