nginx proxy_pass转发规则解读

分类： Nginx学习发布时间： 2024-10-05 10:03:58

一、基本语法与概念 proxy_pass指令的基本语法如下： proxy_pass <scheme>://<proxy_host>:<proxy_port>/<path>; <scheme>：代理协议，通常为http或https。 &lt...

在Nginx配置中，proxy_pass指令扮演着至关重要的角色，它实现了请求从Nginx服务器到后端服务器的透明转发。然而，对于初学者来说，理解和掌握proxy_pass的转发规则可能会显得有些复杂。本文将详细解读Nginx中proxy_pass的转发规则，帮助您更好地配置和使用Nginx。

一、基本语法与概念

proxy_pass指令的基本语法如下：

proxy_pass <scheme>://<proxy_host>:<proxy_port>/<path>;

<scheme>：代理协议，通常为http或https。
<proxy_host>：代理服务器地址（IP或域名）。
<proxy_port>：代理服务器端口。
<path>：可选的附加路径，用于进一步指定后端服务器的URL路径。

二、转发规则详解

无附加路径的转发

当proxy_pass指令后仅包含地址和端口，无附加路径时，Nginx将原样转发原始访问URL的完整路径。例如：
```
location / {
   proxy_pass http://backend-server:8080;
}
```
此时，用户访问http://nginx-server/path/to/resource，请求将被转发至http://backend-server:8080/path/to/resource。
带附加路径的转发

当proxy_pass指令后包含附加路径（以/结尾），Nginx将首先根据当前匹配的location规则识别出请求URL中的匹配部分，然后剔除该部分，将剩余路径附加到proxy_pass指定的路径之后。例如：
```
location /v1/ {
   proxy_pass http://backend-server:8080/api/;
}
```
当用户访问http://nginx-server/v1/data时，Nginx会将请求转发至http://backend-server:8080/api/data。

重点内容：带/的附加路径被视为绝对根路径，Nginx会替换掉请求URL中与location匹配的部分。
正则表达式与proxy_pass

当location使用正则表达式时，proxy_pass中不能包含URI部分（除非使用了变量），因为Nginx无法确定如何替换URL。例如：
```
location ~ /tenants/([^/]+)/ {
   proxy_pass https://$gray;
}
```
在此场景下，Nginx会忽略proxy_pass中指定的任何路径，直接转发完整的请求URI。

重点内容：正则表达式location中，proxy_pass不应包含URI部分，除非使用了变量。