nginx中alias和root的区别详解

更新时间：2026年01月19日 11:01:17 作者：新节

本文详细讲解了Nginx配置中root和alias的区别与使用场景,root会将请求路径拼接到指定目录后,而alias会替换location匹配的前缀路径,下面就来详细的介绍一下两者的区别,感兴趣的可以了解一下

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区别内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

您可能感兴趣的文章:

ELK收集Nginx日志的项目实战
本文主要介绍了ELK收集Nginx日志的项目实战，文中通过示例代码介绍的非常详细，具有一定的参考价值，感兴趣的小伙伴们可以参考一下
2022-05-05
记录一次nginx启动失败的解决过程
小编最近遇到这样一个问题docker nginx起不来了，导致jira域名映射失败，如何解决呢？下面小编给大家分享下nginx启动失败的解决过程，感兴趣的朋友一起看看吧
2022-02-02
利用Nginx_geo模块实现CDN调度的配置方法
今天小编就为大家分享一篇利用Nginx_geo模块实现CDN调度的配置方法，具有很好的参考价值，希望对大家有所帮助。一起跟随小编过来看看吧
2019-08-08
Nginx服务器https配置的方法示例
这篇文章主要介绍了Nginx服务器https配置的方法示例，小编觉得挺不错的，现在分享给大家，也给大家做个参考。一起跟随小编过来看看吧
2018-10-10
Nginx缓存Cache的配置方案以及相关内存占用问题解决
这篇文章主要介绍了Nginx缓存Cache的配置方案以及相关内存占用问题解决,Cashe配置最主要的还是需要注意内存资源的使用问题,需要的朋友可以参考下
2016-01-01
Linux下安装nginx的实现方法
这篇文章主要介绍了Linux下安装nginx的实现方法，小编觉得挺不错的，现在分享给大家，也给大家做个参考。一起跟随小编过来看看吧
2019-04-04
nginx正向代理http和https的实现步骤
本文主要介绍了nginx正向代理http和https的实现步骤，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧
2023-07-07
解决Nginx启动报错Job for nginx.service failed
Nginx启动报错,需检查配置文件是否正确（执行nginx -t）,若错误则修正并重载,若80端口被占用,查进程并终止,重启服务以解决
2025-08-08
Nginx纯配置实现日志实时上报的思路与方法
在很多时候我们都需要在页面上实时查看nginx的日志输出,所以下面这篇文章主要给大家介绍了关于Nginx纯配置实现日志实时上报的思路与方法,需要的朋友可以参考下
2021-12-12
Nginx转发鉴权全过程
这篇文章主要介绍了Nginx转发鉴权全过程,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
2025-06-06