Nginx反向代理配置指南

基本反向代理配置

要配置Nginx作为反向代理，主要使用proxy_pass指令。以下是一个基本配置示例：

server {
    listen 80;
    server_name example.com;

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

常见配置参数

1. 代理头信息

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;

2. 连接超时设置

proxy_connect_timeout 60s;
proxy_send_timeout 60s;
proxy_read_timeout 60s;

3. 缓冲区设置

proxy_buffering on;
proxy_buffer_size 4k;
proxy_buffers 8 16k;
proxy_busy_buffers_size 24k;
proxy_max_temp_file_size 0;

高级配置示例

1. 负载均衡

upstream backend {
    server backend1.example.com weight=5;
    server backend2.example.com;
    server backend3.example.com;

    # 负载均衡方法
    # least_conn; # 最少连接
    # ip_hash;   # IP哈希
}

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

2. WebSocket代理

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

3. SSL终止

server {
    listen 443 ssl;
    server_name example.com;

    ssl_certificate /path/to/cert.pem;
    ssl_certificate_key /path/to/key.pem;

    location / {
        proxy_pass http://backend;
        proxy_set_header X-Forwarded-Proto https;
    }
}

常见问题解决

1. 502 Bad Gateway错误

   • 检查后端服务是否运行
   • 检查防火墙设置
   • 增加proxy_connect_timeout值

2. 代理后获取真实客户端IP

   • 确保设置了X-Real-IP和X-Forwarded-For头
   • 后端应用需要配置信任这些头

3. 性能优化

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

4. 重定向问题

   • 设置proxy_redirect指令
   • 确保Host头正确传递

调试技巧

1. 检查Nginx错误日志：

   tail -f /var/log/nginx/error.log
   

2. 检查代理头是否传递正确：

   add_header X-Debug-Proxy-Pass $proxy_host;
   add_header X-Debug-Real-IP $remote_addr;
   

3. 使用curl测试：

   curl -v http://your-nginx-server -H "Host: example.com"
   

希望这些信息能帮助你配置Nginx反向代理。如果有更具体的需求或问题，请提供更多细节。