Mercurial > hg > nginx-site
comparison xml/ru/docs/configure.xml @ 2154:ebc9fb8139e4
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>—задаёт каталог, | 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 По умолчанию—каталог <path>/usr/local/nginx</path>. | 31 По умолчанию—каталог <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>—задаёт | 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>—задаёт | 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>—задаёт | 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 файла—<path><value>префикс</value>/logs/nginx.pid</path>. | 65 файла—<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>—задаёт | 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 файла—<path><value>префикс</value>/logs/error.log</path>. | 77 файла—<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>—задаёт | 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 файла—<path><value>префикс</value>/logs/access.log</path>. | 89 файла—<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>—задаёт | 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>—задаёт | 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>—задаёт | 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>—разрешает или запрещает | 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 более подходящего метода—kqueue, epoll или /dev/poll. | 130 более подходящего метода—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>—разрешает или запрещает | 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 более подходящего метода—kqueue, epoll или /dev/poll. | 141 более подходящего метода—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>—запрещает сборку модуля | 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>—запрещает сборку модуля | 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>—запрещает сборку | 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>—разрешает сборку модуля | 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>—задаёт | 188 <tag-desc> |
183 путь к исходным текстам библиотеки PCRE. | 189 задаёт путь к исходным текстам библиотеки PCRE. |
184 Дистрибутив библиотеки (версию | 190 Дистрибутив библиотеки (версию |
185 4.4—8.41) нужно взять на сайте <link url="http://www.pcre.org">PCRE</link> | 191 4.4—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>—собирает библиотеку 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>—задаёт | 213 <tag-desc> |
207 путь к исходным текстам библиотеки zlib. Дистрибутив библиотеки (версию | 214 задаёт путь к исходным текстам библиотеки zlib. |
215 Дистрибутив библиотеки (версию | |
208 1.1.3—1.2.11) нужно взять на сайте | 216 1.1.3—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>—задаёт | 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>—задаёт | 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 |