comparison xml/ru/docs/install.xml @ 261:e93ece6bd34e

Fixed markup (added lot of links) and grammar.
author Ruslan Ermilov <ru@nginx.com>
date Wed, 21 Dec 2011 09:25:24 +0000
parents c78b2d6fe261
children 4c6d2c614d2c
comparison
equal deleted inserted replaced
260:9ba793943a93 261:e93ece6bd34e
9 <para> 9 <para>
10 Конфигурация сборки осуществляется командой <command>configure</command>. 10 Конфигурация сборки осуществляется командой <command>configure</command>.
11 Она определяет особенности системы и, в частности, методы, которые nginx 11 Она определяет особенности системы и, в частности, методы, которые nginx
12 может использовать для обработки соединений. 12 может использовать для обработки соединений.
13 В конце концов она создаёт <command>Makefile</command>. 13 В конце концов она создаёт <command>Makefile</command>.
14 <command>configure</command> поддерживает следующие параметры: 14 Команда <command>configure</command> поддерживает следующие параметры:
15 <list> 15 <list>
16 16
17 <listitem> 17 <listitem>
18 <para> 18 <para>
19 <command>--prefix=&lt;<value>путь</value>&gt;</command>&mdash;задаёт каталог, 19 <command>--prefix=&lt;<value>путь</value>&gt;</command>&mdash;задаёт каталог,
48 </listitem> 48 </listitem>
49 49
50 <listitem> 50 <listitem>
51 <para> 51 <para>
52 <command>--pid-path=&lt;<value>путь</value>&gt;</command>&mdash;задаёт 52 <command>--pid-path=&lt;<value>путь</value>&gt;</command>&mdash;задаёт
53 имя файла nginx.pid, в котором будет хранится номер главного процесса. 53 имя файла nginx.pid, в котором будет храниться номер главного процесса.
54 После установки имя файла можно всегда поменять в конфигурационном 54 После установки имя файла можно всегда поменять в конфигурационном
55 файле <command>nginx.conf</command> с помощью директивы <dirname>pid</dirname>. 55 файле <command>nginx.conf</command> с помощью директивы
56 <link doc="ngx_core_module.xml" id="pid"/>.
56 По умолчанию имя 57 По умолчанию имя
57 файла&mdash;<command>&lt;<value>prefix</value>&gt;/logs/nginx.pid</command>. 58 файла&mdash;<command>&lt;<value>prefix</value>&gt;/logs/nginx.pid</command>.
58 </para> 59 </para>
59 </listitem> 60 </listitem>
60 61
62 <para> 63 <para>
63 <command>--error-log-path=&lt;<value>путь</value>&gt;</command>&mdash;задаёт 64 <command>--error-log-path=&lt;<value>путь</value>&gt;</command>&mdash;задаёт
64 имя основного файла ошибок, предупреждений и диагностики. 65 имя основного файла ошибок, предупреждений и диагностики.
65 После установки имя файла можно всегда поменять в конфигурационном 66 После установки имя файла можно всегда поменять в конфигурационном
66 файле <command>nginx.conf</command> с помощью директивы 67 файле <command>nginx.conf</command> с помощью директивы
67 <dirname>error_log</dirname>. 68 <link doc="ngx_core_module.xml" id="error_log"/>.
68 По умолчанию имя 69 По умолчанию имя
69 файла&mdash;<command>&lt;<value>prefix</value>&gt;/logs/error.log</command>. 70 файла&mdash;<command>&lt;<value>prefix</value>&gt;/logs/error.log</command>.
70 </para> 71 </para>
71 </listitem> 72 </listitem>
72 73
73 <listitem> 74 <listitem>
74 <para> 75 <para>
75 <command>--http-log-path=&lt;<value>путь</value>&gt;</command>&mdash;задаёт 76 <command>--http-log-path=&lt;<value>путь</value>&gt;</command>&mdash;задаёт
76 имя основного файла регистрации запросов http сервера. 77 имя основного файла регистрации запросов HTTP-сервера.
77 После установки имя файла можно всегда поменять в конфигурационном 78 После установки имя файла можно всегда поменять в конфигурационном
78 файле <command>nginx.conf</command> с помощью директивы 79 файле <command>nginx.conf</command> с помощью директивы
79 <dirname>access_log</dirname>. 80 <link doc="http/ngx_http_log_module.xml" id="access_log"/>.
80 По умолчанию имя 81 По умолчанию имя
81 файла&mdash;<command>&lt;<value>prefix</value>&gt;/logs/access.log</command>. 82 файла&mdash;<command>&lt;<value>prefix</value>&gt;/logs/access.log</command>.
82 </para> 83 </para>
83 </listitem> 84 </listitem>
84 85
87 <command>--user=&lt;<value>имя</value>&gt;</command>&mdash;задаёт 88 <command>--user=&lt;<value>имя</value>&gt;</command>&mdash;задаёт
88 имя непривилегированного пользователя, с правами которого будут 89 имя непривилегированного пользователя, с правами которого будут
89 выполняться рабочие процессы. 90 выполняться рабочие процессы.
90 После установки это имя можно всегда поменять в конфигурационном 91 После установки это имя можно всегда поменять в конфигурационном
91 файле <command>nginx.conf</command> с помощью директивы 92 файле <command>nginx.conf</command> с помощью директивы
92 <dirname>user</dirname>. 93 <link doc="ngx_core_module.xml" id="user"/>.
93 По умолчанию имя пользователя nobody. 94 По умолчанию имя пользователя nobody.
94 </para> 95 </para>
95 </listitem> 96 </listitem>
96 97
97 <listitem> 98 <listitem>
98 <para> 99 <para>
99 <command>--group=&lt;<value>группа</value>&gt;</command>&mdash;задаёт 100 <command>--group=&lt;<value>имя</value>&gt;</command>&mdash;задаёт
100 группу, с правами которой будут выполняться рабочие процессы. 101 имя группы, с правами которой будут выполняться рабочие процессы.
101 После установки это имя можно всегда поменять в конфигурационном 102 После установки это имя можно всегда поменять в конфигурационном
102 файле <command>nginx.conf</command> с помощью директивы <dirname>user</dirname>. 103 файле <command>nginx.conf</command> с помощью директивы
104 <link doc="ngx_core_module.xml" id="user"/>.
103 По умолчанию группа совпадает с именем непривилегированного пользователя. 105 По умолчанию группа совпадает с именем непривилегированного пользователя.
104 </para> 106 </para>
105 </listitem> 107 </listitem>
106 108
107 <listitem> 109 <listitem>
108 <para> 110 <para>
109 <command>--with-select_module</command><br/> 111 <command>--with-select_module</command><br/>
110 <command>--without-select_module</command>&mdash;разрешает или запрещает 112 <command>--without-select_module</command>&mdash;разрешает или запрещает
111 сборку модуля для работы сервера с помощью метода select. 113 сборку модуля для работы сервера с помощью метода <c-func>select</c-func>.
112 Этот модуль собирается автоматически, если на платформе не обнаружено 114 Этот модуль собирается автоматически, если на платформе не обнаружено
113 более подходящего метода&mdash;kqueue, epoll, rtsig или /dev/poll. 115 более подходящего метода&mdash;kqueue, epoll, rtsig или /dev/poll.
114 </para> 116 </para>
115 </listitem> 117 </listitem>
116 118
117 <listitem> 119 <listitem>
118 <para> 120 <para>
119 <command>--with-poll_module</command><br/> 121 <command>--with-poll_module</command><br/>
120 <command>--without-poll_module</command>&mdash;разрешает или запрещает 122 <command>--without-poll_module</command>&mdash;разрешает или запрещает
121 сборку модуля для работы сервера с помощью метода poll. 123 сборку модуля для работы сервера с помощью метода <c-func>poll</c-func>.
122 Этот модуль собирается автоматически, если на платформе не обнаружено 124 Этот модуль собирается автоматически, если на платформе не обнаружено
123 более подходящего метода&mdash;kqueue, epoll, rtsig или /dev/poll. 125 более подходящего метода&mdash;kqueue, epoll, rtsig или /dev/poll.
124 </para> 126 </para>
125 </listitem> 127 </listitem>
126 128
127 <listitem> 129 <listitem>
128 <para> 130 <para>
129 <command>--without-http_gzip_module</command>&mdash;запрещает сборку модуля 131 <command>--without-http_gzip_module</command>&mdash;запрещает сборку модуля
130 сжатия ответов http сервера. 132 <link doc="http/ngx_http_gzip_module.xml">сжатия ответов</link> HTTP-сервера.
131 Для сборки и работы этого модуля нужна библиотека zlib. 133 Для сборки и работы этого модуля нужна библиотека zlib.
132 </para> 134 </para>
133 </listitem> 135 </listitem>
134 136
135 <listitem> 137 <listitem>
136 <para> 138 <para>
137 <command>--without-http_rewrite_module</command>&mdash;запрещает сборку модуля 139 <command>--without-http_rewrite_module</command>&mdash;запрещает сборку модуля
138 http сервера, позволяющего делать перенаправления и менять URI запросов. 140 HTTP-сервера, позволяющего <link doc="http/ngx_http_rewrite_module.xml">делать
141 перенаправления и менять URI запросов</link>.
139 Для сборки и работы этого модуля нужна библиотека PCRE. 142 Для сборки и работы этого модуля нужна библиотека PCRE.
140 Модуль экспериментальный&mdash;директивы модуля впоследствии могут измениться. 143 Модуль экспериментальный&mdash;директивы модуля впоследствии могут измениться.
141 </para> 144 </para>
142 </listitem> 145 </listitem>
143 146
144 <listitem> 147 <listitem>
145 <para> 148 <para>
146 <command>--without-http_proxy_module</command>&mdash;запрещает сборку 149 <command>--without-http_proxy_module</command>&mdash;запрещает сборку
147 проксирующего модуля http сервера. 150 <link doc="http/ngx_http_proxy_module.xml">проксирующего модуля</link>
151 HTTP-сервера.
148 <!-- 152 <!--
149 Для сборки и работы этого модуля нужна библиотека md5. 153 Для сборки и работы этого модуля нужна библиотека md5.
150 --> 154 -->
151 </para> 155 </para>
152 </listitem> 156 </listitem>
153 157
154 <listitem> 158 <listitem>
155 <para> 159 <para>
156 <command>--with-http_ssl_module</command>&mdash;разрешает сборку модуля 160 <command>--with-http_ssl_module</command>&mdash;разрешает сборку модуля
157 для работы http сервера по протоколу HTTPS. По умолчанию модуль не собирается. 161 для работы HTTP-сервера по <link doc="http/ngx_http_ssl_module.xml">протоколу
162 HTTPS</link>.
163 По умолчанию модуль не собирается.
158 Для сборки и работы этого модуля нужна библиотека OpenSSL. 164 Для сборки и работы этого модуля нужна библиотека OpenSSL.
159 </para> 165 </para>
160 </listitem> 166 </listitem>
161 167
162 <listitem> 168 <listitem>
163 <para> 169 <para>
164 <command>--with-pcre=&lt;<value>путь</value>&gt;</command>&mdash;задаёт 170 <command>--with-pcre=&lt;<value>путь</value>&gt;</command>&mdash;задаёт
165 путь к исходным текстам библиотеки PCRE. Дистрибутив библиотеки (версию 171 путь к исходным текстам библиотеки PCRE.
172 Дистрибутив библиотеки (версию
166 4.4&mdash;6.1) нужно взять на сайте <link url="http://www.pcre.org">PCRE</link> 173 4.4&mdash;6.1) нужно взять на сайте <link url="http://www.pcre.org">PCRE</link>
167 и распаковать. 174 и распаковать.
168 Всё остальное сделают nginx'овские ./configure и make. 175 Всё остальное сделают ./configure nginx'а и make.
169 Библиотека нужна для использования регулярных выражений в 176 Библиотека нужна для использования регулярных выражений в директиве
170 <dirname>location</dirname> и для модуля ngx_http_rewrite_module. 177 <link doc="http/ngx_http_core_module.xml" id="location"/>
178 и для модуля
179 <link doc="http/ngx_http_rewrite_module.xml">ngx_http_rewrite_module</link>.
171 </para> 180 </para>
172 </listitem> 181 </listitem>
173 182
174 <listitem> 183 <listitem>
175 <para> 184 <para>
176 <command>--with-zlib=&lt;<value>путь</value>&gt;</command>&mdash;задаёт 185 <command>--with-zlib=&lt;<value>путь</value>&gt;</command>&mdash;задаёт
177 путь к исходным текстам библиотеки zlib. Дистрибутив библиотеки (версию 186 путь к исходным текстам библиотеки zlib. Дистрибутив библиотеки (версию
178 1.1.3&mdash;1.2.2) нужно взять на сайте 187 1.1.3&mdash;1.2.2) нужно взять на сайте
179 <link url="http://www.gzip.org/zlib/">zlib</link> и распаковать. 188 <link url="http://www.gzip.org/zlib/">zlib</link> и распаковать.
180 Всё остальное сделают nginx'овские ./configure и make. 189 Всё остальное сделают ./configure nginx'а и make.
181 Библиотека нужна для модуля ngx_http_gzip_module. 190 Библиотека нужна для модуля
191 <link doc="http/ngx_http_gzip_module.xml">ngx_http_gzip_module</link>.
182 </para> 192 </para>
183 </listitem> 193 </listitem>
184 194
185 <listitem> 195 <listitem>
186 <para> 196 <para>
187 <command>--with-cc-opt=&lt;<value>параметры</value>&gt;</command>&mdash;задаёт 197 <command>--with-cc-opt=&lt;<value>параметры</value>&gt;</command>&mdash;задаёт
188 дополнительные параметры, которые будут добавлены к переменной CFLAGS. 198 дополнительные параметры, которые будут добавлены к переменной CFLAGS.
189 При использовании системной библиотеки PCRE во FreeBSD, нужно указать 199 При использовании системной библиотеки PCRE во FreeBSD, нужно указать
190 <command>--with-cc-opt="-I /usr/local/include"</command>. 200 <command>--with-cc-opt="-I /usr/local/include"</command>.
191 Если нужно увеличить число файлов, с которыми может работать select(), 201 Если нужно увеличить число файлов, с которыми может работать
192 то это тоже можно задать здесь же: 202 <c-func>select</c-func>, то это тоже можно задать здесь же:
193 <command>--with-cc-opt="-D FD_SETSIZE=2048"</command>. 203 <command>--with-cc-opt="-D FD_SETSIZE=2048"</command>.
194 </para> 204 </para>
195 </listitem> 205 </listitem>
196 206
197 <listitem> 207 <listitem>