# proxy\_pass
**proxy\_pass**指令用来**设置被代理服务器的地址，可以是主机名称、IP地址加端口号等形式**。其语法结构为：
```nginx
proxy_pass URL;
```
其中，**URL**为**要设置的被代理服务器的地址，包含传输协议、主机名称或IP地址加端口号、****URI****等要素**。传输协议通常是“http”或者“https”，同时还接受以“unix”开始的UNIX-domain套接字路径。例如：
```nginx
proxy_pass http://www.myweb.name/uri;
proxy_pass http://localhost:8000/uri/;
proxy_pass http://unix:/tmp/backend.socket:/uri/;
```
## upstream
**如果被代理服务器是一组服务器的话，可以使用****upstream****指令配置后端服务器组**。例如：
```nginx
…
upstream proxy_svrs #配置后端服务器组
{
server http://192.168.1.1:8001/uri/;
server http://192.168.1.2:8001/uri/;
server http://192.168.1.3:8001/uri/;
}
server
{
…
listen 80;
server_name www.myweb.name;
location /
{
proxy_pass proxy_svrs; #使用服务器组的名称
}
}
```
在上例中，**在组内的各个服务器中都指明了传输协议“http\://”，而在proxy\_pass指令中就不再需要指明了**。如果现在将upstream指令的配置改为：
```nginx
upstream proxy_svrs
{
server 192.168.1.1:8001/uri/;
server 192.168.1.2:8001/uri/;
server 192.168.1.3:8001/uri/;
}
```
我们就需要在proxy\_pass指令中指明传输协议“http\://”：
```nginx
proxy_pass http://proxy_svrs;
```
## **URL中是否包含有URI，Nginx服务器的处理方式是不同的**
在使用该指令的过程中要注意，**URL中是否包含有URI，Nginx服务器的处理方式是不同的**。
* **如果URL中不包含URI，Nginx服务器不会改变原地址的URI**；
* 但是**如果包含了URI，Nginx服务器将会使用新的URI替代原来的URI**。
```nginx
…
server
{
…
listen 80;
server_name www.myweb.name;
location /server/
{
…
proxy_pass http://192.168.1.1;
}
}
```
在上面的Nginx配置片段中，如果客户端使用“\*\*
再来看下面的Nginx配置片段：
```nginx
…
server
{
…
listen 80;
server_name www.myweb.name;
location /server/
{
…
proxy_pass http://192.168.1.1/loc/;
}
}
```
在该配置实例中，**proxy\_pass指令的URL包含了URI“/loc/”**。如果客户端仍然使用“**. myweb.name/server/**”发起请求，Nginx服务器将会把地址转向“\*\*
通过上面的实例，可以总结出，**在使用proxy\_pass指令时，如果不想改变原地址中的URI，就不要在URL变量中配置URI。**
{% hint style="success" %}
```nginx
…
server
{
…
listen 80;
server_name www.myweb.name;
location / #注意location的uri变量
{
…
#配置1： proxy_pass http://192.168.1.1;
#配置2： proxy_pass http://192.168.1.1/;
}
}
```
**在该配置中，location块使用“/”作为uri变量的值来匹配不包含URI的请求URL。由于请求URL中不包含URI，因此配置1和配置2的效果是一样的**。
比如，客户端的请求URL为“
```nginx
…
server
{
…
listen 80;
server_name www.myweb.name;
location /server/ #注意location的uri变量
{
…
#配置1： proxy_pass http://192.168.1.1;
#配置2： proxy_pass http://192.168.1.1/;
}
}
```
**在该配置中，location块使用“/server/”作为uri变量的值来匹配包含URI “/server/” 的请求URL。**这时，使用配置1和配置2的转向结果就不相同了。
* 使用配置1的时候，proxy\_pass指令中的URL变量不包含URI，Nginx服务器将不改变原地址的URI；
* 使用配置2的时候，proxy\_pass指令中的URL变量包含URI “/”，Nginx服务器会将原地址的URI替换为“/”。
比如，客户端的请求URL为“
* **使用配置1的时候，转向的URL为“ “/server/”未被改变；**
* **但使用配置2时，转向的URL为“ “/server/”被替换为“/”。**
{% endhint %}
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://bohans.gitbook.io/devops/ngnix/ji-chu-zhi-shi/4.-nginx-fu-wu-qi-de-dai-li-fu-wu/4.3-nginx-fu-wu-qi-de-fan-xiang-dai-li-fu-wu/fan-xiang-dai-li-de-ji-ben-she-zhi-de-21-ge-zhi-ling/proxy_pass.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.