梧州市网站建设_网站建设公司_内容更新_seo优化
2026/1/9 23:59:19 网站建设 项目流程
文章目录
    • 1. 基本概念
      • 1.1 `proxy_pass` 概述
      • 1.2 语法
      • 1.3 使用场景
    • 2. 基本用法
      • 2.1 HTTP 代理
        • 2.1.1 基本示例
        • 2.1.2 绝对根路径 vs 相对路径
      • 2.2 Stream 代理
    • 3. 高级用法
      • 3.1 正则匹配
      • 3.2 变量使用
      • 3.3 重定向
      • 3.4 精确匹配
      • 3.5 `if` 语句
      • 3.6 `limit_except`
    • 4. 实际案例
      • 4.1 转发到多个后端服务器
      • 4.2 转发到不同路径
      • 4.3 转发到 Unix Domain Socket

proxy_pass是 Nginx 中一个非常重要的指令,用于将请求代理到后端服务器。本文将详细介绍proxy_pass的基本用法、配置示例以及一些高级用法。

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/; } }

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询