Nginx的proxy_pass命令使用

更新时间：2026年05月09日 09:56:12 作者：lcrml

,proxy_pass指令用于将请求转发到后端服务器,它可以用于 HTTP 和 Stream 模块,分别处理 HTTP 请求和 TCP/UDP 流量,下面就来详细介绍一下如何使用,感兴趣的可以了解一下

1. 基本概念

1.1proxy_pass概述

proxy_pass 指令用于将请求转发到后端服务器。它可以用于 HTTP 和 Stream 模块，分别处理 HTTP 请求和 TCP/UDP 流量。

1.2 语法

proxy_pass URL;

URL：后端服务器的地址，可以是 HTTP/HTTPS 地址或 TCP/UDP 地址。

1.3 使用场景

HTTP 代理：将 HTTP 请求转发到后端服务器。
Stream 代理：将 TCP/UDP 流量转发到后端服务器。

2. 基本用法

2.1 HTTP 代理

2.1.1 基本示例

server {
    listen 80;
    server_name example.com;

    location / {
        proxy_pass http://backend_server;
    }
}

在这个示例中，所有访问 example.com 的请求都会被转发到 backend_server。

2.1.2 绝对根路径 vs 相对路径

绝对根路径：在 proxy_pass 后面的 URL 以斜杠 / 结束，表示绝对根路径。
```
location /proxy/ {
    proxy_pass http://127.0.0.1/;
}
```
例如，访问 http://example.com/proxy/test.html 会被转发到 http://127.0.0.1/test.html。
相对路径：在 proxy_pass 后面的 URL 不以斜杠 / 结束，表示相对路径。
```
location /proxy/ {
    proxy_pass http://127.0.0.1;
}
```
例如，访问 http://example.com/proxy/test.html 会被转发到 http://127.0.0.1/proxy/test.html。

2.2 Stream 代理

stream {
    upstream backend {
        server 127.0.0.1:8080;
    }

    server {
        listen 12345;
        proxy_pass backend;
    }
}

在这个示例中，所有连接到 12345 端口的 TCP 流量都会被转发到 127.0.0.1:8080。

3. 高级用法

3.1 正则匹配

当 location 使用正则表达式时，proxy_pass 不能包含 URI 部分。

location ~ /testc {
    proxy_pass http://127.0.0.1:8801;
}

如果包含 URI 部分，会导致配置文件解析错误：

location ~ /testd {
    proxy_pass http://127.0.0.1:8801/;  # 错误
}

3.2 变量使用

可以使用变量来动态生成转发地址。

location /novel/ {
    proxy_pass http://book-server/books$request_uri;
}

例如，访问 http://example.com/novel/three-body.html?page=3 会被转发到 http://book-server/books/novel/three-body.html?page=3。

3.3 重定向

Nginx 会在某些情况下自动进行 301 重定向，例如当请求的 URI 没有以斜杠 / 结束，但 Nginx 认为这是一个目录时。

location /films/nature/ {
    proxy_pass http://film-server;
}

如果访问 http://example.com/films/nature，Nginx 会返回 301 重定向到 http://example.com/films/nature/。

3.4 精确匹配

可以使用精确匹配来避免 301 重定向。

location /films/nature/ {
    proxy_pass http://film-server;
}

location = /films/nature {
    proxy_pass http://film-server;
}

3.5if语句

在 location 中使用 if 语句时，proxy_pass 不能包含 URI 部分。

location /google {
    if ($geoip_country_code ~ (RU|CN)) {
        proxy_pass http://www.google.hk;
    }
}

3.6limit_except

在 limit_except 中使用 proxy_pass 时，不能包含 URI 部分。

location /yongfu/ {
    proxy_pass http://unix:/tmp/backend.socket:/uri/;

    limit_except PUT DELETE {
        proxy_pass http://127.0.0.1:9080;
    }
}

4. 实际案例

4.1 转发到多个后端服务器

upstream backend_servers {
    server 192.168.1.10:8080;
    server 192.168.1.11:8080;
    server 192.168.1.12:8080;
}

server {
    listen 80;
    server_name example.com;

    location / {
        proxy_pass http://backend_servers;
    }
}

4.2 转发到不同路径

server {
    listen 80;
    server_name example.com;

    location /api/ {
        proxy_pass http://api_server/;
    }

    location /static/ {
        proxy_pass http://static_server/;
    }
}

4.3 转发到 Unix Domain Socket

server {
    listen 80;
    server_name example.com;

    location / {
        proxy_pass http://unix:/tmp/backend.socket:/uri/;
    }
}

到此这篇关于Nginx的proxy_pass命令使用的文章就介绍到这了,更多相关Nginx proxy_pass 使用内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

您可能感兴趣的文章:

nginx添加ssl模块的方法教程
这篇文章主要给大家介绍了关于nginx添加ssl模块的相关资料，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习许吧。
2017-12-12
Nginx如何配置根据路径转发详解
Nginx是作为一个反向代理,转发,和负载均衡的服务器,也可以用于分布式,下面这篇文章主要给大家介绍了关于Nginx如何配置根据路径转发的相关资料,文中通过实例代码介绍的非常详细,需要的朋友可以参考下
2022-07-07
Nginx 服务器开启status页面检测服务状态的方法
这篇文章主要介绍了Nginx 服务器开启status页面检测服务状态的方法,本文给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友参考下吧
2024-01-01
Nginx proxy_ssl_server_name 解决后端多域名证书匹配失败的方法
本文介绍了Nginx反向代理HTTPS后端时的关键指令proxy_ssl_server_name,当后端托管多域名证书时,Nginx需启用SNI扩展以正确匹配证书,本文详细分析了问题场景、基础解决方案,并提供了进阶配置方案,感兴趣的可以了解一下
2026-04-04
angular6+springboot实现前后分离nginx配置
这篇文章主要介绍了angular6+springboot实现前后分离nginx配置详解，有需要的朋友可以借鉴参考下，希望能够有所帮助，祝大家多多进步，早日升职加薪
2023-06-06
nginx代理本地文件夹如何获取数据
本文介绍了如何在Windows上安装和配置Nginx,包括下载、解压、启动服务以及修改配置文件以实现特定功能,还提供了关于Nginx常用命令的说明,方便用户管理服务
2025-01-01
Nginx实现TCP和UDP代理的方法步骤
Nginx 1.9.13 及以上版本支持TCP/UDP代理功能,通过配置监听端口、后端服务器地址等参数,实现客户端请求的转发和响应的返回,下面就来介绍一下如何实现,感兴趣的可以了解一下
2024-12-12
nginx实现动静分离的方法示例
Nginx的静态处理能力很强,但是动态处理能力不足,因此,在企业中常用动静分离技术，本文就详细的介绍一下如何使用，感兴趣的可以了解一下
2021-11-11
nginx支持带下划线的header实现
如果header name中包含下划线,则忽略掉,本文主要介绍了nginx支持带下划线的header实现,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
2024-08-08
Nginx中间件入门指南
Nginx也是一个web服务器,能够支持正向代理（代理用户去访问服务器）、反向代理（代理服务器来让用户访问）、负载均衡（将用户的访问分发给服务器集群）,这篇文章主要介绍了Nginx中间件入门指南,需要的朋友可以参考下
2025-10-10