Nginx代理转发请求至后端服务器配置方案-Nginx-PHP中文网

Nginx反向代理核心是location匹配+proxy_pass，需注意末尾斜杠路径重写、X-Forwarded-For透传真实IP、Host头还原；多服务分流用upstream；WebSocket需Upgrade/Connection头；重定向和Cookie需proxy_redirect/proxy_cookie_*修正；生产环境应配置超时、重试、健康检查与独立日志。

nginx代理转发请求至后端服务器配置方案

用 Nginx 做反向代理转发请求到后端服务，核心是 location 匹配 + proxy_pass 指令，同时注意路径重写、请求头透传和连接稳定性等细节。

基础代理配置（带路径匹配）

最常见场景：把 /api/ 开头的请求转给后端 HTTP 服务。

location /api/ {
    proxy_pass http://127.0.0.1:8080/;
    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_pass 后带 / 表示“去掉匹配前缀再拼接”，即 /api/user → 转发为 /user；不带则原样拼接（易出错）
必须设置 X-Forwarded-For，否则后端拿不到真实客户端 IP
Host 头默认会被替换成 upstream 地址，显式设回 $host 可保持原始域名

多后端服务按路径分流

一个 Nginx 同时代理多个内部服务，比如 API、文件服务、管理后台。

upstream api_backend {
    server 192.168.1.10:3000;
    server 192.168.1.11:3000;
}

upstream file_backend {
    server 192.168.1.20:8000;
}

server {
    listen 80;
    server_name example.com;

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

    location /static/ {
        proxy_pass http://file_backend/static/;
    }

    location /admin/ {
        proxy_pass http://127.0.0.1:9000/;
    }
}

用 upstream 块定义后端组，便于负载均衡和故障转移
WebSocket 支持需额外加 Upgrade 和 Connection 头
不同 location 独立配置，互不影响

处理后端返回的重定向与 Cookie

后端返回 302 或 Set-Cookie 中含路径/域名错误，会导致跳转失败或登录态丢失。

重定向地址改写：proxy_redirect http://backend/ https://example.com/; 或用 proxy_redirect default; 自动适配
Cookie 域名修正：proxy_cookie_domain ~.+\.(.+)$ $1; 把子域 Cookie 统一写入主域
Cookie 路径修正：proxy_cookie_path / /myapp/; 把后端设的 / 改成实际访问路径

提升稳定性和可观测性

生产环境建议补充超时、重试、日志和健康检查。

upstream api_backend {
    server 192.168.1.10:3000 max_fails=3 fail_timeout=30s;
    server 192.168.1.11:3000 max_fails=3 fail_timeout=30s;
    keepalive 32;
}

location /api/ {
    proxy_pass http://api_backend/;
    proxy_connect_timeout 5s;
    proxy_send_timeout 30s;
    proxy_read_timeout 30s;
    proxy_next_upstream error timeout http_500 http_502 http_503 http_504;
    proxy_next_upstream_tries 3;

    access_log /var/log/nginx/api_access.log main;
    error_log /var/log/nginx/api_error.log warn;
}