nginx中alias和root的区别详解

很多同学第一次写配置时，常常把这两个混用，导致请求路径解析错误，文件 404。本文就来详细讲解 root 与 alias 的区别，并通过案例帮你彻底搞懂。

1. 基本概念

• root：将 请求路径 拼接到 root 指定的目录下。
• alias：将 location 匹配到的路径前缀 替换为 alias 指定的目录。

一句话总结： 👉 root 是 拼接路径，alias 是 路径替换。

2.root示例

location /static/ {
    root /var/www/html;
}

请求：

http://example.com/static/logo.png

nginx 的解析过程：

root = /var/www/html
location 匹配 /static/
请求路径 = /static/logo.png

最终文件路径 = /var/www/html/static/logo.png

✅ 注意：/static/ 仍然会拼接到 root 后面。

3.alias示例

location /static/ {
    alias /var/www/images/;
}

请求：

http://example.com/static/logo.png

nginx 的解析过程：

alias = /var/www/images/
location 匹配 /static/
去掉 /static/，剩下 /logo.png

最终文件路径 = /var/www/images/logo.png

✅ 注意：/static/ 被完全替换成了 /var/www/images/。

4. 最常见的坑

很多人会这样写：

location /static/ {
    root /var/www/images/;
}

然后请求：

http://example.com/static/logo.png

nginx 实际解析：

最终路径 = /var/www/images/static/logo.png  ❌

因为 root 会把 location 前缀 /static/ 拼接到后面。正确写法应该是：

location /static/ {
    alias /var/www/images/;
}

这样路径才是：

/var/www/images/logo.png ✅

5. 对比总结

6. 推荐使用场景

• 适合用 root

  • 配置整个站点根目录：

    server {
        root /var/www/html;
        location / {
            index index.html;
        }
    }
    

• 适合用 alias

  • 配置子路径资源映射：

    location /static/ {
        alias /var/www/project/static/;
    }
    

7. 总结

• root = 拼接路径，常用于全局网站目录。
• alias = 替换路径，常用于某个子路径单独映射。
• 如果要把 /static/ url 对应到 /var/www/images/ 目录，记得用 alias。
• 如果要整个站点都从 /var/www/html 提供，记得用 root。

👉 口诀：

root 拼接，alias 替换。

到此这篇关于nginx中alias和root的区别详解的文章就介绍到这了,更多相关nginx alias和root区别内容请搜索代码网以前的文章或继续浏览下面的相关文章希望大家以后多多支持代码网！