文章目录
- 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/; } }