Mercurial > hg > nginx-site

comparison xml/ru/docs/windows.xml @ 265:4d047c05b7ad

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Revised the "nginx for Windows" article.
author Ruslan Ermilov <ru@nginx.com>
date Thu, 22 Dec 2011 09:07:37 +0000
parents 7db449e89e92
children 6135f3c95bf6
comparison
equal deleted inserted replaced
264:06b4c1f3149d 265:4d047c05b7ad
1 <!DOCTYPE article SYSTEM "../../../dtd/article.dtd"> 1 <!DOCTYPE article SYSTEM "../../../dtd/article.dtd">
2 2
3 <article name="Установка и использование под Windows" 3 <article name="nginx под Windows"
4 link="/ru/docs/windows.html" 4 link="/ru/docs/windows.html"
5 lang="ru"> 5 lang="ru">
6 6
7 <section> 7 <section>
8 8
9 <para> 9 <para>
10 nginx/Windows работает с Win32 API (не эмуляция Cygwin). 10 Версия nginx под Windows использует “родной” Win32 API (не эмуляцию Cygwin).
11 В качестве метода обработки соединений используется select, 11 В настоящий момент в качестве метода обработки соединений используется
12 поэтому не стоит ожидать высокой производительности и масштабируемости: 12 только <c-func>select</c-func>,
13 пока это бета-версия. 13 поэтому не стоит ожидать высокой производительности и масштабируемости.
14 На данный момент доступна практически вся функциональность, что и в nginx/Unix, 14 В силу этого и ряда других известных проблем версия nginx под Windows
15 за исключением XSLT-фильтра, фильтра изображений, модуля geoip 15 рассматривается пока как <i>бета</i>-версия.
16 и встроенного perl'а. 16 На данный момент в ней доступна практически вся функциональность, что и
17 в версии nginx под UNIX, за исключением
18 XSLT-фильтра, фильтра изображений, модуля GeoIP и встроенного языка Perl.
17 </para> 19 </para>
18 20
19 <para> 21 <para>
20 Распаковываем дистрибутив на диск C:, переходим в каталог 22 Чтобы установить nginx/Windows, <link doc="../download.xml">скачайте</link>
21 nginx-<development_version/> и запускаем <command>nginx</command>: 23 дистрибутив последней разрабатываемой версии (<development_version/>),
24 поскольку ветвь разработки nginx содержит все известные исправления.
25 Затем распакуйте дистрибутив, перейдите в каталог
26 nginx-<development_version/>
27 и запустите <command>nginx</command>.
28 Вот пример для корневого каталога на диске C:
29
22 <programlisting> 30 <programlisting>
23 cd c:\ 31 cd c:\
24 unzip nginx-<development_version/>.zip 32 unzip nginx-<development_version/>.zip
25 cd nginx-<development_version/> 33 cd nginx-<development_version/>
26 start nginx 34 start nginx
27 </programlisting> 35 </programlisting>
36
37 Чтобы увидеть процессы nginx, запустите утилиту командной строки
38 <command>tasklist</command>:
39
40 <programlisting>
41 C:\nginx-<development_version/>&gt;tasklist /fi "imagename eq nginx.exe"
42
43 Image Name PID Session Name Session# Mem Usage
44 =============== ======== ============== ========== ============
45 nginx.exe 652 Console 0 2 780 K
46 nginx.exe 1332 Console 0 3 112 K
47 </programlisting>
48
49 Один из процессов основной, другой&mdash;рабочий.
50 Если nginx не запускается, нужно искать причину в
51 в файле лога ошибок <path>logs\error.log</path>.
52 Если же лог-файл не создался, то причину этого следует искать
53 в Windows Event Log.
54 Если вместо ожидаемой страницы выводится страница с ошибкой, нужно также
55 искать причины ошибки в файле <path>logs\error.log</path>.
28 </para> 56 </para>
29 57
30 <para> 58 <para>
31 Если nginx не запустился, нужно смотреть причины в error_log. 59 nginx/Windows использует каталог, в котором он был запущен, в качестве
32 Если же error_log не создался, то об этом сообщается в Event Log. 60 префикса для относительных путей в конфигурации.
61 В вышеприведённом примере префиксом является
62 <path>C:\nginx-<development_version/>\</path>.
63 Пути в конфигурационном файле должны задаваться в UNIX-стиле с использованием
64 прямых слэшей:
65
66 <programlisting>
67 access_log logs/site.log;
68 root C:/web/html;
69 </programlisting>
33 </para> 70 </para>
34 71
35 <para> 72 <para>
36 nginx/Windows работает как обычное приложение (не сервис) и 73 nginx/Windows работает как стандартное консольное приложение (не сервис)
37 управляется следующим образом: 74 и управляется при помощи следующих команд:
38 <note>
39 <table>
40 75
41 <tr><td width="20%">nginx -s stop</td><td>быстрое завершение</td></tr> 76 <table note="yes">
42 <tr><td width="20%">nginx -s quit</td><td>плавное завершение</td></tr> 77
43 <tr><td width="20%">nginx -s reload</td><td>изменение конфигурации, 78 <tr>
79 <td width="20%">nginx -s stop</td>
80 <td>быстрое завершение</td>
81 </tr>
82
83 <tr>
84 <td>nginx -s quit</td>
85 <td>плавное завершение</td>
86 </tr>
87
88 <tr>
89 <td>nginx -s reload</td>
90 <td>
91 изменение конфигурации,
44 запуск новых рабочих процессов с новой конфигурацией, 92 запуск новых рабочих процессов с новой конфигурацией,
45 плавное завершение старых рабочих процессов</td></tr> 93 плавное завершение старых рабочих процессов
46 <tr><td width="20%">nginx -s reopen</td><td>переоткрытие лог-файлов</td></tr> 94 </td>
95 </tr>
96
97 <tr>
98 <td>nginx -s reopen</td>
99 <td>переоткрытие лог-файлов</td>
100 </tr>
47 101
48 </table> 102 </table>
49 </note>
50 </para> 103 </para>
51 104
52 </section> 105 </section>
53 106
107 <section id="known_issues"
108 name="Известные проблемы">
109
110 <list>
111
112 <item>
113 Хоть и возможен запуск нескольких рабочих процессов, только один из них
114 реально работает.
115 </item>
116
117 <item>
118 Рабочий процесс может обслуживать не более 1024 одновременных соединений.
119 </item>
120
121 <item>
122 Кэш и другие модули, требующие поддержки разделяемой памяти, не работают
123 под Windows Vista и более поздними версиями в связи с тем, что на этих
124 версиях Windows включена рандомизация адресного пространства.
125 </item>
126
127 </list>
128
129 </section>
130
131 <section id="possible_future_enhancements"
132 name="Возможные усовершенствования в будущем">
133
134 <list>
135
136 <item>
137 Запуск в виде сервиса.
138 </item>
139
140 <item>
141 Использование портов завершения ввода-вывода (I/O completion ports)
142 в качестве метода обработки соединений.
143 </item>
144
145 <item>
146 Использование нескольких рабочих нитей внутри одного рабочего процесса.
147 </item>
148
149 </list>
150
151 </section>
152
54 </article> 153 </article>