comparison xml/cn/docs/windows.xml @ 558:149f54c158f0

Added initial translation in simplified Chinese submitted by the Server Platforms Team at Taobao.com.
author Ruslan Ermilov <ru@nginx.com>
date Thu, 28 Jun 2012 10:27:07 +0000
parents
children 9934338f83af
comparison
equal deleted inserted replaced
557:654096219aba 558:149f54c158f0
1 <!DOCTYPE article SYSTEM "../../../dtd/article.dtd">
2
3 <article name="nginx Windows版使用说明"
4 link="/cn/docs/windows.html"
5 lang="cn">
6
7
8 <section>
9
10 <para>
11 nginx的Windows版本使用原生Win32 API(非Cygwin模拟层)。当前nginx/Windows只使用<i>select</i>作为通知方法,所以不要期待它有很高的性能和扩展性。鉴于这点和一些已知问题,nginx/Windows目前还处于<i>beta</i>阶段。nginx/Windows和Unix版本相比,功能几乎已经齐全,除了XSLT过滤器、图像过滤器、GeoIP模块和嵌入Perl语言支持以外。
12 </para>
13
14 <para>
15 安装nginx/Windows,需要<link doc="../download.xml">下载</link>最新的<development_version />开发版本,因为开发分支上包含了所有已知的问题修复,尤其是针对Windows版本的问题修复。解压缩下载得到的zip文件,进入nginx-<development_version />目录,运行nginx。下面给出一个在C盘根目录下安装的例子:
16
17 <programlisting>
18 cd c:\
19 unzip nginx-<development_version />.zip
20 cd nginx-<development_version />
21 start nginx
22 </programlisting>
23
24 可以在命令行运行<command>tasklist</command>命令来查看nginx进程:
25
26 <programlisting>
27 C:\nginx-<development_version />&gt;tasklist /fi "imagename eq nginx.exe"
28
29 Image Name PID Session Name Session# Mem Usage
30 =============== ======== ============== ========== ============
31 nginx.exe 652 Console 0 2 780 K
32 nginx.exe 1332 Console 0 3 112 K
33 </programlisting>
34
35 其中一个是主进程,另一个是工作进程。如果nginx没有启动,请查看<path>logs\error.log</path>文件以寻找失败原因。如果日志文件不存在,那失败原因会记录在Windows事件日志中。如果某次请求没有展示预想的页面,而是展示了错误页面,也请查看<path>logs\error.log</path>文件。
36 </para>
37
38 <para>
39 nginx/Windows使用工作目录作为前缀将配置文件中设置的相对目录补齐。就上面安装的例子而言,工作目录应该是<path>C:\nginx-<development_version />\</path>(工作目录基本上与运行文件所在的目录相同)。配置文件中的目录请使用“/”,而不是“\”做目录分隔:
40
41 <programlisting>
42 access_log logs/site.log;
43 root C:/web/html;
44 </programlisting>
45 </para>
46
47 <para>
48 nginx/Windows作为标准控制台应用运行,而不是系统服务。可以用下面的命令控制:
49
50 <table note="yes">
51
52 <tr>
53 <td width="20%">nginx -s stop</td>
54 <td>快速退出</td>
55 </tr>
56
57 <tr>
58 <td>nginx -s quit</td>
59 <td>优雅退出</td>
60 </tr>
61
62 <tr>
63 <td>nginx -s reload</td>
64 <td>
65 更换配置,启动新的工作进程,优雅的关闭以往的工作进程
66 </td>
67 </tr>
68
69 <tr>
70 <td>nginx -s reopen</td>
71 <td>重新打开日志文件</td>
72 </tr>
73
74 </table>
75 </para>
76
77 </section>
78
79 <section id="known_issues"
80 name="已知问题">
81
82 <list type="bullet">
83
84 <listitem>
85 虽然可以启动若干工作进程运行,实际上只有一个进程在处理请求所有请求。
86 </listitem>
87
88 <listitem>
89 一个工作进程只能处理不超过1024个并发连接。
90 </listitem>
91
92 <listitem>
93 缓存和其他需要共享内存支持的模块在Windows Vista及后续版本的操作系统中无法工作,因为在这些操作系统中,地址空间的布局是随机的。
94 </listitem>
95
96 </list>
97
98 </section>
99
100 <section id="possible_future_enhancements"
101 name="日后可能加强的功能">
102
103 <list type="bullet">
104
105 <listitem>
106 作为系统服务运行。
107 </listitem>
108
109 <listitem>
110 使用“I/O完成端口”作为事件模型。
111 </listitem>
112
113 <listitem>
114 使用单工作进程多线程的模型。
115 </listitem>
116
117 </list>
118
119 </section>
120
121 </article>