Nginx proxy_pass反向代理配置实例分析

proxy_pass是Nginx中最常用的反向代理指令之一，用于将请求转发到后端服务器。下面我将通过几个典型实例来分析proxy_pass的配置方法。

基本配置格式

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

实例分析

实例1：基本反向代理

server {
    listen 80;
    server_name example.com;

    location / {
        proxy_pass http://127.0.0.1:8080;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
}

说明： - 将所有访问example.com的请求转发到本机的8080端口 - 设置了Host和X-Real-IP请求头，确保后端服务器能获取原始信息

实例2：路径保留与去除

location /api/ {
    # 保留路径前缀
    proxy_pass http://backend/api/;

    # 或者去除路径前缀
    # proxy_pass http://backend/;
}

区别： - 第一种配置会将/api/user转发为http://backend/api/user - 第二种配置会将/api/user转发为http://backend/user

实例3：负载均衡配置

upstream backend {
    server 10.0.0.1:8080;
    server 10.0.0.2:8080;
    server 10.0.0.3:8080;
}

server {
    listen 80;
    server_name example.com;

    location / {
        proxy_pass http://backend;
        proxy_set_header Host $host;
    }
}

说明： - 使用upstream定义后端服务器组 - Nginx会自动在三个服务器间进行负载均衡

实例4：WebSocket代理

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

说明： - 特殊配置支持WebSocket协议 - 需要设置Upgrade和Connection头 - 延长超时时间以保持长连接

实例5：URL重写

location ~ ^/service/(.*) {
    proxy_pass http://backend/$1$is_args$args;
}

说明： - 使用正则表达式匹配路径 - 将/service/后的内容作为参数传递给后端 - $is_args$args保留原始查询参数

常见问题解决

1. 502 Bad Gateway错误

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

2. 404 Not Found错误

   • 检查proxy_pass的URL是否正确
   • 确认路径是否被正确处理（保留或去除前缀）

3. 性能优化建议

   • 启用缓存：proxy_cache
   • 调整缓冲区大小：proxy_buffer_size
   • 开启keepalive：proxy_http_version 1.1; proxy_set_header Connection "";

通过以上实例，您可以根据实际需求灵活配置Nginx的反向代理功能。如需更复杂的配置，可以结合rewrite、if等指令实现更精细的控制。