Mercurial > hg > nginx-site

comparison xml/ru/docs/install.xml @ 271:4c6d2c614d2c

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Cleaned up XML tag mess: - all of <parameter> and <code>, and some of <dirname>, <value>, and <command> were replaced by <literal>; - the rest of <dirname> were replaced by links; - <argument> were replaced by <value>; - <value> is now rendered in HTML in italic; - <literal> and <path> can now contain <value>. Cleaned up terminology mess: - directives take "parameters".
author Ruslan Ermilov <ru@nginx.com>
date Fri, 23 Dec 2011 17:29:59 +0000
parents e93ece6bd34e
children 64107bc400c4
comparison
equal deleted inserted replaced
270:945d7299c26c 271:4c6d2c614d2c
8 8
9 <para> 9 <para>
10 Конфигурация сборки осуществляется командой <command>configure</command>. 10 Конфигурация сборки осуществляется командой <command>configure</command>.
11 Она определяет особенности системы и, в частности, методы, которые nginx 11 Она определяет особенности системы и, в частности, методы, которые nginx
12 может использовать для обработки соединений. 12 может использовать для обработки соединений.
13 В конце концов она создаёт <command>Makefile</command>. 13 В конце концов она создаёт <path>Makefile</path>.
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 <literal>--prefix=<value>путь</value></literal>&mdash;задаёт каталог,
20 в котором будут находиться файлы сервера. 20 в котором будут находиться файлы сервера.
21 Этот же каталог будет использоваться для всех относительных путей, 21 Этот же каталог будет использоваться для всех относительных путей,
22 задаваемых <command>./configure</command> (кроме путей к исходным текстам 22 задаваемых <command>configure</command> (кроме путей к исходным текстам
23 библиотек) и в конфигурационном файле <command>nginx.conf</command>. 23 библиотек) и в конфигурационном файле <path>nginx.conf</path>.
24 По умолчанию&mdash;каталог <command>/usr/local/nginx</command>. 24 По умолчанию&mdash;каталог <path>/usr/local/nginx</path>.
25 </para> 25 </para>
26 </listitem> 26 </listitem>
27 27
28 <listitem> 28 <listitem>
29 <para> 29 <para>
30 <command>--sbin-path=&lt;<value>путь</value>&gt;</command>&mdash;задаёт 30 <literal>--sbin-path=<value>путь</value></literal>&mdash;задаёт
31 имя исполняемого файла nginx. 31 имя исполняемого файла nginx.
32 Это имя используется только на стадии установки. 32 Это имя используется только на стадии установки.
33 По умолчанию файл называется 33 По умолчанию файл называется
34 <command>&lt;<value>prefix</value>&gt;/sbin/nginx</command>. 34 <path><value>префикс</value>/sbin/nginx</path>.
35 </para> 35 </para>
36 </listitem> 36 </listitem>
37 37
38 <listitem> 38 <listitem>
39 <para> 39 <para>
40 <command>--conf-path=&lt;<value>путь</value>&gt;</command>&mdash;задаёт 40 <literal>--conf-path=<value>путь</value></literal>&mdash;задаёт
41 имя конфигурационного файла <command>nginx.conf</command>. 41 имя конфигурационного файла <path>nginx.conf</path>.
42 При желании nginx можно всегда запустить с другим конфигурационным файлом, 42 При желании nginx можно всегда запустить с другим конфигурационным файлом,
43 указав его в параметре командной строки 43 указав его в параметре командной строки
44 <nobr><command>-c &lt;<value>файл</value>&gt;</command></nobr>. 44 <nobr><literal>-c <value>файл</value></literal></nobr>.
45 По умолчанию файл называется 45 По умолчанию файл называется
46 <command>&lt;<value>prefix</value>&gt;/conf/nginx.conf</command>. 46 <path><value>префикс</value>/conf/nginx.conf</path>.
47 </para> 47 </para>
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 <literal>--pid-path=<value>путь</value></literal>&mdash;задаёт
53 имя файла nginx.pid, в котором будет храниться номер главного процесса. 53 имя файла nginx.pid, в котором будет храниться номер главного процесса.
54 После установки имя файла можно всегда поменять в конфигурационном 54 После установки имя файла можно всегда поменять в конфигурационном
55 файле <command>nginx.conf</command> с помощью директивы 55 файле <path>nginx.conf</path> с помощью директивы
56 <link doc="ngx_core_module.xml" id="pid"/>. 56 <link doc="ngx_core_module.xml" id="pid"/>.
57 По умолчанию имя 57 По умолчанию имя
58 файла&mdash;<command>&lt;<value>prefix</value>&gt;/logs/nginx.pid</command>. 58 файла&mdash;<path><value>префикс</value>/logs/nginx.pid</path>.
59 </para> 59 </para>
60 </listitem> 60 </listitem>
61 61
62 <listitem> 62 <listitem>
63 <para> 63 <para>
64 <command>--error-log-path=&lt;<value>путь</value>&gt;</command>&mdash;задаёт 64 <literal>--error-log-path=<value>путь</value></literal>&mdash;задаёт
65 имя основного файла ошибок, предупреждений и диагностики. 65 имя основного файла ошибок, предупреждений и диагностики.
66 После установки имя файла можно всегда поменять в конфигурационном 66 После установки имя файла можно всегда поменять в конфигурационном
67 файле <command>nginx.conf</command> с помощью директивы 67 файле <path>nginx.conf</path> с помощью директивы
68 <link doc="ngx_core_module.xml" id="error_log"/>. 68 <link doc="ngx_core_module.xml" id="error_log"/>.
69 По умолчанию имя 69 По умолчанию имя
70 файла&mdash;<command>&lt;<value>prefix</value>&gt;/logs/error.log</command>. 70 файла&mdash;<path><value>префикс</value>/logs/error.log</path>.
71 </para> 71 </para>
72 </listitem> 72 </listitem>
73 73
74 <listitem> 74 <listitem>
75 <para> 75 <para>
76 <command>--http-log-path=&lt;<value>путь</value>&gt;</command>&mdash;задаёт 76 <literal>--http-log-path=<value>путь</value></literal>&mdash;задаёт
77 имя основного файла регистрации запросов HTTP-сервера. 77 имя основного файла регистрации запросов HTTP-сервера.
78 После установки имя файла можно всегда поменять в конфигурационном 78 После установки имя файла можно всегда поменять в конфигурационном
79 файле <command>nginx.conf</command> с помощью директивы 79 файле <path>nginx.conf</path> с помощью директивы
80 <link doc="http/ngx_http_log_module.xml" id="access_log"/>. 80 <link doc="http/ngx_http_log_module.xml" id="access_log"/>.
81 По умолчанию имя 81 По умолчанию имя
82 файла&mdash;<command>&lt;<value>prefix</value>&gt;/logs/access.log</command>. 82 файла&mdash;<path><value>префикс</value>/logs/access.log</path>.
83 </para> 83 </para>
84 </listitem> 84 </listitem>
85 85
86 <listitem> 86 <listitem>
87 <para> 87 <para>
88 <command>--user=&lt;<value>имя</value>&gt;</command>&mdash;задаёт 88 <literal>--user=<value>имя</value></literal>&mdash;задаёт
89 имя непривилегированного пользователя, с правами которого будут 89 имя непривилегированного пользователя, с правами которого будут
90 выполняться рабочие процессы. 90 выполняться рабочие процессы.
91 После установки это имя можно всегда поменять в конфигурационном 91 После установки это имя можно всегда поменять в конфигурационном
92 файле <command>nginx.conf</command> с помощью директивы 92 файле <path>nginx.conf</path> с помощью директивы
93 <link doc="ngx_core_module.xml" id="user"/>. 93 <link doc="ngx_core_module.xml" id="user"/>.
94 По умолчанию имя пользователя nobody. 94 По умолчанию имя пользователя nobody.
95 </para> 95 </para>
96 </listitem> 96 </listitem>
97 97
98 <listitem> 98 <listitem>
99 <para> 99 <para>
100 <command>--group=&lt;<value>имя</value>&gt;</command>&mdash;задаёт 100 <literal>--group=<value>имя</value></literal>&mdash;задаёт
101 имя группы, с правами которой будут выполняться рабочие процессы. 101 имя группы, с правами которой будут выполняться рабочие процессы.
102 После установки это имя можно всегда поменять в конфигурационном 102 После установки это имя можно всегда поменять в конфигурационном
103 файле <command>nginx.conf</command> с помощью директивы 103 файле <path>nginx.conf</path> с помощью директивы
104 <link doc="ngx_core_module.xml" id="user"/>. 104 <link doc="ngx_core_module.xml" id="user"/>.
105 По умолчанию группа совпадает с именем непривилегированного пользователя. 105 По умолчанию группа совпадает с именем непривилегированного пользователя.
106 </para> 106 </para>
107 </listitem> 107 </listitem>
108 108
109 <listitem> 109 <listitem>
110 <para> 110 <para>
111 <command>--with-select_module</command><br/> 111 <literal>--with-select_module</literal><br/>
112 <command>--without-select_module</command>&mdash;разрешает или запрещает 112 <literal>--without-select_module</literal>&mdash;разрешает или запрещает
113 сборку модуля для работы сервера с помощью метода <c-func>select</c-func>. 113 сборку модуля для работы сервера с помощью метода <c-func>select</c-func>.
114 Этот модуль собирается автоматически, если на платформе не обнаружено 114 Этот модуль собирается автоматически, если на платформе не обнаружено
115 более подходящего метода&mdash;kqueue, epoll, rtsig или /dev/poll. 115 более подходящего метода&mdash;kqueue, epoll, rtsig или /dev/poll.
116 </para> 116 </para>
117 </listitem> 117 </listitem>
118 118
119 <listitem> 119 <listitem>
120 <para> 120 <para>
121 <command>--with-poll_module</command><br/> 121 <literal>--with-poll_module</literal><br/>
122 <command>--without-poll_module</command>&mdash;разрешает или запрещает 122 <literal>--without-poll_module</literal>&mdash;разрешает или запрещает
123 сборку модуля для работы сервера с помощью метода <c-func>poll</c-func>. 123 сборку модуля для работы сервера с помощью метода <c-func>poll</c-func>.
124 Этот модуль собирается автоматически, если на платформе не обнаружено 124 Этот модуль собирается автоматически, если на платформе не обнаружено
125 более подходящего метода&mdash;kqueue, epoll, rtsig или /dev/poll. 125 более подходящего метода&mdash;kqueue, epoll, rtsig или /dev/poll.
126 </para> 126 </para>
127 </listitem> 127 </listitem>
128 128
129 <listitem> 129 <listitem>
130 <para> 130 <para>
131 <command>--without-http_gzip_module</command>&mdash;запрещает сборку модуля 131 <literal>--without-http_gzip_module</literal>&mdash;запрещает сборку модуля
132 <link doc="http/ngx_http_gzip_module.xml">сжатия ответов</link> HTTP-сервера. 132 <link doc="http/ngx_http_gzip_module.xml">сжатия ответов</link> HTTP-сервера.
133 Для сборки и работы этого модуля нужна библиотека zlib. 133 Для сборки и работы этого модуля нужна библиотека zlib.
134 </para> 134 </para>
135 </listitem> 135 </listitem>
136 136
137 <listitem> 137 <listitem>
138 <para> 138 <para>
139 <command>--without-http_rewrite_module</command>&mdash;запрещает сборку модуля 139 <literal>--without-http_rewrite_module</literal>&mdash;запрещает сборку модуля
140 HTTP-сервера, позволяющего <link doc="http/ngx_http_rewrite_module.xml">делать 140 HTTP-сервера, позволяющего <link doc="http/ngx_http_rewrite_module.xml">делать
141 перенаправления и менять URI запросов</link>. 141 перенаправления и менять URI запросов</link>.
142 Для сборки и работы этого модуля нужна библиотека PCRE. 142 Для сборки и работы этого модуля нужна библиотека PCRE.
143 Модуль экспериментальный&mdash;директивы модуля впоследствии могут измениться. 143 Модуль экспериментальный&mdash;директивы модуля впоследствии могут измениться.
144 </para> 144 </para>
145 </listitem> 145 </listitem>
146 146
147 <listitem> 147 <listitem>
148 <para> 148 <para>
149 <command>--without-http_proxy_module</command>&mdash;запрещает сборку 149 <literal>--without-http_proxy_module</literal>&mdash;запрещает сборку
150 <link doc="http/ngx_http_proxy_module.xml">проксирующего модуля</link> 150 <link doc="http/ngx_http_proxy_module.xml">проксирующего модуля</link>
151 HTTP-сервера. 151 HTTP-сервера.
152 <!-- 152 <!--
153 Для сборки и работы этого модуля нужна библиотека md5. 153 Для сборки и работы этого модуля нужна библиотека md5.
154 --> 154 -->
155 </para> 155 </para>
156 </listitem> 156 </listitem>
157 157
158 <listitem> 158 <listitem>
159 <para> 159 <para>
160 <command>--with-http_ssl_module</command>&mdash;разрешает сборку модуля 160 <literal>--with-http_ssl_module</literal>&mdash;разрешает сборку модуля
161 для работы HTTP-сервера по <link doc="http/ngx_http_ssl_module.xml">протоколу 161 для работы HTTP-сервера по <link doc="http/ngx_http_ssl_module.xml">протоколу
162 HTTPS</link>. 162 HTTPS</link>.
163 По умолчанию модуль не собирается. 163 По умолчанию модуль не собирается.
164 Для сборки и работы этого модуля нужна библиотека OpenSSL. 164 Для сборки и работы этого модуля нужна библиотека OpenSSL.
165 </para> 165 </para>
166 </listitem> 166 </listitem>
167 167
168 <listitem> 168 <listitem>
169 <para> 169 <para>
170 <command>--with-pcre=&lt;<value>путь</value>&gt;</command>&mdash;задаёт 170 <literal>--with-pcre=<value>путь</value></literal>&mdash;задаёт
171 путь к исходным текстам библиотеки PCRE. 171 путь к исходным текстам библиотеки PCRE.
172 Дистрибутив библиотеки (версию 172 Дистрибутив библиотеки (версию
173 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>
174 и распаковать. 174 и распаковать.
175 Всё остальное сделают ./configure nginx'а и make. 175 Всё остальное сделают ./configure nginx'а и make.
180 </para> 180 </para>
181 </listitem> 181 </listitem>
182 182
183 <listitem> 183 <listitem>
184 <para> 184 <para>
185 <command>--with-zlib=&lt;<value>путь</value>&gt;</command>&mdash;задаёт 185 <literal>--with-zlib=<value>путь</value></literal>&mdash;задаёт
186 путь к исходным текстам библиотеки zlib. Дистрибутив библиотеки (версию 186 путь к исходным текстам библиотеки zlib. Дистрибутив библиотеки (версию
187 1.1.3&mdash;1.2.2) нужно взять на сайте 187 1.1.3&mdash;1.2.2) нужно взять на сайте
188 <link url="http://www.gzip.org/zlib/">zlib</link> и распаковать. 188 <link url="http://www.gzip.org/zlib/">zlib</link> и распаковать.
189 Всё остальное сделают ./configure nginx'а и make. 189 Всё остальное сделают ./configure nginx'а и make.
190 Библиотека нужна для модуля 190 Библиотека нужна для модуля
192 </para> 192 </para>
193 </listitem> 193 </listitem>
194 194
195 <listitem> 195 <listitem>
196 <para> 196 <para>
197 <command>--with-cc-opt=&lt;<value>параметры</value>&gt;</command>&mdash;задаёт 197 <literal>--with-cc-opt=<value>параметры</value></literal>&mdash;задаёт
198 дополнительные параметры, которые будут добавлены к переменной CFLAGS. 198 дополнительные параметры, которые будут добавлены к переменной CFLAGS.
199 При использовании системной библиотеки PCRE во FreeBSD, нужно указать 199 При использовании системной библиотеки PCRE во FreeBSD, нужно указать
200 <command>--with-cc-opt="-I /usr/local/include"</command>. 200 <literal>--with-cc-opt="-I /usr/local/include"</literal>.
201 Если нужно увеличить число файлов, с которыми может работать 201 Если нужно увеличить число файлов, с которыми может работать
202 <c-func>select</c-func>, то это тоже можно задать здесь же: 202 <c-func>select</c-func>, то это тоже можно задать здесь же:
203 <command>--with-cc-opt="-D FD_SETSIZE=2048"</command>. 203 <literal>--with-cc-opt="-D FD_SETSIZE=2048"</literal>.
204 </para> 204 </para>
205 </listitem> 205 </listitem>
206 206
207 <listitem> 207 <listitem>
208 <para> 208 <para>
209 <command>--with-ld-opt=&lt;<value>параметры</value>&gt;</command>&mdash;задаёт 209 <literal>--with-ld-opt=<value>параметры</value></literal>&mdash;задаёт
210 дополнительные параметры, которые будут использованы при линковке. 210 дополнительные параметры, которые будут использованы при линковке.
211 При использовании системной библиотеки PCRE во FreeBSD, нужно указать 211 При использовании системной библиотеки PCRE во FreeBSD, нужно указать
212 <command>--with-ld-opt="-L /usr/local/lib"</command>. 212 <literal>--with-ld-opt="-L /usr/local/lib"</literal>.
213 </para> 213 </para>
214 </listitem> 214 </listitem>
215 215
216 </list> 216 </list>
217 217