Nginx proxy_pass 使用指南

proxy_pass 是 Nginx 中用于反向代理的核心指令，它允许将客户端的请求转发到后端服务器。以下是详细的使用方法和常见配置示例。

基本语法

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

常见使用场景

1. 基本反向代理

server {
    listen 80;
    server_name example.com;

    location / {
        proxy_pass http://localhost:8080;
    }
}

2. 带URI的proxy_pass

location /api/ {
    # 请求 /api/user 会被转发到 http://backend/api/user
    proxy_pass http://backend;

    # 或者明确指定URI
    # 请求 /api/user 会被转发到 http://backend/internal/user
    # proxy_pass http://backend/internal/;
}

3. 传递原始请求信息

location / {
    proxy_pass http://backend;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
}

4. WebSocket代理

location /ws/ {
    proxy_pass http://websocket_backend;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";
}

5. 负载均衡

upstream backend {
    server backend1.example.com;
    server backend2.example.com;
    server backend3.example.com;
}

server {
    location / {
        proxy_pass http://backend;
    }
}

重要参数配置

location / {
    proxy_pass http://backend;

    # 连接超时设置
    proxy_connect_timeout 5s;
    proxy_send_timeout 10s;
    proxy_read_timeout 30s;

    # 缓冲区设置
    proxy_buffering on;
    proxy_buffer_size 4k;
    proxy_buffers 8 16k;

    # 其他设置
    proxy_redirect off;
    proxy_next_upstream error timeout invalid_header http_500 http_502 http_503 http_504;
}

常见问题解决

1. 502 Bad Gateway错误

   • 检查后端服务是否运行
   • 检查Nginx与后端服务的网络连接
   • 增加proxy_connect_timeout值

2. URL重写问题

   • 确保proxy_pass后的URI部分正确
   • 使用rewrite指令处理复杂重写需求

3. 头部信息丢失

   • 使用proxy_set_header明确传递所需头部

4. 性能问题

   • 调整缓冲区大小
   • 启用keepalive连接

通过合理配置proxy_pass和相关参数，Nginx可以高效地作为反向代理服务器工作，实现请求转发、负载均衡等功能。