论坛 › linux › 详解nginx的root与alias

张国伟 发表于 2024-6-11 12:50:21

详解nginx的root与alias

nginx版本: 1.18.0
1. 结论

location掷中后
假如是root，会把哀求url的 ip/域名+port替换为root指定的目次，访问资源
假如是alias，会把哀求url的ip/域名+port+匹配到的路径替换为alias指定的目次，访问资源
2. 详解root

2.1 基本用法

以哀求http://example.com/foo/bar/hello.html 为例，location配置如下
location /foo {
    root /home/hfy/;
}
匹配到/foo，url的域名+port替换为root指定的目次，即url中的examp.com被替换为了/home/hfy，所以实际访问的路径为/home/hfy/foo/bar/hello.html
为了更好理解，再来一个例子，哀求的url不变，location配置更改为
location /foo/bar {
    root /home/hfy/;
}
匹配到/foo/bar，url的域名+port替换为root指定的目次，即url中的examp.com被替换为了/home/hfy，所以实际访问的路径仍旧为/home/hfy/foo/bar/hello.html。root在替换时不会替换匹配到的路径。
2.2 location的最左匹配原则

location会从url最左边的路径匹配，假如同等则掷中该location。只有中央匹配到不会掷中。
比如哀求的url为http://example.com/foo/bar/hello.html ，location为
location /bar {
    root /home/hfy/;
}
不会掷中该location，因为从url中的/foo开始匹配，与location /bar不同等，不会掷中，假如url更改为http://example.com/bar/hello.html 才会掷中该规则
2.3 index

在location内部其实默认配置了一条规则index index.html，补全后的规则如下
location /foo {
    root /home/hfy/;
    index index.html;
}
假设我们访问的url为http://example.com/foo/bar ，匹配到/foo，实际访问的路径为/home/hfy/foo/bar。假如我们的bar是一个文件夹，其中假如包含index.html文件，则会把该文件返回。所以index的作用是，当实际访问的是一个目次时，会返回该目次中index指定的文件，假如该目次中不存在index指定的文件，则会返回403。
在访问http://example.com/foo/bar ，时我们打开浏览器的控制台，查看发送的哀求，会发现发生了一个301重定向，http://example.com/foo/bar 被重定向为http://example.com/foo/bar/ ，由此引发了新的问题，为什么会发生重定向，url末尾的/，location 匹配路径末尾的/，以及root 指定目次末尾的/都表示什么意思
2.4 nginx location剖析url工作流程

颠末我的多次测试，发现剖析url工作流程图如下
https://img-blog.csdnimg.cn/bea9508cc8b94ad9807c490e217cabd9.jpeg
上述的工作流程，假设了url末尾没有加/，假如末尾包含/，剖析流程为上图中绿色部门。比方url为http://example.com/foo/ ，假如foo不存在大概是文件，则直接返回404，假如是foo是目次，则进入到绿色部门流程。假如foo目次中存在index指定的文件，则返回该文件。假如不存在返回403。从这个例子可以看出，url末尾加/表示要访问一个目次，假如实际是个文件，nginx会返回404。
根据上述的流程图，我们看一下2.3中的重定向问题，在访问http://example.com/foo/bar 为什么发生了301重定向。
首先掷中如下规则
location /foo {
    root /home/hfy/;
    index index.html;
}
根据上述的流程图，先替换域名+port，实际访问的路径为/home/hfy/foo/bar，然后nginx发现bar不是文件而是个目次(文件夹)，所以重定向为了http://example.com/foo/bar/ 访问bar这个目次中的index.html文件
2.5 末尾’/’

然后再看一下2.3中的另一个问题，末尾的/分别是什么含义
事先声明，仅是我个人粗浅的理解，根据对不同情况的测试，尝试总结 '/'的含义


[*]url末尾/的含义
http://example.com/foo/bar 表示我们把bar当成一个文件，想要访问bar文件
http://example.com/foo/bar/ 表示我们把bar当成一个目次，想要访问bar目次下index指定的文件


[*]location 匹配路径末尾/的含义
location /foo {
    root /home/hfy/;
    index index.html;
}
/foo 既能匹配http://example.com/foo 也能匹配 http://example.com/foo/
location /foo/ {
    root /home/hfy/;
    index index.html;
}
/foo/只能匹配http://example.com/foo/


[*]root 指定目次末尾/的含义
location /foo {
    root /home/hfy/;
    index index.html;
}
/home/hfy 表示把hfy当成目次大概文件
/home/hfy/ 表示只把hfy当成目次
root后面指定的都应该是目次 (不外alias有种特别情况，后面会提到)
对于这三个斜杠，在实践中可以有如下使用方案

[*]url末尾不加/，假如需要带/时依赖nginx自动帮我们重定向加/
[*]location 路径不加/，这样末尾有无/的url都能匹配到
[*]root大概alias指定的目次后面加/，明确表示root指定的是目次，增强配置的可读性
3. 详解alias

3.1 基本用法

以哀求http://example.com/foo/bar/hello.html为例，location配置如下
location /foo {
    alias /home/hfy/;
}
匹配到/foo，url的ip/域名+port+匹配到的路径替换为alias指定的目次，即url中的example.com/foo被替换为了/home/hfy，所以实际访问的路径为/home/hfy/bar/hello.html
同样再来一个例子，哀求的url不变，假如location配置更改为
location /foo/bar {
    alias /home/hfy/;
}
匹配到/foo/bar，url的ip/域名+port+匹配到的路径替换为alias指定的目次，即url中的example.com/foo/bar被替换为了/home/hfy，所以实际访问的路径为/home/hfy/hello.html。alias在替换时会替换匹配到的路径。
alias其余特性，最左匹配、index、location剖析url工作流程、末尾’/'与root同等。
4. 特别情况

4.1 alias指定文件



[*]case 1
url http://example.com/foo
/home/hfy/foo是一个文件
location配置如下
location /foo {
    alias /home/hfy/foo;
}
实际访问路径/home/hfy/foo，nginx返回foo文件。
这就是上面说的特例，alias也可以指定文件，并且正常返回了要访问的文件。但是实际一般不会用alias指定文件。


[*]case 2
url http://example.com/foo
/home/hfy/foo是一个文件
location配置如下
location /foo {
    alias /home/hfy/foo/;
}
实际访问路径/home/hfy/foo，alias指定 /home/hfy/foo/是一个目次，而foo是一个文件，返回404。


[*]case 3
url http://example.com/foo/
/home/hfy/foo是一个文件
location配置如下
location /foo/ {
    alias /home/hfy/foo;
}
实际访问路径/home/hfy/foo/要访问目次，alias指定/home/hfy/foo是目次或文件，而foo是一个文件，返回了500。


[*]case 4
url http://example.com/foo/
/home/hfy/foo是一个文件
location配置如下
location /foo/ {
    alias /home/hfy/foo/;
}
实际访问路径/home/hfy/foo/，alias指定/home/hfy/foo/是一个目次，而foo是一个文件，返回了404。


[*]case 5
url http://example.com/
/home/hfy/foo是一个文件
location配置如下
location / {
    alias /home/hfy/foo;
}
实际访问路径/home/hfy/foo，但是返回了500。


[*]case 6
url http://example.com/
/home/hfy/foo是一个文件
location配置如下
location / {
    alias /home/hfy/foo/;
}
实际访问路径/home/hfy/foo，返回404。
4.2 root指定文件



[*]case 1
url http://example.com/foo
/home/hfy/foo是一个文件
location配置如下
location /foo {
    root /home/hfy/foo;
}
实际访问路径/home/hfy/foo/foo，不存在，返回404。


[*]case 2
url http://example.com/foo
/home/hfy/foo是一个文件
location配置如下
location /foo {
    root /home/hfy/;
}
实际访问路径/home/hfy/foo，返回foo文件。


[*]case 3
url http://example.com/foo/
/home/hfy/foo是一个文件
location配置如下
location /foo {
    root /home/hfy/;
}
或
location配置如下
location /foo/ {
    root /home/hfy/;
}
实际访问路径/home/hfy/foo/要访问目次，/home/hfy/foo是文件，返回404。


[*]case 4
url http://example.com/
/home/hfy/foo是一个文件
location配置如下
location / {
    root /home/hfy/foo;
}
实际访问路径/home/hfy/foo，foo是一个文件，但是却返回404。


[*]case 5
url http://example.com/
/home/hfy/foo是一个文件
location配置如下
location / {
    root /home/hfy/foo/;
}
实际访问路径/home/hfy/foo，foo是一个文件，但是却返回404。

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。

查看完整版本: 详解nginx的root与alias