Nginx for Windows

提示

来自deepseek解释

原文链接：https://nginx.org/en/docs/windows.html

# nginx for Windows

Windows 版本的 nginx 使用原生 Win32 API（而非 Cygwin 模拟层）。目前仅使用 `select()` 和 `poll()`（1.15.9 版本起）连接处理方法，因此不应期待其具备高性能和可扩展性。由于此问题及其他一些已知问题，Windows 版本的 nginx 被视为测试版。目前，它提供了与 UNIX 版本 nginx 几乎相同的功能，但不包括 XSLT 过滤器、图像过滤器、GeoIP 模块和内嵌 Perl 语言。

要安装 nginx/Windows，请[下载](../download.html)最新的主线版本发行版（1.31.2），因为 nginx 的主线分支包含所有已知修复。然后解压发行版，进入 `nginx-1.31.2` 目录，并运行 `nginx`。以下是在 C 盘根目录下的示例：

```bash
cd c:\
unzip nginx-1.31.2.zip
cd nginx-1.31.2
start nginx

运行 tasklist 命令行工具查看 nginx 进程：

C:\nginx-1.31.2>tasklist /fi "imagename eq nginx.exe"

Image Name                     PID Session Name     Session#    Mem Usage
=============== ======== ============== ========== ============
nginx.exe                      652 Console                 0      2 780 K
nginx.exe                     1332 Console                 0      3 112 K

其中一个进程是主进程，另一个是工作进程。

如果 nginx 未能启动，请查看错误日志文件 logs\error.log 以查找原因。如果日志文件尚未创建，则原因应在 Windows 事件日志中报告。如果显示错误页面而非预期页面，也请在 logs\error.log 文件中查找原因。

nginx/Windows 将运行目录作为配置中相对路径的前缀。在上述示例中，前缀为 C:\nginx-1.31.2\。配置文件中的路径必须使用 UNIX 风格的正斜杠指定：

access_log logs/site.log;
root C:/web/html;

nginx/Windows 作为标准控制台应用程序（而非服务）运行，可使用以下命令进行管理：

• nginx -s stop — 快速关闭
• nginx -s quit — 优雅关闭
• nginx -s reload — 更改配置，使用新配置启动新工作进程，优雅关闭旧工作进程
• nginx -s reopen — 重新打开日志文件

已知问题

• 尽管可以启动多个工作进程，但实际上只有一个进程在工作。
• UDP（以及基于 UDP 的 QUIC）功能不受支持。

可能的未来增强

• 作为服务运行。
• 使用 I/O 完成端口作为连接处理方法。
• 在单个工作进程中使用多个工作线程。