<!DOCTYPE article SYSTEM "../../../dtd/article.dtd">
<article name="nginx Windows版使用说明"
link="/cn/docs/windows.html"
lang="cn"
rev="1">
<section>
<para>
nginx的Windows版本使用原生Win32 API（非Cygwin模拟层）。当前nginx/Windows只使用<i>select</i>作为通知方法，所以不要期待它有很高的性能和扩展性。鉴于这点和一些已知问题，nginx/Windows目前还处于<i>beta</i>阶段。nginx/Windows和Unix版本相比，功能几乎已经齐全，除了XSLT过滤器、图像过滤器、GeoIP模块和嵌入Perl语言支持以外。
</para>
<para>
安装nginx/Windows，需要<link doc="../download.xml">下载</link>最新的<mainline_version />开发版本，因为开发分支上包含了所有已知的问题修复，尤其是针对Windows版本的问题修复。解压缩下载得到的zip文件，进入nginx-<mainline_version />目录，运行nginx。下面给出一个在C盘根目录下安装的例子：
<programlisting>
cd c:\
unzip nginx-<mainline_version />.zip
cd nginx-<mainline_version />
start nginx
</programlisting>
可以在命令行运行<command>tasklist</command>命令来查看nginx进程：
<programlisting>
C:\nginx-<mainline_version />>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
</programlisting>
其中一个是主进程，另一个是工作进程。如果nginx没有启动，请查看<path>logs\error.log</path>文件以寻找失败原因。如果日志文件不存在，那失败原因会记录在Windows事件日志中。如果某次请求没有展示预想的页面，而是展示了错误页面，也请查看<path>logs\error.log</path>文件。
</para>
<para>
nginx/Windows使用工作目录作为前缀将配置文件中设置的相对目录补齐。就上面安装的例子而言，工作目录应该是<path>C:\nginx-<mainline_version />\</path>（工作目录基本上与运行文件所在的目录相同）。配置文件中的目录请使用“/”，而不是“\”做目录分隔：
<programlisting>
access_log logs/site.log;
root C:/web/html;
</programlisting>
</para>
<para>
nginx/Windows作为标准控制台应用运行，而不是系统服务。可以用下面的命令控制：
<table note="yes">
<tr>
<td width="20%">nginx -s stop</td>
<td>快速退出</td>
</tr>
<tr>
<td>nginx -s quit</td>
<td>优雅退出</td>
</tr>
<tr>
<td>nginx -s reload</td>
<td>
更换配置，启动新的工作进程，优雅的关闭以往的工作进程
</td>
</tr>
<tr>
<td>nginx -s reopen</td>
<td>重新打开日志文件</td>
</tr>
</table>
</para>
</section>
<section id="known_issues"
name="已知问题">
<list type="bullet">
<listitem>
虽然可以启动若干工作进程运行，实际上只有一个进程在处理请求所有请求。
</listitem>
<listitem>
一个工作进程只能处理不超过1024个并发连接。
</listitem>
<listitem>
缓存和其他需要共享内存支持的模块在Windows Vista及后续版本的操作系统中无法工作，因为在这些操作系统中，地址空间的布局是随机的。
</listitem>
</list>
</section>
<section id="possible_future_enhancements"
name="日后可能加强的功能">
<list type="bullet">
<listitem>
作为系统服务运行。
</listitem>
<listitem>
使用“I/O完成端口”作为事件模型。
</listitem>
<listitem>
使用单工作进程多线程的模型。
</listitem>
</list>
</section>
</article>
