Mercurial > hg > nginx-site

comparison xml/ru/docs/configure.xml @ 2154:ebc9fb8139e4

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