1. 为什么要在Windows环境折腾Nginx
很多人在Windows下装Nginx,第一反应是“这不是Linux服务器上用的东西吗?”。这话没毛病,但实际开发场景里,Windows下的Nginx用处比想象中大得多。我自己最早接触Nginx就是从Windows版开始的——当时前端同事把打包好的静态资源丢过来,说要跟后端接口联调,可线上服务器不能随便改配置,手上又只有一台Windows开发机,那怎么办?装个Windows版Nginx做反向代理,把 /api 请求转发到测试服务器,把静态文件直接指向本地目录,十分钟搞定。从那以后,Windows版Nginx就成了我开发机上的常驻工具。
1.1 哪些场景真的需要Windows版Nginx
我总结下来,Windows下用Nginx主要就这几类需求,你看看自己属于哪一类:
- 本地前端联调:前端项目本地起了一个开发服务器(比如Vite默认的5173端口),但后端接口在另一台机器上,有跨域问题。用Nginx监听80端口,把静态页面和接口请求统一走同一个域名转发,完美避开跨域。
- 静态资源服务器:项目做完了要给产品看效果,不想每次
npm run build完都压缩发给人家。直接把打包后的dist目录交给Nginx托管,同一个局域网内别人就能通过你电脑的IP访问。 - 端口转发和负载均衡实验:Windows开发机上起了多个后端服务(比如Spring Boot的8080、Python的8000),想用统一入口访问,或者想模拟多台后端服务器做负载均衡测试。Nginx一套配置就能搞定。
- 学习Nginx本身:你想学Nginx的配置语法、反向代理、缓存策略,但手头没有Linux服务器,也不想为了练手去开一台云主机。Windows下先跑起来,把配置文件玩明白,以后再上Linux就顺理成章了。
上面这些场景如果你中了一两条,那Windows版Nginx就是今天要装的东西。
1.2 Windows版和Linux版的差异点
坦白讲,Nginx官方对Windows平台的支持是“尽力而为”的,它不是Nginx的主战场。官方文档里明确写了一些Windows版的限制,我挑几个影响比较大的说:
- 性能上限:Windows版Nginx基于原生Win32 API实现,不是像Cygwin那样的模拟层。但Windows下单个worker能扛的并发连接数远不如Linux,官方说法是“生产环境下不推荐在Windows上使用”。如果你只是本地开发测试,这个限制完全无感。
- worker_processes配置:Windows版的
worker_processes只支持一个,你写worker_processes 4;实际也只会跑一个worker进程。这一点后面具体配置时还要细说。 - 不支持某些高级功能:比如
epoll事件模型(Windows用select)、sendfile的高效模式、aio异步IO等。这些都不影响基本使用。 - 路径写法不同:配置里的路径分隔符要用
/或\\,反斜杠要转义,这个坑会让很多新手卡住。
但这些差异都不妨碍你在Windows下把Nginx跑起来、完成开发联调。说白了,Windows版Nginx定位是“开发利器”,不是“生产堡垒”,搞清楚定位就不会对它有不切实际的期待。
1.3 选版本的一个坑:Stable还是Mainline
去Nginx官网下载页面,会看到两个版本入口:Stable version(稳定版)和 Mainline version(主线版)。新手很容易纠结选哪个,我直接给结论:
日常本地使用,选Stable稳定版就够了。
主线版会领先一些新功能,但更新频率高,配置文件格式偶尔有变化;稳定版经过更长时间的验证,社区里搜到的问题解决方案也基本匹配稳定版。本地用没必要追新,稳定版省心。
另外说一下 .zip 和 .msi 两种包的区别。官网Windows版下载给的是 .zip 压缩包,解压即用。.msi 是第三方机构封装的安装包(比如Nginx官网页面上会跳转到第三方站点),它会帮你注册Windows服务、写注册表,但它不是官方直接维护的,版本可能滞后。我的建议是:用官方 .zip 包手动解压安装,后面想注册成自启动服务,再手动用工具注册,全程都清楚自己装了什么。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 下载、解压、目录结构:Windows下的第一步
下载这块没什么好花哨的,直接到 nginx.org/en/download.html,找Stable版本那一栏,点 nginx-1.26.x.zip 下载。下载完的东西只是一个不到2MB的压缩包,这里面就是整个Nginx了。
2.1 解压位置选择
解压位置看起来是小事,实际上有讲究。我不建议直接解压到 C:\Users\用户名\Downloads\ 或者桌面这种地方,因为后面你要经常进到Nginx目录里操作,路径越简单越好。
我习惯的做法是解压到磁盘根目录下,比如:
code复制C:\nginx-1.26.2\
注意两点。第一,路径中不要出现中文和空格。Nginx本身能处理一部分,但配置文件里写路径、命令行里敲命令的时候,中英文切换和空格转义都会带来不必要的麻烦。第二,解压后目录名建议去掉版本号。直接把 nginx-1.26.2 改成 nginx,这样以后升级版本时可以把新版解压到同路径,配置文件不用改。如果目录名带版本号,配置文件里引用的 html、logs 相对路径倒是没影响,但自己手动操作时容易记混。
2.2 目录结构速览
解压完打开目录,里面应该长这样:
conf\:所有配置文件都在这里,最主要的是 `nginx.con
