Mercurial > hg > nginx-site
comparison xml/ru/docs/configure.xml @ 2156:224ca9f697a5
Documented all configure options.
author | Maxim Dounin <mdounin@mdounin.ru> |
---|---|
date | Mon, 23 Apr 2018 21:41:07 +0300 |
parents | fd06f014e6db |
children | 4ad2cf470ed8 |
comparison
equal
deleted
inserted
replaced
2155:fd06f014e6db | 2156:224ca9f697a5 |
---|---|
6 <!DOCTYPE article SYSTEM "../../../dtd/article.dtd"> | 6 <!DOCTYPE article SYSTEM "../../../dtd/article.dtd"> |
7 | 7 |
8 <article name="Сборка nginx из исходных файлов" | 8 <article name="Сборка nginx из исходных файлов" |
9 link="/ru/docs/configure.html" | 9 link="/ru/docs/configure.html" |
10 lang="ru" | 10 lang="ru" |
11 rev="13"> | 11 rev="14"> |
12 | 12 |
13 <section> | 13 <section> |
14 | 14 |
15 <para> | 15 <para> |
16 Сборка настраивается командой <command>configure</command>. | 16 Сборка настраивается командой <command>configure</command>. |
17 Она определяет особенности системы и, в частности, методы, которые nginx | 17 Она определяет особенности системы и, в частности, методы, которые nginx |
18 может использовать для обработки соединений. | 18 может использовать для обработки соединений. |
19 В конце концов она создаёт <path>Makefile</path>. | 19 В конце концов она создаёт <path>Makefile</path>. |
20 </para> | |
21 | |
22 <para> | |
20 Команда <command>configure</command> поддерживает следующие параметры: | 23 Команда <command>configure</command> поддерживает следующие параметры: |
24 </para> | |
25 | |
26 <para> | |
27 <list type="tag"> | |
28 | |
29 <tag-name> | |
30 <literal>--help</literal> | |
31 </tag-name> | |
32 <tag-desc> | |
33 печатает справочное сообщение. | |
34 </tag-desc> | |
35 | |
36 </list> | |
37 </para> | |
38 | |
39 <para> | |
21 <list type="tag"> | 40 <list type="tag"> |
22 | 41 |
23 <tag-name> | 42 <tag-name> |
24 <literal>--prefix=<value>путь</value></literal> | 43 <literal>--prefix=<value>путь</value></literal> |
25 </tag-name> | 44 </tag-name> |
37 <tag-desc> | 56 <tag-desc> |
38 задаёт имя исполняемого файла nginx. | 57 задаёт имя исполняемого файла nginx. |
39 Это имя используется только на стадии установки. | 58 Это имя используется только на стадии установки. |
40 По умолчанию файл называется | 59 По умолчанию файл называется |
41 <path><value>префикс</value>/sbin/nginx</path>. | 60 <path><value>префикс</value>/sbin/nginx</path>. |
61 </tag-desc> | |
62 | |
63 <tag-name> | |
64 <literal>--modules-path=<value>путь</value></literal> | |
65 </tag-name> | |
66 <tag-desc> | |
67 задаёт каталог, в который будут устанавливаться динамические модули. | |
68 По умолчанию используется каталог <path><value>префикс</value>/modules</path>. | |
42 </tag-desc> | 69 </tag-desc> |
43 | 70 |
44 <tag-name> | 71 <tag-name> |
45 <literal>--conf-path=<value>путь</value></literal> | 72 <literal>--conf-path=<value>путь</value></literal> |
46 </tag-name> | 73 </tag-name> |
49 При желании nginx можно всегда запустить с другим конфигурационным файлом, | 76 При желании nginx можно всегда запустить с другим конфигурационным файлом, |
50 указав его в параметре командной строки | 77 указав его в параметре командной строки |
51 <nobr><literal>-c <value>файл</value></literal></nobr>. | 78 <nobr><literal>-c <value>файл</value></literal></nobr>. |
52 По умолчанию файл называется | 79 По умолчанию файл называется |
53 <path><value>префикс</value>/conf/nginx.conf</path>. | 80 <path><value>префикс</value>/conf/nginx.conf</path>. |
81 </tag-desc> | |
82 | |
83 <tag-name> | |
84 <literal>--error-log-path=<value>путь</value></literal> | |
85 </tag-name> | |
86 <tag-desc> | |
87 задаёт имя основного файла ошибок, предупреждений и диагностики. | |
88 После установки имя файла можно всегда поменять в конфигурационном | |
89 файле <path>nginx.conf</path> с помощью директивы | |
90 <link doc="ngx_core_module.xml" id="error_log"/>. | |
91 По умолчанию имя | |
92 файла—<path><value>префикс</value>/logs/error.log</path>. | |
54 </tag-desc> | 93 </tag-desc> |
55 | 94 |
56 <tag-name> | 95 <tag-name> |
57 <literal>--pid-path=<value>путь</value></literal> | 96 <literal>--pid-path=<value>путь</value></literal> |
58 </tag-name> | 97 </tag-name> |
65 По умолчанию имя | 104 По умолчанию имя |
66 файла—<path><value>префикс</value>/logs/nginx.pid</path>. | 105 файла—<path><value>префикс</value>/logs/nginx.pid</path>. |
67 </tag-desc> | 106 </tag-desc> |
68 | 107 |
69 <tag-name> | 108 <tag-name> |
70 <literal>--error-log-path=<value>путь</value></literal> | 109 <literal>--lock-path=<value>путь</value></literal> |
71 </tag-name> | 110 </tag-name> |
72 <tag-desc> | 111 <tag-desc> |
73 задаёт имя основного файла ошибок, предупреждений и диагностики. | 112 задаёт префикс имён файлов блокировок. |
74 После установки имя файла можно всегда поменять в конфигурационном | 113 После установки значение можно всегда поменять в конфигурационном |
75 файле <path>nginx.conf</path> с помощью директивы | 114 файле <path>nginx.conf</path> с помощью директивы |
76 <link doc="ngx_core_module.xml" id="error_log"/>. | 115 <link doc="ngx_core_module.xml" id="lock_file"/>. |
77 По умолчанию имя | 116 По умолчанию используется значение |
78 файла—<path><value>префикс</value>/logs/error.log</path>. | 117 <path><value>префикс</value>/logs/nginx.lock</path>. |
79 </tag-desc> | 118 </tag-desc> |
119 | |
120 </list> | |
121 </para> | |
122 | |
123 <para> | |
124 <list type="tag"> | |
125 | |
126 <tag-name> | |
127 <literal>--user=<value>имя</value></literal> | |
128 </tag-name> | |
129 <tag-desc> | |
130 задаёт имя непривилегированного пользователя, с правами которого будут | |
131 выполняться рабочие процессы. | |
132 После установки это имя можно всегда поменять в конфигурационном | |
133 файле <path>nginx.conf</path> с помощью директивы | |
134 <link doc="ngx_core_module.xml" id="user"/>. | |
135 По умолчанию имя пользователя nobody. | |
136 </tag-desc> | |
137 | |
138 <tag-name> | |
139 <literal>--group=<value>имя</value></literal> | |
140 </tag-name> | |
141 <tag-desc> | |
142 задаёт имя группы, с правами которой будут выполняться рабочие процессы. | |
143 После установки это имя можно всегда поменять в конфигурационном | |
144 файле <path>nginx.conf</path> с помощью директивы | |
145 <link doc="ngx_core_module.xml" id="user"/>. | |
146 По умолчанию группа совпадает с именем непривилегированного пользователя. | |
147 </tag-desc> | |
148 | |
149 </list> | |
150 </para> | |
151 | |
152 <para> | |
153 <list type="tag"> | |
154 | |
155 <tag-name id="build"> | |
156 <literal>--build=<value>имя</value></literal> | |
157 </tag-name> | |
158 <tag-desc> | |
159 задаёт необязательное имя сборки nginx. | |
160 </tag-desc> | |
161 | |
162 <tag-name> | |
163 <literal>--builddir=<value>путь</value></literal> | |
164 </tag-name> | |
165 <tag-desc> | |
166 задаёт каталог для сборки. | |
167 </tag-desc> | |
168 | |
169 </list> | |
170 </para> | |
171 | |
172 <para> | |
173 <list type="tag"> | |
174 | |
175 <tag-name> | |
176 <literal>--with-select_module</literal><br/> | |
177 <literal>--without-select_module</literal> | |
178 </tag-name> | |
179 <tag-desc> | |
180 разрешает или запрещает сборку модуля для работы сервера | |
181 с помощью метода <c-func>select</c-func>. | |
182 Этот модуль собирается автоматически, если на платформе не обнаружено | |
183 более подходящего метода—kqueue, epoll или /dev/poll. | |
184 </tag-desc> | |
185 | |
186 <tag-name> | |
187 <literal>--with-poll_module</literal><br/> | |
188 <literal>--without-poll_module</literal> | |
189 </tag-name> | |
190 <tag-desc> | |
191 разрешает или запрещает сборку модуля для работы сервера | |
192 с помощью метода <c-func>poll</c-func>. | |
193 Этот модуль собирается автоматически, если на платформе не обнаружено | |
194 более подходящего метода—kqueue, epoll или /dev/poll. | |
195 </tag-desc> | |
196 | |
197 <tag-name> | |
198 <literal>--with-threads</literal> | |
199 </tag-name> | |
200 <tag-desc> | |
201 разрешает использование | |
202 <link doc="ngx_core_module.xml" id="thread_pool">пулов потоков</link>. | |
203 </tag-desc> | |
204 | |
205 <tag-name> | |
206 <literal>--with-file-aio</literal> | |
207 </tag-name> | |
208 <tag-desc> | |
209 разрешает использование | |
210 <link doc="http/ngx_http_core_module.xml" id="aio">файлового асинхронного | |
211 ввода-вывода</link> (AIO) во FreeBSD и Linux. | |
212 </tag-desc> | |
213 | |
214 </list> | |
215 </para> | |
216 | |
217 <para> | |
218 <list type="tag"> | |
219 | |
220 <tag-name> | |
221 <literal>--with-http_ssl_module</literal> | |
222 </tag-name> | |
223 <tag-desc> | |
224 разрешает сборку модуля для работы HTTP-сервера по | |
225 <link doc="http/ngx_http_ssl_module.xml">протоколу HTTPS</link>. | |
226 По умолчанию модуль не собирается. | |
227 Для сборки и работы этого модуля нужна библиотека OpenSSL. | |
228 </tag-desc> | |
229 | |
230 <tag-name> | |
231 <literal>--with-http_v2_module</literal> | |
232 </tag-name> | |
233 <tag-desc> | |
234 разрешает сборку модуля для работы HTTP-сервера по протоколу | |
235 <link doc="http/ngx_http_v2_module.xml">HTTP/2</link>. | |
236 По умолчанию модуль не собирается. | |
237 </tag-desc> | |
238 | |
239 <tag-name> | |
240 <literal>--with-http_realip_module</literal> | |
241 </tag-name> | |
242 <tag-desc> | |
243 разрешает сборку модуля | |
244 <link doc="http/ngx_http_realip_module.xml">ngx_http_realip_module</link>, | |
245 позволяющего менять адрес клиента на переданный в указанном поле заголовка. | |
246 По умолчанию модуль не собирается. | |
247 </tag-desc> | |
248 | |
249 <tag-name> | |
250 <literal>--with-http_addition_module</literal> | |
251 </tag-name> | |
252 <tag-desc> | |
253 разрешает сборку модуля | |
254 <link doc="http/ngx_http_addition_module.xml">ngx_http_addition_module</link>, | |
255 позволяющего добавлять текст до и после ответа. | |
256 По умолчанию модуль не собирается. | |
257 </tag-desc> | |
258 | |
259 <tag-name> | |
260 <literal>--with-http_xslt_module</literal><br/> | |
261 <literal>--with-http_xslt_module=dynamic</literal> | |
262 </tag-name> | |
263 <tag-desc> | |
264 разрешает сборку модуля | |
265 <link doc="http/ngx_http_xslt_module.xml">ngx_http_xslt_module</link>, | |
266 позволяющего преобразовывать XML-ответ с помощью XSLT-шаблонов. | |
267 По умолчанию модуль не собирается. | |
268 Для сборки и работы этого модуля нужны библиотеки | |
269 <link url="http://xmlsoft.org">libxml2</link> и | |
270 <link url="http://xmlsoft.org/XSLT/">libxslt</link>. | |
271 </tag-desc> | |
272 | |
273 <tag-name> | |
274 <literal>--with-http_image_filter_module</literal><br/> | |
275 <literal>--with-http_image_filter_module=dynamic</literal> | |
276 </tag-name> | |
277 <tag-desc> | |
278 разрешает сборку модуля | |
279 <link doc="http/ngx_http_image_filter_module.xml">ngx_http_image_filter_module</link>, | |
280 позволяющего преобразовывать изображения в форматах JPEG, GIF, PNG и WebP. | |
281 По умолчанию модуль не собирается. | |
282 </tag-desc> | |
283 | |
284 <tag-name> | |
285 <literal>--with-http_geoip_module</literal><br/> | |
286 <literal>--with-http_geoip_module=dynamic</literal> | |
287 </tag-name> | |
288 <tag-desc> | |
289 разрешает сборку модуля | |
290 <link doc="http/ngx_http_geoip_module.xml">ngx_http_geoip_module</link>, | |
291 создающего переменные, значения которых зависят от IP-адреса клиента, | |
292 используя готовые базы данных | |
293 <link url="http://www.maxmind.com">MaxMind</link>. | |
294 По умолчанию модуль не собирается. | |
295 </tag-desc> | |
296 | |
297 <tag-name> | |
298 <literal>--with-http_sub_module</literal> | |
299 </tag-name> | |
300 <tag-desc> | |
301 разрешает сборку модуля | |
302 <link doc="http/ngx_http_sub_module.xml">ngx_http_sub_module</link>, | |
303 позволяющего изменять в ответе одну заданную строку на другую. | |
304 По умолчанию модуль не собирается. | |
305 </tag-desc> | |
306 | |
307 <tag-name> | |
308 <literal>--with-http_dav_module</literal> | |
309 </tag-name> | |
310 <tag-desc> | |
311 разрешает сборку модуля | |
312 <link doc="http/ngx_http_dav_module.xml">ngx_http_dav_module</link>, | |
313 предназначенного для автоматизации задач управления файлами на сервере | |
314 по протоколу WebDAV. | |
315 По умолчанию модуль не собирается. | |
316 </tag-desc> | |
317 | |
318 <tag-name> | |
319 <literal>--with-http_flv_module</literal> | |
320 </tag-name> | |
321 <tag-desc> | |
322 разрешает сборку модуля | |
323 <link doc="http/ngx_http_flv_module.xml">ngx_http_flv_module</link>, | |
324 обеспечивающего серверную поддержку псевдо-стриминга | |
325 для файлов Flash Video (FLV). | |
326 По умолчанию модуль не собирается. | |
327 </tag-desc> | |
328 | |
329 <tag-name> | |
330 <literal>--with-http_mp4_module</literal> | |
331 </tag-name> | |
332 <tag-desc> | |
333 разрешает сборку модуля | |
334 <link doc="http/ngx_http_mp4_module.xml">ngx_http_mp4_module</link>, | |
335 обеспечивающего серверную поддержку псевдо-стриминга | |
336 для файлов в формате MP4. | |
337 По умолчанию модуль не собирается. | |
338 </tag-desc> | |
339 | |
340 <tag-name> | |
341 <literal>--with-http_gunzip_module</literal> | |
342 </tag-name> | |
343 <tag-desc> | |
344 разрешает сборку модуля | |
345 <link doc="http/ngx_http_gunzip_module.xml">ngx_http_gunzip_module</link>, | |
346 позволяющего распаковывать ответы с “<literal>Content-Encoding: gzip</literal>” | |
347 для тех клиентов, которые не поддерживают метод сжатия “gzip”. | |
348 По умолчанию модуль не собирается. | |
349 </tag-desc> | |
350 | |
351 <tag-name> | |
352 <literal>--with-http_gzip_static_module</literal> | |
353 </tag-name> | |
354 <tag-desc> | |
355 разрешает сборку модуля | |
356 <link doc="http/ngx_http_gzip_static_module.xml">ngx_http_gzip_static_module</link>, | |
357 позволяющего отдавать вместо обычного файла предварительно сжатый файл | |
358 с таким же именем и с расширением “<literal>.gz</literal>”. | |
359 По умолчанию модуль не собирается. | |
360 </tag-desc> | |
361 | |
362 <tag-name> | |
363 <literal>--with-http_auth_request_module</literal> | |
364 </tag-name> | |
365 <tag-desc> | |
366 разрешает сборку модуля | |
367 <link doc="http/ngx_http_auth_request_module.xml">ngx_http_auth_request_module</link>, | |
368 предоставляющего возможность авторизации клиента, | |
369 основанной на результате подзапроса. | |
370 По умолчанию модуль не собирается. | |
371 </tag-desc> | |
372 | |
373 <tag-name> | |
374 <literal>--with-http_random_index_module</literal> | |
375 </tag-name> | |
376 <tag-desc> | |
377 разрешает сборку модуля | |
378 <link doc="http/ngx_http_random_index_module.xml">ngx_http_random_index_module</link>, | |
379 обслуживающего запросы, оканчивающиеся слэшом (‘<literal>/</literal>’), | |
380 и выдающего случайный файл в качестве индексного файла каталога. | |
381 По умолчанию модуль не собирается. | |
382 </tag-desc> | |
383 | |
384 <tag-name> | |
385 <literal>--with-http_secure_link_module</literal> | |
386 </tag-name> | |
387 <tag-desc> | |
388 разрешает сборку модуля | |
389 <link doc="http/ngx_http_secure_link_module.xml">ngx_http_secure_link_module</link>. | |
390 По умолчанию модуль не собирается. | |
391 </tag-desc> | |
392 | |
393 <tag-name> | |
394 <literal>--with-http_degradation_module</literal> | |
395 </tag-name> | |
396 <tag-desc> | |
397 разрешает сборку модуля | |
398 <literal>ngx_http_degradation_module</literal>. | |
399 По умолчанию модуль не собирается. | |
400 </tag-desc> | |
401 | |
402 <tag-name> | |
403 <literal>--with-http_slice_module</literal> | |
404 </tag-name> | |
405 <tag-desc> | |
406 разрешает сборку модуля | |
407 <link doc="http/ngx_http_slice_module.xml">ngx_http_slice_module</link>, | |
408 позволяющего разбить запрос на подзапросы, | |
409 каждый из которых возвращает определённый диапазон ответа. | |
410 Модуль обеспечивает более эффективное кэширование больших ответов. | |
411 По умолчанию модуль не собирается. | |
412 </tag-desc> | |
413 | |
414 <tag-name> | |
415 <literal>--with-http_stub_status_module</literal> | |
416 </tag-name> | |
417 <tag-desc> | |
418 разрешает сборку модуля | |
419 <link doc="http/ngx_http_stub_status_module.xml">ngx_http_stub_status_module</link>, | |
420 предоставляющего доступ к базовой информации о состоянии сервера. | |
421 По умолчанию модуль не собирается. | |
422 </tag-desc> | |
423 | |
424 </list> | |
425 </para> | |
426 | |
427 <para> | |
428 <list type="tag"> | |
429 | |
430 <tag-name> | |
431 <literal>--without-http_charset_module</literal> | |
432 </tag-name> | |
433 <tag-desc> | |
434 запрещает сборку модуля | |
435 <link doc="http/ngx_http_charset_module.xml">ngx_http_charset_module</link>, | |
436 позволяющего добавлять указанную кодировку в | |
437 поле <header>Content-Type</header> заголовка ответа | |
438 и перекодировать данные из одной кодировки в другую. | |
439 </tag-desc> | |
440 | |
441 <tag-name> | |
442 <literal>--without-http_gzip_module</literal> | |
443 </tag-name> | |
444 <tag-desc> | |
445 запрещает сборку модуля | |
446 <link doc="http/ngx_http_gzip_module.xml">сжатия ответов</link> HTTP-сервера. | |
447 Для сборки и работы этого модуля нужна библиотека zlib. | |
448 </tag-desc> | |
449 | |
450 <tag-name> | |
451 <literal>--without-http_ssi_module</literal> | |
452 </tag-name> | |
453 <tag-desc> | |
454 запрещает сборку модуля | |
455 <link doc="http/ngx_http_ssi_module.xml">ngx_http_ssi_module</link>, | |
456 обрабатывающего команды SSI (Server Side Includes) | |
457 в проходящих через него ответах. | |
458 </tag-desc> | |
459 | |
460 <tag-name> | |
461 <literal>--without-http_userid_module</literal> | |
462 </tag-name> | |
463 <tag-desc> | |
464 запрещает сборку модуля | |
465 <link doc="http/ngx_http_userid_module.xml">ngx_http_userid_module</link>, | |
466 выдающего куки для идентификации клиентов. | |
467 </tag-desc> | |
468 | |
469 <tag-name> | |
470 <literal>--without-http_access_module</literal> | |
471 </tag-name> | |
472 <tag-desc> | |
473 запрещает сборку модуля | |
474 <link doc="http/ngx_http_access_module.xml">ngx_http_access_module</link>, | |
475 позволяющего ограничить доступ для определённых адресов клиентов. | |
476 </tag-desc> | |
477 | |
478 <tag-name> | |
479 <literal>--without-http_auth_basic_module</literal> | |
480 </tag-name> | |
481 <tag-desc> | |
482 запрещает сборку модуля | |
483 <link doc="http/ngx_http_auth_basic_module.xml">ngx_http_auth_basic_module</link>, | |
484 позволяющего ограничить доступ к ресурсам с проверкой имени | |
485 и пароля пользователя по протоколу “HTTP Basic Authentication”. | |
486 </tag-desc> | |
487 | |
488 <tag-name> | |
489 <literal>--without-http_mirror_module</literal> | |
490 </tag-name> | |
491 <tag-desc> | |
492 запрещает сборку модуля | |
493 <link doc="http/ngx_http_mirror_module.xml">ngx_http_mirror_module</link>, | |
494 позволяющего зеркалировать исходный запрос при помощи создания фоновых | |
495 зеркалирующих подзапросов. | |
496 </tag-desc> | |
497 | |
498 <tag-name> | |
499 <literal>--without-http_autoindex_module</literal> | |
500 </tag-name> | |
501 <tag-desc> | |
502 запрещает сборку модуля | |
503 <link doc="http/ngx_http_autoindex_module.xml">ngx_http_autoindex_module</link>, | |
504 обслуживающего запросы, оканчивающиеся слэшом (‘<literal>/</literal>’), | |
505 и выдающего листинг каталога, когда модуль | |
506 <link doc="http/ngx_http_index_module.xml">ngx_http_index_module</link> | |
507 не нашёл индексный файл. | |
508 </tag-desc> | |
509 | |
510 <tag-name> | |
511 <literal>--without-http_geo_module</literal> | |
512 </tag-name> | |
513 <tag-desc> | |
514 запрещает сборку модуля | |
515 <link doc="http/ngx_http_geo_module.xml">ngx_http_geo_module</link>, | |
516 позволяющего создавать переменные, | |
517 значения которых зависят от IP-адреса клиента. | |
518 </tag-desc> | |
519 | |
520 <tag-name> | |
521 <literal>--without-http_map_module</literal> | |
522 </tag-name> | |
523 <tag-desc> | |
524 запрещает сборку модуля | |
525 <link doc="http/ngx_http_map_module.xml">ngx_http_map_module</link>, | |
526 позволяющего создавать переменные, | |
527 значения которых зависят от значений других переменных. | |
528 </tag-desc> | |
529 | |
530 <tag-name> | |
531 <literal>--without-http_split_clients_module</literal> | |
532 </tag-name> | |
533 <tag-desc> | |
534 запрещает сборку модуля | |
535 <link doc="http/ngx_http_split_clients_module.xml">ngx_http_split_clients_module</link>, | |
536 позволяющего создавать переменные для A/B тестирования. | |
537 </tag-desc> | |
538 | |
539 <tag-name> | |
540 <literal>--without-http_referer_module</literal> | |
541 </tag-name> | |
542 <tag-desc> | |
543 запрещает сборку модуля | |
544 <link doc="http/ngx_http_referer_module.xml">ngx_http_referer_module</link>, | |
545 позволяющего блокировать доступ к сайту для запросов с неверными значениями | |
546 поля <header>Referer</header> в заголовке. | |
547 </tag-desc> | |
548 | |
549 <tag-name> | |
550 <literal>--without-http_rewrite_module</literal> | |
551 </tag-name> | |
552 <tag-desc> | |
553 запрещает сборку модуля HTTP-сервера, позволяющего | |
554 <link doc="http/ngx_http_rewrite_module.xml">делать | |
555 перенаправления и менять URI запросов</link>. | |
556 Для сборки и работы этого модуля нужна библиотека PCRE. | |
557 </tag-desc> | |
558 | |
559 <tag-name> | |
560 <literal>--without-http_proxy_module</literal> | |
561 </tag-name> | |
562 <tag-desc> | |
563 запрещает сборку | |
564 <link doc="http/ngx_http_proxy_module.xml">проксирующего модуля</link> | |
565 HTTP-сервера. | |
566 <!-- | |
567 Для сборки и работы этого модуля нужна библиотека md5. | |
568 --> | |
569 </tag-desc> | |
570 | |
571 <tag-name> | |
572 <literal>--without-http_fastcgi_module</literal> | |
573 </tag-name> | |
574 <tag-desc> | |
575 запрещает сборку модуля | |
576 <link doc="http/ngx_http_fastcgi_module.xml">ngx_http_fastcgi_module</link>, | |
577 позволяющего передавать запросы FastCGI-серверу. | |
578 </tag-desc> | |
579 | |
580 <tag-name> | |
581 <literal>--without-http_uwsgi_module</literal> | |
582 </tag-name> | |
583 <tag-desc> | |
584 запрещает сборку модуля | |
585 <link doc="http/ngx_http_uwsgi_module.xml">ngx_http_uwsgi_module</link>, | |
586 позволяющего передавать запросы uwsgi-серверу. | |
587 </tag-desc> | |
588 | |
589 <tag-name> | |
590 <literal>--without-http_scgi_module</literal> | |
591 </tag-name> | |
592 <tag-desc> | |
593 запрещает сборку модуля | |
594 <link doc="http/ngx_http_scgi_module.xml">ngx_http_scgi_module</link>, | |
595 позволяющего передавать запросы SCGI-серверу. | |
596 </tag-desc> | |
597 | |
598 <tag-name> | |
599 <literal>--without-http_grpc_module</literal> | |
600 </tag-name> | |
601 <tag-desc> | |
602 запрещает сборку модуля | |
603 <link doc="http/ngx_http_grpc_module.xml">ngx_http_grpc_module</link>, | |
604 позволяющего передавать запросы gRPC-серверу. | |
605 </tag-desc> | |
606 | |
607 <tag-name> | |
608 <literal>--without-http_memcached_module</literal> | |
609 </tag-name> | |
610 <tag-desc> | |
611 запрещает сборку модуля | |
612 <link doc="http/ngx_http_memcached_module.xml">ngx_http_memcached_module</link>, | |
613 позволяющего получать ответы из сервера memcached. | |
614 </tag-desc> | |
615 | |
616 <tag-name> | |
617 <literal>--without-http_limit_conn_module</literal> | |
618 </tag-name> | |
619 <tag-desc> | |
620 запрещает сборку модуля | |
621 <link doc="http/ngx_http_limit_conn_module.xml">ngx_http_limit_conn_module</link>, | |
622 позволяющего ограничить число соединений по заданному ключу, | |
623 в частности, число соединений с одного IP-адреса. | |
624 </tag-desc> | |
625 | |
626 <tag-name> | |
627 <literal>--without-http_limit_req_module</literal> | |
628 </tag-name> | |
629 <tag-desc> | |
630 запрещает сборку модуля | |
631 <link doc="http/ngx_http_limit_req_module.xml">ngx_http_limit_req_module</link>, | |
632 позволяющего ограничить скорость обработки запросов по заданному ключу или, | |
633 как частный случай, скорость обработки запросов, поступающих с одного IP-адреса. | |
634 </tag-desc> | |
635 | |
636 <tag-name> | |
637 <literal>--without-http_empty_gif_module</literal> | |
638 </tag-name> | |
639 <tag-desc> | |
640 запрещает сборку модуля, | |
641 <link doc="http/ngx_http_empty_gif_module.xml">выдающего однопиксельный | |
642 прозрачный GIF</link>. | |
643 </tag-desc> | |
644 | |
645 <tag-name> | |
646 <literal>--without-http_browser_module</literal> | |
647 </tag-name> | |
648 <tag-desc> | |
649 запрещает сборку модуля | |
650 <link doc="http/ngx_http_browser_module.xml">ngx_http_browser_module</link>, | |
651 создающего переменные, значения которых зависят от значения | |
652 поля <header>User-Agent</header> в заголовке запроса. | |
653 </tag-desc> | |
654 | |
655 <tag-name> | |
656 <literal>--without-http_upstream_hash_module</literal> | |
657 </tag-name> | |
658 <tag-desc> | |
659 запрещает сборку модуля, реализующего метод балансировки нагрузки | |
660 <link doc="http/ngx_http_upstream_module.xml" id="hash"/>. | |
661 </tag-desc> | |
662 | |
663 <tag-name> | |
664 <literal>--without-http_upstream_ip_hash_module</literal> | |
665 </tag-name> | |
666 <tag-desc> | |
667 запрещает сборку модуля, реализующего метод балансировки нагрузки | |
668 <link doc="http/ngx_http_upstream_module.xml" id="ip_hash"/>. | |
669 </tag-desc> | |
670 | |
671 <tag-name> | |
672 <literal>--without-http_upstream_least_conn_module</literal> | |
673 </tag-name> | |
674 <tag-desc> | |
675 запрещает сборку модуля, реализующего метод балансировки нагрузки | |
676 <link doc="http/ngx_http_upstream_module.xml" id="least_conn"/>. | |
677 </tag-desc> | |
678 | |
679 <tag-name> | |
680 <literal>--without-http_upstream_keepalive_module</literal> | |
681 </tag-name> | |
682 <tag-desc> | |
683 запрещает сборку модуля, реализующего | |
684 <link doc="http/ngx_http_upstream_module.xml" id="keepalive">кэширование | |
685 соединений</link> к вышестоящим серверам. | |
686 </tag-desc> | |
687 | |
688 <tag-name> | |
689 <literal>--without-http_upstream_zone_module</literal> | |
690 </tag-name> | |
691 <tag-desc> | |
692 запрещает сборку модуля, позволяющего сохранять рабочее состояние группы | |
693 вышестоящих серверов в | |
694 <link doc="http/ngx_http_upstream_module.xml" id="zone">разделяемой | |
695 памяти</link>. | |
696 </tag-desc> | |
697 | |
698 </list> | |
699 </para> | |
700 | |
701 <para> | |
702 <list type="tag"> | |
703 | |
704 <tag-name> | |
705 <literal>--with-http_perl_module</literal><br/> | |
706 <literal>--with-http_perl_module=dynamic</literal> | |
707 </tag-name> | |
708 <tag-desc> | |
709 разрешает сборку модуля, добавляющего | |
710 <link doc="http/ngx_http_perl_module.xml">встроенный Perl</link>. | |
711 По умолчанию модуль не собирается. | |
712 </tag-desc> | |
713 | |
714 <tag-name> | |
715 <literal>--with-perl_modules_path=<value>путь</value></literal> | |
716 </tag-name> | |
717 <tag-desc> | |
718 задаёт каталог, в котором будут находиться файлы модулей Perl. | |
719 </tag-desc> | |
720 | |
721 <tag-name> | |
722 <literal>--with-perl=<value>путь</value></literal> | |
723 </tag-name> | |
724 <tag-desc> | |
725 задаёт имя исполняемого файла Perl. | |
726 </tag-desc> | |
727 | |
728 </list> | |
729 </para> | |
730 | |
731 <para> | |
732 <list type="tag"> | |
80 | 733 |
81 <tag-name> | 734 <tag-name> |
82 <literal>--http-log-path=<value>путь</value></literal> | 735 <literal>--http-log-path=<value>путь</value></literal> |
83 </tag-name> | 736 </tag-name> |
84 <tag-desc> | 737 <tag-desc> |
88 <link doc="http/ngx_http_log_module.xml" id="access_log"/>. | 741 <link doc="http/ngx_http_log_module.xml" id="access_log"/>. |
89 По умолчанию имя | 742 По умолчанию имя |
90 файла—<path><value>префикс</value>/logs/access.log</path>. | 743 файла—<path><value>префикс</value>/logs/access.log</path>. |
91 </tag-desc> | 744 </tag-desc> |
92 | 745 |
93 <tag-name id="build"> | 746 <tag-name> |
94 <literal>--build=<value>имя</value></literal> | 747 <literal>--http-client-body-temp-path=<value>путь</value></literal> |
95 </tag-name> | 748 </tag-name> |
96 <tag-desc> | 749 <tag-desc> |
97 задаёт необязательное имя сборки nginx. | 750 задаёт каталог для хранения временных файлов |
98 </tag-desc> | 751 с телами запросов клиентов. |
99 | 752 После установки имя файла можно всегда поменять в конфигурационном |
100 <tag-name> | |
101 <literal>--user=<value>имя</value></literal> | |
102 </tag-name> | |
103 <tag-desc> | |
104 задаёт имя непривилегированного пользователя, с правами которого будут | |
105 выполняться рабочие процессы. | |
106 После установки это имя можно всегда поменять в конфигурационном | |
107 файле <path>nginx.conf</path> с помощью директивы | 753 файле <path>nginx.conf</path> с помощью директивы |
108 <link doc="ngx_core_module.xml" id="user"/>. | 754 <link doc="http/ngx_http_core_module.xml" id="client_body_temp_path"/>. |
109 По умолчанию имя пользователя nobody. | 755 По умолчанию используется каталог |
110 </tag-desc> | 756 <path><value>префикс</value>/client_body_temp</path>. |
111 | 757 </tag-desc> |
112 <tag-name> | 758 |
113 <literal>--group=<value>имя</value></literal> | 759 <tag-name> |
114 </tag-name> | 760 <literal>--http-proxy-temp-path=<value>путь</value></literal> |
115 <tag-desc> | 761 </tag-name> |
116 задаёт имя группы, с правами которой будут выполняться рабочие процессы. | 762 <tag-desc> |
117 После установки это имя можно всегда поменять в конфигурационном | 763 задаёт каталог для хранения временных файлов |
764 с данными, полученными от проксируемых серверов. | |
765 После установки имя файла можно всегда поменять в конфигурационном | |
118 файле <path>nginx.conf</path> с помощью директивы | 766 файле <path>nginx.conf</path> с помощью директивы |
119 <link doc="ngx_core_module.xml" id="user"/>. | 767 <link doc="http/ngx_http_proxy_module.xml" id="proxy_temp_path"/>. |
120 По умолчанию группа совпадает с именем непривилегированного пользователя. | 768 По умолчанию используется каталог |
121 </tag-desc> | 769 <path><value>префикс</value>/proxy_temp</path>. |
122 | 770 </tag-desc> |
123 <tag-name> | 771 |
124 <literal>--with-select_module</literal><br/> | 772 <tag-name> |
125 <literal>--without-select_module</literal> | 773 <literal>--http-fastcgi-temp-path=<value>путь</value></literal> |
126 </tag-name> | 774 </tag-name> |
127 <tag-desc> | 775 <tag-desc> |
128 разрешает или запрещает сборку модуля для работы сервера | 776 задаёт каталог для хранения временных файлов |
129 с помощью метода <c-func>select</c-func>. | 777 с данными, полученными от FastCGI-серверов. |
130 Этот модуль собирается автоматически, если на платформе не обнаружено | 778 После установки имя файла можно всегда поменять в конфигурационном |
131 более подходящего метода—kqueue, epoll или /dev/poll. | 779 файле <path>nginx.conf</path> с помощью директивы |
132 </tag-desc> | 780 <link doc="http/ngx_http_fastcgi_module.xml" id="fastcgi_temp_path"/>. |
133 | 781 По умолчанию используется каталог |
134 <tag-name> | 782 <path><value>префикс</value>/fastcgi_temp</path>. |
135 <literal>--with-poll_module</literal><br/> | 783 </tag-desc> |
136 <literal>--without-poll_module</literal> | 784 |
137 </tag-name> | 785 <tag-name> |
138 <tag-desc> | 786 <literal>--http-uwsgi-temp-path=<value>путь</value></literal> |
139 разрешает или запрещает сборку модуля для работы сервера | 787 </tag-name> |
140 с помощью метода <c-func>poll</c-func>. | 788 <tag-desc> |
141 Этот модуль собирается автоматически, если на платформе не обнаружено | 789 задаёт каталог для хранения временных файлов |
142 более подходящего метода—kqueue, epoll или /dev/poll. | 790 с данными, полученными от uwsgi-серверов. |
143 </tag-desc> | 791 После установки имя файла можно всегда поменять в конфигурационном |
144 | 792 файле <path>nginx.conf</path> с помощью директивы |
145 <tag-name> | 793 <link doc="http/ngx_http_uwsgi_module.xml" id="uwsgi_temp_path"/>. |
146 <literal>--without-http_gzip_module</literal> | 794 По умолчанию используется каталог |
147 </tag-name> | 795 <path><value>префикс</value>/uwsgi_temp</path>. |
148 <tag-desc> | 796 </tag-desc> |
149 запрещает сборку модуля | 797 |
150 <link doc="http/ngx_http_gzip_module.xml">сжатия ответов</link> HTTP-сервера. | 798 <tag-name> |
151 Для сборки и работы этого модуля нужна библиотека zlib. | 799 <literal>--http-scgi-temp-path=<value>путь</value></literal> |
152 </tag-desc> | 800 </tag-name> |
153 | 801 <tag-desc> |
154 <tag-name> | 802 задаёт каталог для хранения временных файлов |
155 <literal>--without-http_rewrite_module</literal> | 803 с данными, полученными от SCGI-серверов. |
156 </tag-name> | 804 После установки имя файла можно всегда поменять в конфигурационном |
157 <tag-desc> | 805 файле <path>nginx.conf</path> с помощью директивы |
158 запрещает сборку модуля HTTP-сервера, позволяющего | 806 <link doc="http/ngx_http_scgi_module.xml" id="scgi_temp_path"/>. |
159 <link doc="http/ngx_http_rewrite_module.xml">делать | 807 По умолчанию используется каталог |
160 перенаправления и менять URI запросов</link>. | 808 <path><value>префикс</value>/scgi_temp</path>. |
161 Для сборки и работы этого модуля нужна библиотека PCRE. | 809 </tag-desc> |
162 </tag-desc> | 810 |
163 | 811 </list> |
164 <tag-name> | 812 </para> |
165 <literal>--without-http_proxy_module</literal> | 813 |
166 </tag-name> | 814 <para> |
167 <tag-desc> | 815 <list type="tag"> |
168 запрещает сборку | 816 |
169 <link doc="http/ngx_http_proxy_module.xml">проксирующего модуля</link> | 817 <tag-name> |
170 HTTP-сервера. | 818 <literal>--without-http</literal> |
171 <!-- | 819 </tag-name> |
172 Для сборки и работы этого модуля нужна библиотека md5. | 820 <tag-desc> |
173 --> | 821 запрещает <link doc="http/ngx_http_core_module.xml">HTTP-сервер</link>. |
174 </tag-desc> | 822 </tag-desc> |
175 | 823 |
176 <tag-name> | 824 <tag-name> |
177 <literal>--with-http_ssl_module</literal> | 825 <literal>--without-http-cache</literal> |
178 </tag-name> | 826 </tag-name> |
179 <tag-desc> | 827 <tag-desc> |
180 разрешает сборку модуля для работы HTTP-сервера по | 828 запрещает HTTP-кэш. |
181 <link doc="http/ngx_http_ssl_module.xml">протоколу HTTPS</link>. | 829 </tag-desc> |
830 | |
831 </list> | |
832 </para> | |
833 | |
834 <para> | |
835 <list type="tag"> | |
836 | |
837 <tag-name> | |
838 <literal>--with-mail</literal><br/> | |
839 <literal>--with-mail=dynamic</literal> | |
840 </tag-name> | |
841 <tag-desc> | |
842 разрешает POP3/IMAP4/SMTP | |
843 <link doc="mail/ngx_mail_core_module.xml">почтовый прокси-сервер</link>. | |
844 </tag-desc> | |
845 | |
846 <tag-name> | |
847 <literal>--with-mail_ssl_module</literal> | |
848 </tag-name> | |
849 <tag-desc> | |
850 разрешает сборку модуля для работы почтового прокси-сервера по | |
851 <link doc="mail/ngx_mail_ssl_module.xml">протоколу SSL/TLS</link>. | |
182 По умолчанию модуль не собирается. | 852 По умолчанию модуль не собирается. |
183 Для сборки и работы этого модуля нужна библиотека OpenSSL. | 853 Для сборки и работы этого модуля нужна библиотека OpenSSL. |
854 </tag-desc> | |
855 | |
856 <tag-name> | |
857 <literal>--without-mail_pop3_module</literal> | |
858 </tag-name> | |
859 <tag-desc> | |
860 запрещает протокол <link doc="mail/ngx_mail_pop3_module.xml">POP3</link> | |
861 в почтовом прокси-сервере. | |
862 </tag-desc> | |
863 | |
864 <tag-name> | |
865 <literal>--without-mail_imap_module</literal> | |
866 </tag-name> | |
867 <tag-desc> | |
868 запрещает протокол <link doc="mail/ngx_mail_imap_module.xml">IMAP</link> | |
869 в почтовом прокси-сервере. | |
870 </tag-desc> | |
871 | |
872 <tag-name> | |
873 <literal>--without-mail_smtp_module</literal> | |
874 </tag-name> | |
875 <tag-desc> | |
876 запрещает протокол <link doc="mail/ngx_mail_smtp_module.xml">SMTP</link> | |
877 в почтовом прокси-сервере. | |
878 </tag-desc> | |
879 | |
880 </list> | |
881 </para> | |
882 | |
883 <para> | |
884 <list type="tag"> | |
885 | |
886 <tag-name> | |
887 <literal>--with-stream</literal><br/> | |
888 <literal>--with-stream=dynamic</literal> | |
889 </tag-name> | |
890 <tag-desc> | |
891 разрешает сборку | |
892 <link doc="stream/ngx_stream_core_module.xml">модуля stream</link> | |
893 для TCP/UDP-проксирования и балансировки. | |
894 По умолчанию модуль не собирается. | |
895 </tag-desc> | |
896 | |
897 <tag-name> | |
898 <literal>--with-stream_ssl_module</literal> | |
899 </tag-name> | |
900 <tag-desc> | |
901 разрешает сборку модуля для работы модуля stream по | |
902 <link doc="stream/ngx_stream_ssl_module.xml">протоколу SSL/TLS</link>. | |
903 По умолчанию модуль не собирается. | |
904 Для сборки и работы этого модуля нужна библиотека OpenSSL. | |
905 </tag-desc> | |
906 | |
907 <tag-name> | |
908 <literal>--with-stream_realip_module</literal> | |
909 </tag-name> | |
910 <tag-desc> | |
911 разрешает сборку модуля | |
912 <link doc="http/ngx_stream_realip_module.xml">ngx_stream_realip_module</link>, | |
913 позволяющего менять адрес клиента на переданный в заголовке протокола PROXY. | |
914 По умолчанию модуль не собирается. | |
915 </tag-desc> | |
916 | |
917 <tag-name> | |
918 <literal>--with-stream_geoip_module</literal><br/> | |
919 <literal>--with-stream_geoip_module=dynamic</literal> | |
920 </tag-name> | |
921 <tag-desc> | |
922 разрешает сборку модуля | |
923 <link doc="stream/ngx_stream_geoip_module.xml">ngx_stream_geoip_module</link>, | |
924 создающего переменные, значения которых зависят от IP-адреса клиента, | |
925 используя готовые базы данных | |
926 <link url="http://www.maxmind.com">MaxMind</link>. | |
927 По умолчанию модуль не собирается. | |
928 </tag-desc> | |
929 | |
930 <tag-name> | |
931 <literal>--with-stream_ssl_preread_module</literal> | |
932 </tag-name> | |
933 <tag-desc> | |
934 разрешает сборку модуля | |
935 <link doc="stream/ngx_stream_ssl_preread_module.xml">ngx_stream_ssl_preread_module</link>, | |
936 позволяющего извлекать информацию из сообщения | |
937 <link url="https://tools.ietf.org/html/rfc5246#section-7.4.1.2">ClientHello</link> | |
938 без терминирования SSL/TLS. | |
939 По умолчанию модуль не собирается. | |
940 </tag-desc> | |
941 | |
942 <tag-name> | |
943 <literal>--without-stream_limit_conn_module</literal> | |
944 </tag-name> | |
945 <tag-desc> | |
946 запрещает сборку модуля | |
947 <link doc="stream/ngx_stream_limit_conn_module.xml">ngx_stream_limit_conn_module</link>, | |
948 позволяющего ограничить число соединений по заданному ключу, | |
949 в частности, число соединений с одного IP-адреса. | |
950 </tag-desc> | |
951 | |
952 <tag-name> | |
953 <literal>--without-stream_access_module</literal> | |
954 </tag-name> | |
955 <tag-desc> | |
956 запрещает сборку модуля | |
957 <link doc="stream/ngx_stream_access_module.xml">ngx_stream_access_module</link>, | |
958 позволяющего ограничить доступ для определённых адресов клиентов. | |
959 </tag-desc> | |
960 | |
961 <tag-name> | |
962 <literal>--without-stream_geo_module</literal> | |
963 </tag-name> | |
964 <tag-desc> | |
965 запрещает сборку модуля | |
966 <link doc="stream/ngx_stream_geo_module.xml">ngx_stream_geo_module</link>, | |
967 позволяющего создавать переменные, | |
968 значения которых зависят от IP-адреса клиента. | |
969 </tag-desc> | |
970 | |
971 <tag-name> | |
972 <literal>--without-stream_map_module</literal> | |
973 </tag-name> | |
974 <tag-desc> | |
975 запрещает сборку модуля | |
976 <link doc="stream/ngx_stream_map_module.xml">ngx_stream_map_module</link>, | |
977 позволяющего создавать переменные, | |
978 значения которых зависят от значений других переменных. | |
979 </tag-desc> | |
980 | |
981 <tag-name> | |
982 <literal>--without-stream_split_clients_module</literal> | |
983 </tag-name> | |
984 <tag-desc> | |
985 запрещает сборку модуля | |
986 <link doc="stream/ngx_stream_split_clients_module.xml">ngx_stream_split_clients_module</link>, | |
987 позволяющего создавать переменные для A/B тестирования. | |
988 </tag-desc> | |
989 | |
990 <tag-name> | |
991 <literal>--without-stream_return_module</literal> | |
992 </tag-name> | |
993 <tag-desc> | |
994 запрещает сборку модуля | |
995 <link doc="stream/ngx_stream_return_module.xml">ngx_stream_return_module</link>, | |
996 позволяющего отправить заданное значение клиенту | |
997 и после этого закрыть соединение. | |
998 </tag-desc> | |
999 | |
1000 <tag-name> | |
1001 <literal>--without-stream_upstream_hash_module</literal> | |
1002 </tag-name> | |
1003 <tag-desc> | |
1004 запрещает сборку модуля, реализующего метод балансировки нагрузки | |
1005 <link doc="stream/ngx_stream_upstream_module.xml" id="hash"/>. | |
1006 </tag-desc> | |
1007 | |
1008 <tag-name> | |
1009 <literal>--without-stream_upstream_least_conn_module</literal> | |
1010 </tag-name> | |
1011 <tag-desc> | |
1012 запрещает сборку модуля, реализующего метод балансировки нагрузки | |
1013 <link doc="stream/ngx_stream_upstream_module.xml" id="least_conn"/>. | |
1014 </tag-desc> | |
1015 | |
1016 <tag-name> | |
1017 <literal>--without-stream_upstream_zone_module</literal> | |
1018 </tag-name> | |
1019 <tag-desc> | |
1020 запрещает сборку модуля, позволяющего сохранять рабочее состояние группы | |
1021 вышестоящих серверов в | |
1022 <link doc="stream/ngx_stream_upstream_module.xml" id="zone">разделяемой | |
1023 памяти</link>. | |
1024 </tag-desc> | |
1025 | |
1026 </list> | |
1027 </para> | |
1028 | |
1029 <para> | |
1030 <list type="tag"> | |
1031 | |
1032 <tag-name> | |
1033 <literal>--with-google_perftools_module</literal> | |
1034 </tag-name> | |
1035 <tag-desc> | |
1036 разрешает сборку модуля | |
1037 <link doc="ngx_google_perftools_module.xml">ngx_google_perftools_module</link>, | |
1038 обеспечивающего поддержку профилирования рабочих процессов nginx при помощи | |
1039 <link url="https://github.com/gperftools/gperftools">Google Performance Tools</link>. | |
1040 Модуль предназначен для разработчиков nginx и не собирается по умолчанию. | |
1041 </tag-desc> | |
1042 | |
1043 <tag-name> | |
1044 <literal>--with-cpp_test_module</literal> | |
1045 </tag-name> | |
1046 <tag-desc> | |
1047 разрешает сборку модуля | |
1048 <literal>ngx_cpp_test_module</literal>. | |
1049 </tag-desc> | |
1050 | |
1051 </list> | |
1052 </para> | |
1053 | |
1054 <para> | |
1055 <list type="tag"> | |
1056 | |
1057 <tag-name> | |
1058 <literal>--add-module=<value>путь</value></literal> | |
1059 </tag-name> | |
1060 <tag-desc> | |
1061 разрешает сборку внешнего модуля. | |
1062 </tag-desc> | |
1063 | |
1064 <tag-name> | |
1065 <literal>--add-dynamic-module=<value>путь</value></literal> | |
1066 </tag-name> | |
1067 <tag-desc> | |
1068 разрешает сборку внешнего динамического модуля. | |
1069 </tag-desc> | |
1070 | |
1071 </list> | |
1072 </para> | |
1073 | |
1074 <para> | |
1075 <list type="tag"> | |
1076 | |
1077 <tag-name> | |
1078 <literal>--with-compat</literal> | |
1079 </tag-name> | |
1080 <tag-desc> | |
1081 включает режим совместимости с динамическими модулями. | |
1082 </tag-desc> | |
1083 | |
1084 </list> | |
1085 </para> | |
1086 | |
1087 <para> | |
1088 <list type="tag"> | |
1089 | |
1090 <tag-name> | |
1091 <literal>--with-cc=<value>путь</value></literal> | |
1092 </tag-name> | |
1093 <tag-desc> | |
1094 задаёт компилятор, который будет использоваться при сборке. | |
1095 </tag-desc> | |
1096 | |
1097 <tag-name> | |
1098 <literal>--with-cpp=<value>путь</value></literal> | |
1099 </tag-name> | |
1100 <tag-desc> | |
1101 задаёт препроцессор, который будет использоваться при сборке. | |
1102 </tag-desc> | |
1103 | |
1104 <tag-name> | |
1105 <literal>--with-cc-opt=<value>параметры</value></literal> | |
1106 </tag-name> | |
1107 <tag-desc> | |
1108 задаёт дополнительные параметры, которые будут добавлены к переменной CFLAGS. | |
1109 При использовании системной библиотеки PCRE во FreeBSD, нужно указать | |
1110 <literal>--with-cc-opt="-I /usr/local/include"</literal>. | |
1111 Если нужно увеличить число файлов, с которыми может работать | |
1112 <c-func>select</c-func>, то это тоже можно задать здесь же: | |
1113 <literal>--with-cc-opt="-D FD_SETSIZE=2048"</literal>. | |
1114 </tag-desc> | |
1115 | |
1116 <tag-name> | |
1117 <literal>--with-ld-opt=<value>параметры</value></literal> | |
1118 </tag-name> | |
1119 <tag-desc> | |
1120 задаёт дополнительные параметры, которые будут использованы при линковке. | |
1121 При использовании системной библиотеки PCRE во FreeBSD, нужно указать | |
1122 <literal>--with-ld-opt="-L /usr/local/lib"</literal>. | |
1123 </tag-desc> | |
1124 | |
1125 <tag-name> | |
1126 <literal>--with-cpu-opt=<value>cpu</value></literal> | |
1127 </tag-name> | |
1128 <tag-desc> | |
1129 разрешает сборку для одного из следующих процессоров: | |
1130 <literal>pentium</literal>, <literal>pentiumpro</literal>, | |
1131 <literal>pentium3</literal>, <literal>pentium4</literal>, | |
1132 <literal>athlon</literal>, <literal>opteron</literal>, | |
1133 <literal>sparc32</literal>, <literal>sparc64</literal>, | |
1134 <literal>ppc64</literal>. | |
1135 </tag-desc> | |
1136 | |
1137 </list> | |
1138 </para> | |
1139 | |
1140 <para> | |
1141 <list type="tag"> | |
1142 | |
1143 <tag-name> | |
1144 <literal>--without-pcre</literal> | |
1145 </tag-name> | |
1146 <tag-desc> | |
1147 запрещает использование библиотеки PCRE. | |
1148 </tag-desc> | |
1149 | |
1150 <tag-name> | |
1151 <literal>--with-pcre</literal> | |
1152 </tag-name> | |
1153 <tag-desc> | |
1154 разрешает использование библиотеки PCRE. | |
184 </tag-desc> | 1155 </tag-desc> |
185 | 1156 |
186 <tag-name> | 1157 <tag-name> |
187 <literal>--with-pcre=<value>путь</value></literal> | 1158 <literal>--with-pcre=<value>путь</value></literal> |
188 </tag-name> | 1159 </tag-name> |
198 и для модуля | 1169 и для модуля |
199 <link doc="http/ngx_http_rewrite_module.xml">ngx_http_rewrite_module</link>. | 1170 <link doc="http/ngx_http_rewrite_module.xml">ngx_http_rewrite_module</link>. |
200 </tag-desc> | 1171 </tag-desc> |
201 | 1172 |
202 <tag-name> | 1173 <tag-name> |
1174 <literal>--with-pcre-opt=<value>параметры</value></literal> | |
1175 </tag-name> | |
1176 <tag-desc> | |
1177 задаёт дополнительные параметры сборки PCRE. | |
1178 </tag-desc> | |
1179 | |
1180 <tag-name> | |
203 <literal>--with-pcre-jit</literal> | 1181 <literal>--with-pcre-jit</literal> |
204 </tag-name> | 1182 </tag-name> |
205 <tag-desc> | 1183 <tag-desc> |
206 собирает библиотеку PCRE с | 1184 собирает библиотеку PCRE с |
207 поддержкой JIT-компиляции (1.1.12, директива | 1185 поддержкой JIT-компиляции (1.1.12, директива |
208 <link doc="ngx_core_module.xml" id="pcre_jit"/>). | 1186 <link doc="ngx_core_module.xml" id="pcre_jit"/>). |
209 </tag-desc> | 1187 </tag-desc> |
1188 | |
1189 </list> | |
1190 </para> | |
1191 | |
1192 <para> | |
1193 <list type="tag"> | |
210 | 1194 |
211 <tag-name> | 1195 <tag-name> |
212 <literal>--with-zlib=<value>путь</value></literal> | 1196 <literal>--with-zlib=<value>путь</value></literal> |
213 </tag-name> | 1197 </tag-name> |
214 <tag-desc> | 1198 <tag-desc> |
221 Библиотека нужна для модуля | 1205 Библиотека нужна для модуля |
222 <link doc="http/ngx_http_gzip_module.xml">ngx_http_gzip_module</link>. | 1206 <link doc="http/ngx_http_gzip_module.xml">ngx_http_gzip_module</link>. |
223 </tag-desc> | 1207 </tag-desc> |
224 | 1208 |
225 <tag-name> | 1209 <tag-name> |
226 <literal>--with-cc-opt=<value>параметры</value></literal> | 1210 <literal>--with-zlib-opt=<value>параметры</value></literal> |
227 </tag-name> | 1211 </tag-name> |
228 <tag-desc> | 1212 <tag-desc> |
229 задаёт дополнительные параметры, которые будут добавлены к переменной CFLAGS. | 1213 задаёт дополнительные параметры сборки zlib. |
230 При использовании системной библиотеки PCRE во FreeBSD, нужно указать | 1214 </tag-desc> |
231 <literal>--with-cc-opt="-I /usr/local/include"</literal>. | 1215 |
232 Если нужно увеличить число файлов, с которыми может работать | 1216 <tag-name> |
233 <c-func>select</c-func>, то это тоже можно задать здесь же: | 1217 <literal>--with-zlib-asm=<value>cpu</value></literal> |
234 <literal>--with-cc-opt="-D FD_SETSIZE=2048"</literal>. | 1218 </tag-name> |
235 </tag-desc> | 1219 <tag-desc> |
236 | 1220 разрешает использование при сборке библиотеки zlib ассемблерных вставок, |
237 <tag-name> | 1221 оптимизированных для одного из следующих процессоров: |
238 <literal>--with-ld-opt=<value>параметры</value></literal> | 1222 <literal>pentium</literal>, <literal>pentiumpro</literal>. |
239 </tag-name> | 1223 </tag-desc> |
240 <tag-desc> | 1224 |
241 задаёт дополнительные параметры, которые будут использованы при линковке. | 1225 </list> |
242 При использовании системной библиотеки PCRE во FreeBSD, нужно указать | 1226 </para> |
243 <literal>--with-ld-opt="-L /usr/local/lib"</literal>. | 1227 |
244 </tag-desc> | 1228 <para> |
245 | 1229 <list type="tag"> |
246 </list> | 1230 |
247 | 1231 <tag-name> |
1232 <literal>--with-libatomic</literal> | |
1233 </tag-name> | |
1234 <tag-desc> | |
1235 разрешает сборку с библиотекой libatomic_ops. | |
1236 </tag-desc> | |
1237 | |
1238 <tag-name> | |
1239 <literal>--with-libatomic=<value>путь</value></literal> | |
1240 </tag-name> | |
1241 <tag-desc> | |
1242 задаёт путь к исходным текстам библиотеки libatomic_ops. | |
1243 </tag-desc> | |
1244 | |
1245 </list> | |
1246 </para> | |
1247 | |
1248 <para> | |
1249 <list type="tag"> | |
1250 | |
1251 <tag-name> | |
1252 <literal>--with-openssl=<value>путь</value></literal> | |
1253 </tag-name> | |
1254 <tag-desc> | |
1255 задаёт путь к исходным текстам библиотеки OpenSSL. | |
1256 </tag-desc> | |
1257 | |
1258 <tag-name> | |
1259 <literal>--with-openssl-opt=<value>параметры</value></literal> | |
1260 </tag-name> | |
1261 <tag-desc> | |
1262 задаёт дополнительные параметры сборки OpenSSL. | |
1263 </tag-desc> | |
1264 | |
1265 </list> | |
1266 </para> | |
1267 | |
1268 <para> | |
1269 <list type="tag"> | |
1270 | |
1271 <tag-name> | |
1272 <literal>--with-debug</literal> | |
1273 </tag-name> | |
1274 <tag-desc> | |
1275 разрешает <link doc="debugging_log.xml">отладочный лог</link>. | |
1276 </tag-desc> | |
1277 | |
1278 </list> | |
248 </para> | 1279 </para> |
249 | 1280 |
250 <para> | 1281 <para> |
251 Пример использования параметров (всё это нужно набрать в одной строке): | 1282 Пример использования параметров (всё это нужно набрать в одной строке): |
252 <programlisting> | 1283 <programlisting> |