Mercurial > hg > nginx-site

comparison xml/ru/docs/configure.xml @ 924:a2aea48ff155

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
New "installation" article. Old "installation" was renamed to "configure" and describes how to build nginx from sources.
author Ruslan Ermilov <ru@nginx.com>
date Fri, 31 May 2013 13:05:51 +0400
parents xml/ru/docs/install.xml@65e75e59a714
children eea7541e7c6a
comparison
equal deleted inserted replaced
923:4f1e2120be5e 924:a2aea48ff155
1 <!--
2 Copyright (C) Igor Sysoev
3 Copyright (C) Nginx, Inc.
4 -->
5
6 <!DOCTYPE article SYSTEM "../../../dtd/article.dtd">
7
8 <article name="Сборка nginx из исходных файлов"
9 link="/ru/docs/configure.html"
10 lang="ru"
11 rev="4">
12
13 <section>
14
15 <para>
16 Сборка настраивается командой <command>configure</command>.
17 Она определяет особенности системы и, в частности, методы, которые nginx
18 может использовать для обработки соединений.
19 В конце концов она создаёт <path>Makefile</path>.
20 Команда <command>configure</command> поддерживает следующие параметры:
21 <list type="bullet">
22
23 <listitem>
24 <para>
25 <literal>--prefix=<value>путь</value></literal>&mdash;задаёт каталог,
26 в котором будут находиться файлы сервера.
27 Этот же каталог будет использоваться для всех относительных путей,
28 задаваемых <command>configure</command> (кроме путей к исходным текстам
29 библиотек) и в конфигурационном файле <path>nginx.conf</path>.
30 По умолчанию&mdash;каталог <path>/usr/local/nginx</path>.
31 </para>
32 </listitem>
33
34 <listitem>
35 <para>
36 <literal>--sbin-path=<value>путь</value></literal>&mdash;задаёт
37 имя исполняемого файла nginx.
38 Это имя используется только на стадии установки.
39 По умолчанию файл называется
40 <path><value>префикс</value>/sbin/nginx</path>.
41 </para>
42 </listitem>
43
44 <listitem>
45 <para>
46 <literal>--conf-path=<value>путь</value></literal>&mdash;задаёт
47 имя конфигурационного файла <path>nginx.conf</path>.
48 При желании nginx можно всегда запустить с другим конфигурационным файлом,
49 указав его в параметре командной строки
50 <nobr><literal>-c <value>файл</value></literal></nobr>.
51 По умолчанию файл называется
52 <path><value>префикс</value>/conf/nginx.conf</path>.
53 </para>
54 </listitem>
55
56 <listitem>
57 <para>
58 <literal>--pid-path=<value>путь</value></literal>&mdash;задаёт
59 имя файла nginx.pid, в котором будет храниться номер главного процесса.
60 После установки имя файла можно всегда поменять в конфигурационном
61 файле <path>nginx.conf</path> с помощью директивы
62 <link doc="ngx_core_module.xml" id="pid"/>.
63 По умолчанию имя
64 файла&mdash;<path><value>префикс</value>/logs/nginx.pid</path>.
65 </para>
66 </listitem>
67
68 <listitem>
69 <para>
70 <literal>--error-log-path=<value>путь</value></literal>&mdash;задаёт
71 имя основного файла ошибок, предупреждений и диагностики.
72 После установки имя файла можно всегда поменять в конфигурационном
73 файле <path>nginx.conf</path> с помощью директивы
74 <link doc="ngx_core_module.xml" id="error_log"/>.
75 По умолчанию имя
76 файла&mdash;<path><value>префикс</value>/logs/error.log</path>.
77 </para>
78 </listitem>
79
80 <listitem>
81 <para>
82 <literal>--http-log-path=<value>путь</value></literal>&mdash;задаёт
83 имя основного файла регистрации запросов HTTP-сервера.
84 После установки имя файла можно всегда поменять в конфигурационном
85 файле <path>nginx.conf</path> с помощью директивы
86 <link doc="http/ngx_http_log_module.xml" id="access_log"/>.
87 По умолчанию имя
88 файла&mdash;<path><value>префикс</value>/logs/access.log</path>.
89 </para>
90 </listitem>
91
92 <listitem>
93 <para>
94 <literal>--user=<value>имя</value></literal>&mdash;задаёт
95 имя непривилегированного пользователя, с правами которого будут
96 выполняться рабочие процессы.
97 После установки это имя можно всегда поменять в конфигурационном
98 файле <path>nginx.conf</path> с помощью директивы
99 <link doc="ngx_core_module.xml" id="user"/>.
100 По умолчанию имя пользователя nobody.
101 </para>
102 </listitem>
103
104 <listitem>
105 <para>
106 <literal>--group=<value>имя</value></literal>&mdash;задаёт
107 имя группы, с правами которой будут выполняться рабочие процессы.
108 После установки это имя можно всегда поменять в конфигурационном
109 файле <path>nginx.conf</path> с помощью директивы
110 <link doc="ngx_core_module.xml" id="user"/>.
111 По умолчанию группа совпадает с именем непривилегированного пользователя.
112 </para>
113 </listitem>
114
115 <listitem>
116 <para>
117 <literal>--with-select_module</literal><br/>
118 <literal>--without-select_module</literal>&mdash;разрешает или запрещает
119 сборку модуля для работы сервера с помощью метода <c-func>select</c-func>.
120 Этот модуль собирается автоматически, если на платформе не обнаружено
121 более подходящего метода&mdash;kqueue, epoll, rtsig или /dev/poll.
122 </para>
123 </listitem>
124
125 <listitem>
126 <para>
127 <literal>--with-poll_module</literal><br/>
128 <literal>--without-poll_module</literal>&mdash;разрешает или запрещает
129 сборку модуля для работы сервера с помощью метода <c-func>poll</c-func>.
130 Этот модуль собирается автоматически, если на платформе не обнаружено
131 более подходящего метода&mdash;kqueue, epoll, rtsig или /dev/poll.
132 </para>
133 </listitem>
134
135 <listitem>
136 <para>
137 <literal>--without-http_gzip_module</literal>&mdash;запрещает сборку модуля
138 <link doc="http/ngx_http_gzip_module.xml">сжатия ответов</link> HTTP-сервера.
139 Для сборки и работы этого модуля нужна библиотека zlib.
140 </para>
141 </listitem>
142
143 <listitem>
144 <para>
145 <literal>--without-http_rewrite_module</literal>&mdash;запрещает сборку модуля
146 HTTP-сервера, позволяющего <link doc="http/ngx_http_rewrite_module.xml">делать
147 перенаправления и менять URI запросов</link>.
148 Для сборки и работы этого модуля нужна библиотека PCRE.
149 </para>
150 </listitem>
151
152 <listitem>
153 <para>
154 <literal>--without-http_proxy_module</literal>&mdash;запрещает сборку
155 <link doc="http/ngx_http_proxy_module.xml">проксирующего модуля</link>
156 HTTP-сервера.
157 <!--
158 Для сборки и работы этого модуля нужна библиотека md5.
159 -->
160 </para>
161 </listitem>
162
163 <listitem>
164 <para>
165 <literal>--with-http_ssl_module</literal>&mdash;разрешает сборку модуля
166 для работы HTTP-сервера по <link doc="http/ngx_http_ssl_module.xml">протоколу
167 HTTPS</link>.
168 По умолчанию модуль не собирается.
169 Для сборки и работы этого модуля нужна библиотека OpenSSL.
170 </para>
171 </listitem>
172
173 <listitem>
174 <para>
175 <literal>--with-pcre=<value>путь</value></literal>&mdash;задаёт
176 путь к исходным текстам библиотеки PCRE.
177 Дистрибутив библиотеки (версию
178 4.4&mdash;8.32) нужно взять на сайте <link url="http://www.pcre.org">PCRE</link>
179 и распаковать.
180 Всё остальное сделают <command>./configure</command> nginx’а и
181 <command>make</command>.
182 Библиотека нужна для использования регулярных выражений в директиве
183 <link doc="http/ngx_http_core_module.xml" id="location"/>
184 и для модуля
185 <link doc="http/ngx_http_rewrite_module.xml">ngx_http_rewrite_module</link>.
186 </para>
187 </listitem>
188
189 <listitem>
190 <para>
191 <literal>--with-pcre-jit</literal>&mdash;собирает библиотеку PCRE с
192 поддержкой JIT-компиляции (1.1.12, директива
193 <link doc="ngx_core_module.xml" id="pcre_jit"/>).
194 </para>
195 </listitem>
196
197 <listitem>
198 <para>
199 <literal>--with-zlib=<value>путь</value></literal>&mdash;задаёт
200 путь к исходным текстам библиотеки zlib. Дистрибутив библиотеки (версию
201 1.1.3&mdash;1.2.7) нужно взять на сайте
202 <link url="http://zlib.net">zlib</link> и распаковать.
203 Всё остальное сделают <command>./configure</command> nginx’а и
204 <command>make</command>.
205 Библиотека нужна для модуля
206 <link doc="http/ngx_http_gzip_module.xml">ngx_http_gzip_module</link>.
207 </para>
208 </listitem>
209
210 <listitem>
211 <para>
212 <literal>--with-cc-opt=<value>параметры</value></literal>&mdash;задаёт
213 дополнительные параметры, которые будут добавлены к переменной CFLAGS.
214 При использовании системной библиотеки PCRE во FreeBSD, нужно указать
215 <literal>--with-cc-opt="-I /usr/local/include"</literal>.
216 Если нужно увеличить число файлов, с которыми может работать
217 <c-func>select</c-func>, то это тоже можно задать здесь же:
218 <literal>--with-cc-opt="-D FD_SETSIZE=2048"</literal>.
219 </para>
220 </listitem>
221
222 <listitem>
223 <para>
224 <literal>--with-ld-opt=<value>параметры</value></literal>&mdash;задаёт
225 дополнительные параметры, которые будут использованы при линковке.
226 При использовании системной библиотеки PCRE во FreeBSD, нужно указать
227 <literal>--with-ld-opt="-L /usr/local/lib"</literal>.
228 </para>
229 </listitem>
230
231 </list>
232
233 </para>
234
235 <para>
236 Пример использования параметров (всё это нужно набрать в одной строке):
237 <programlisting>
238 ./configure
239 --sbin-path=/usr/local/nginx/nginx
240 --conf-path=/usr/local/nginx/nginx.conf
241 --pid-path=/usr/local/nginx/nginx.pid
242 --with-http_ssl_module
243 --with-pcre=../pcre-4.4
244 --with-zlib=../zlib-1.1.3
245 </programlisting>
246 </para>
247
248 <para>
249 После конфигурации
250 nginx компилируется и устанавливается с помощью <command>make</command>.
251 </para>
252
253 </section>
254
255 </article>