我要评论很多同学第一次写配置时，常常把这两个混用，导致请求路径解析错误，文件 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. 对比总结
| 特性 | root | alias |
|---|---|---|
| 作用方式 | 拼接请求路径 | 替换 location 前缀 |
| 最终路径 | root + location + 请求剩余路径 | alias + 请求去掉 location 部分 |
| 常见用途 | 整个站点的根目录 | 单独路径映射到特殊目录 |
| 常见错误 | 多拼一层目录 | 忘记在路径后加 / |
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区别内容请搜索代码网以前的文章或继续浏览下面的相关文章希望大家以后多多支持代码网！
发表评论