Nginx 的 proxy_pass 使用简介

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

1. 基本概念

1.1 proxy_pass 概述

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

1.2 语法

nginx 复制代码
proxy_pass URL;
  • URL:后端服务器的地址,可以是 HTTP/HTTPS 地址或 TCP/UDP 地址。

1.3 使用场景

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

2. 基本用法

2.1 HTTP 代理

2.1.1 基本示例
nginx 复制代码
server {
    listen 80;
    server_name example.com;

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

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

2.1.2 绝对根路径 vs 相对路径
  • 绝对根路径 :在 proxy_pass 后面的 URL 以斜杠 / 结束,表示绝对根路径。

    nginx 复制代码
    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 不以斜杠 / 结束,表示相对路径。

    nginx 复制代码
    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 代理

nginx 复制代码
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 部分。

nginx 复制代码
location ~ /testc {
    proxy_pass http://127.0.0.1:8801;
}

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

nginx 复制代码
location ~ /testd {
    proxy_pass http://127.0.0.1:8801/;  # 错误
}

3.2 变量使用

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

nginx 复制代码
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 认为这是一个目录时。

nginx 复制代码
location /films/nature/ {
    proxy_pass http://film-server;
}

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

3.4 精确匹配

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

nginx 复制代码
location /films/nature/ {
    proxy_pass http://film-server;
}

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

3.5 if 语句

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

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

3.6 limit_except

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

nginx 复制代码
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 转发到多个后端服务器

nginx 复制代码
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 转发到不同路径

nginx 复制代码
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

nginx 复制代码
server {
    listen 80;
    server_name example.com;

    location / {
        proxy_pass http://unix:/tmp/backend.socket:/uri/;
    }
}
相关推荐
心灵宝贝1 小时前
CentOS 7 安装 bzip2-libs-1.0.6-13.el7.x86_64.rpm 的详细步骤
linux·运维·centos
九皇叔叔3 小时前
Linux Shell 函数:从定义到实战,让脚本更高效
linux·运维·chrome·shell
isyangli_blog6 小时前
(6)数据中心、台式(塔式)服务器、机架式服务器、刀片式服务器
运维·服务器
tq026 小时前
Cookie和Seeion在客户端和服务端的角色作用
运维·服务器·安全
Miki Makimura7 小时前
Reactor 模式实现:从 epoll 到高并发调试
运维·服务器·c++·学习
00后程序员张8 小时前
【Python】基于 PyQt6 和 Conda 的 PyInstaller 打包工具
运维·服务器·数据库
❀͜͡傀儡师8 小时前
使用docker 安装dragonfly带配置文件(x86和arm)版本
运维·docker·容器
乐迪信息10 小时前
乐迪信息:智慧煤矿输送带安全如何保障?AI摄像机全天候识别
大数据·运维·人工智能·安全·自动化·视觉检测
7hhhhhhh10 小时前
驱动开发-Linux启动
运维·服务器
Mr. Cao code12 小时前
Dockerfile 指令详解与实战指南
linux·运维·ubuntu·docker·容器