
nginx Windows 版入门静态站点、反向代理与联调跨域三套配置模板nginx 是全球占有率最高的 Web 服务器与反向代理2-clause BSD 协议官方 Windows zip 解压即用。别被「生产环境请用 Linux」劝退——本地开发调试、内网服务、给前端联调做转发Windows 版足够顺手。本文基于官方稳定版 1.30.5stable 分支把启动验证和三套最常用配置模板一次讲清。一、启动与验证解压到无中文无空格的路径如C:\nginx然后start nginx :: 验证浏览器打开 http://localhost 出现 Welcome 页 :: 任务管理器应看到两个 nginx 进程master worker nginx -s stop记住三条命令就够日常用nginx -t检查语法、nginx -s reload重载配置、nginx -s stop停止。80 端口被占用时用netstat -ano | findstr :80找出占用进程常见是 IIS 或系统服务。二、三套配置模板1. 静态站点server { listen 80; root html/mysite; index index.html; }2. 反向代理后端 APIlocation /api/ { proxy_pass http://127.0.0.1:8080/; proxy_set_header Host $host; }注意proxy_pass末尾斜杠的语义带斜杠会去掉/api/前缀再转发不带则原样拼接——联调时 404 多半出在这里。3. 前端联调跨域转发location / { proxy_pass http://localhost:5173; }前端 Vite 起在 5173、后端在 8080 时用 nginx 把两个源统一到一个入口下跨域问题直接消失。三、Windows 版注意事项事项说明worker 进程数建议 1~2Windows IO 模型效率低于 Linux勿照抄 Linux 调优参数路径分隔符配置里一律用/多站点conf 下复制 server{} 块用不同 server_name 或端口日志排错error.log403 多为权限/根目录错502 是后端没起开机自启任务计划程序登录时运行 start nginx或用 NSSM 注册服务改完任何配置先nginx -t再nginx -s reload这是唯一要养成的习惯。 本文对应的完整安装包与图文配置教程已整理上传点击查看资源包