Windows下Nginx反向代理upstream模块配置教程-Nginx-PHP中文网

Windows下用Nginx做反向代理需正确配置upstream模块和proxy_pass指令：先确认Nginx正常运行，再在http块中定义upstream后端组，接着在server块中通过proxy_pass引用并设置请求头，最后重载配置验证。

windows下nginx反向代理upstream模块配置教程

在 Windows 下用 Nginx 做反向代理，核心就是正确配置 upstream 模块和 proxy_pass 指令。它不依赖额外编译，开箱即用，关键是路径、端口、语法不能出错。

一、确认 Nginx 已正常运行

下载官方 Windows 版（推荐 nginx.org 的 zip 包），解压后双击 nginx.exe 启动。打开浏览器访问 http://localhost，看到 “Welcome to nginx!” 页面说明基础服务已就绪。

若启动失败，常见原因有：

端口被占用（默认 80）→ 修改 conf/nginx.conf 中的 listen 80
中文路径或空格 → 解压路径避免含中文、空格、特殊符号
防火墙拦截 → 临时关闭测试，或放行对应端口

二、配置 upstream 定义后端服务组

在 conf/nginx.conf 的 http 块内（通常在 server 块上方）添加 upstream 块，例如：

upstream backend_api {
    server 127.0.0.1:3000;
    server 127.0.0.1:3001 backup;
}

说明：

backend_api 是自定义名称，后续在 proxy_pass 中引用
支持多个 server，可加 weight=2 控制权重，max_fails=3 fail_timeout=30s 设置健康检查
backup 表示仅当其他节点全不可用时才启用
Windows 下不支持 Unix socket（如 unix:/path/to.sock），只用 IP:端口

三、在 server 块中启用反向代理

修改默认 server 块（或新增一个），将请求转发到 upstream：

server {
    listen       8080;
    server_name  localhost;

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

    location / {
        root   html;
        index  index.html;
    }
}

关键点：

proxy_pass 后必须跟 http:// 协议头 + upstream 名称（不能写成 http://127.0.0.1:3000，否则 upstream 失效）
注意末尾斜杠：proxy_pass http://backend_api/（带/）会剥离 /api/ 再转发；不带则原样传递
proxy_set_header 确保后端能获取真实客户端 IP 和域名