Mercurial > hg > nginx-site

comparison xml/ru/docs/install.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 65e75e59a714
children b93422ca9fe7
comparison
equal deleted inserted replaced
923:4f1e2120be5e 924:a2aea48ff155
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/install.html" 9 link="/ru/docs/install.html"
10 lang="ru" 10 lang="ru"
11 rev="3"> 11 rev="1"
12 toc="no">
12 13
13 <section> 14 <section>
14 15
15 <para> 16 <para>
16 Конфигурация сборки осуществляется командой <command>configure</command>. 17 nginx устанавливается по-разному в зависимости от операционной системы.
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 Всё остальное сделают ./configure nginx’а и make.
181 Библиотека нужна для использования регулярных выражений в директиве
182 <link doc="http/ngx_http_core_module.xml" id="location"/>
183 и для модуля
184 <link doc="http/ngx_http_rewrite_module.xml">ngx_http_rewrite_module</link>.
185 </para>
186 </listitem>
187
188 <listitem>
189 <para>
190 <literal>--with-pcre-jit</literal>&mdash;собирает библиотеку PCRE с
191 поддержкой JIT-компиляции (1.1.12, директива
192 <link doc="ngx_core_module.xml" id="pcre_jit"/>).
193 </para>
194 </listitem>
195
196 <listitem>
197 <para>
198 <literal>--with-zlib=<value>путь</value></literal>&mdash;задаёт
199 путь к исходным текстам библиотеки zlib. Дистрибутив библиотеки (версию
200 1.1.3&mdash;1.2.7) нужно взять на сайте
201 <link url="http://zlib.net">zlib</link> и распаковать.
202 Всё остальное сделают ./configure nginx’а и make.
203 Библиотека нужна для модуля
204 <link doc="http/ngx_http_gzip_module.xml">ngx_http_gzip_module</link>.
205 </para>
206 </listitem>
207
208 <listitem>
209 <para>
210 <literal>--with-cc-opt=<value>параметры</value></literal>&mdash;задаёт
211 дополнительные параметры, которые будут добавлены к переменной CFLAGS.
212 При использовании системной библиотеки PCRE во FreeBSD, нужно указать
213 <literal>--with-cc-opt="-I /usr/local/include"</literal>.
214 Если нужно увеличить число файлов, с которыми может работать
215 <c-func>select</c-func>, то это тоже можно задать здесь же:
216 <literal>--with-cc-opt="-D FD_SETSIZE=2048"</literal>.
217 </para>
218 </listitem>
219
220 <listitem>
221 <para>
222 <literal>--with-ld-opt=<value>параметры</value></literal>&mdash;задаёт
223 дополнительные параметры, которые будут использованы при линковке.
224 При использовании системной библиотеки PCRE во FreeBSD, нужно указать
225 <literal>--with-ld-opt="-L /usr/local/lib"</literal>.
226 </para>
227 </listitem>
228
229 </list>
230
231 </para> 18 </para>
232 19
20 </section>
21
22
23 <section id="linux" name="Установка на Linux">
24
233 <para> 25 <para>
234 Пример использования параметров (всё это нужно набрать в одной строке): 26 Для установки nginx на Linux могут быть использованы
235 <programlisting> 27 <link doc="../linux_packages.xml">пакеты</link> с nginx.org.
236 ./configure 28 </para>
237 --sbin-path=/usr/local/nginx/nginx 29
238 --conf-path=/usr/local/nginx/nginx.conf 30 </section>
239 --pid-path=/usr/local/nginx/nginx.pid 31
240 --with-http_ssl_module 32
241 --with-pcre=../pcre-4.4 33 <section id="freebsd" name="Установка на FreeBSD">
242 --with-zlib=../zlib-1.1.3 34
243 </programlisting> 35 <para>
36 На FreeBSD можно установить nginx либо из
37 <link
38 url="http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/packages-using.html">
39 пакетов</link>, либо с помощью системы
40 <link url="http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/ports-using.html">
41 портов</link>.
42 Система портов даёт большую гибкость, позволяя выбирать из широкого
43 набора настроек.
44 Порт скомпилирует nginx с выбранными опциями и установит.
45 </para>
46
47 </section>
48
49
50 <section id="source_install" name="Сборка из исходных файлов">
51
52 <para>
53 Если необходима специфическая функциональность, недоступная из пакетов или
54 портов, можно скомпилировать nginx из исходного кода.
55 Будучи наиболее гибким, этот подход может быть сложным для начинающего.
56 <link doc="configure.xml"/> освещает этот вопрос более подробно.
244 </para> 57 </para>
245 58
246 </section> 59 </section>
247 60
248 </article> 61 </article>