nginx的location、root、alias、proxy_pass指令用法和区别

最新推荐文章于 2025-06-08 08:45:00 发布

转载最新推荐文章于 2025-06-08 08:45:00 发布 · 3.6k 阅读

11 ·

CC 4.0 BY-SA版权

原文链接：http://www.nginx.cn/4658.html

nginx 专栏收录该内容

2 篇文章

订阅专栏

本文详细解析了Nginx中的location、root、alias及proxy_pass指令的用法和区别，通过实例展示了这些指令如何影响请求的处理流程，适用于前后端分离和负载均衡场景。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

nginx的location、root、alias、proxy_pass指令用法和区别

[root]
语法：root path
默认值：root html
配置段：http、server、location、if
[alias]
语法：alias path
配置段：location

root与alias主要区别在于nginx如何解释location后面的uri，这会使两者分别以不同的方式将请求映射到服务器文件上。
root的处理结果是：root路径＋location路径
alias的处理结果是：使用alias路径替换location路径
alias是一个目录别名的定义，root则是最上层目录的定义。
还有一个重要的区别是alias后面必须要用“/”结束，否则会找不到文件的。。。而root则可有可无~~

root实例：

location ^~ /t/ {
     root /www/root/html/;
}

如果一个请求的URI是/t/a.html时，web服务器将会返回服务器上的**/www/root/html/t/a.html**的文件。

alias实例：

location ^~ /t/ {
 alias /www/root/html/new_t/;
}

如果一个请求的URI是**/t/a.html时，web服务器将会返回服务器上的/www/root/html/new_t/a.html**的文件。注意这里是new_t，因为alias会把location后面配置的路径丢弃掉，把当前匹配到的目录指向到指定的目录。

注意：

使用alias时，目录名后面一定要加"/"。
alias在使用正则匹配时，必须捕捉要匹配的内容并在指定的内容处使用。
alias只能位于location块中。（root可以不放在location中）

3.【proxy_pass】

反向代理配置，用于代理请求，适用于前后端负载分离或多台机器、服务器负载分离的场景，在匹配到location配置的URL路径后，转发请求到【proxy_pass】配置的URL，是否会附加location配置路径与【proxy_pass】配置的路径后是否有"/“有关，有”/"则不附加，如：

location /test/ 
{ 
proxy_pass http://127.0.0.1:8080/; 
}

即：请求/test/1.jpg（省略了协议与域名），将会被nginx转发请求到http://127.0.0.1:8080/1.jpg（未附加/test/路径）。

location /test/ 
{ 
proxy_pass http://127.0.0.1:8080; 
}

即：请求/test/1.jpg（省略了协议与域名），将会被nginx转发请求到http://127.0.0.1:8080/test/1.jpg（附加/test/路径）。

location /test/ 
{ 
proxy_pass http://127.0.0.1:8080/img; 
}

即：请求/test/1.jpg（省略了协议与域名），将会被nginx转发请求到http://127.0.0.1:8080/img1.jpg（未附加/test/路径，但附加了/test/之后的路径）。