Mercurial > hg > nginx-site
comparison xml/ru/docs/install.xml @ 271:4c6d2c614d2c
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=<<value>путь</value>></command>—задаёт каталог, | 19 <literal>--prefix=<value>путь</value></literal>—задаёт каталог, |
20 в котором будут находиться файлы сервера. | 20 в котором будут находиться файлы сервера. |
21 Этот же каталог будет использоваться для всех относительных путей, | 21 Этот же каталог будет использоваться для всех относительных путей, |
22 задаваемых <command>./configure</command> (кроме путей к исходным текстам | 22 задаваемых <command>configure</command> (кроме путей к исходным текстам |
23 библиотек) и в конфигурационном файле <command>nginx.conf</command>. | 23 библиотек) и в конфигурационном файле <path>nginx.conf</path>. |
24 По умолчанию—каталог <command>/usr/local/nginx</command>. | 24 По умолчанию—каталог <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=<<value>путь</value>></command>—задаёт | 30 <literal>--sbin-path=<value>путь</value></literal>—задаёт |
31 имя исполняемого файла nginx. | 31 имя исполняемого файла nginx. |
32 Это имя используется только на стадии установки. | 32 Это имя используется только на стадии установки. |
33 По умолчанию файл называется | 33 По умолчанию файл называется |
34 <command><<value>prefix</value>>/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=<<value>путь</value>></command>—задаёт | 40 <literal>--conf-path=<value>путь</value></literal>—задаёт |
41 имя конфигурационного файла <command>nginx.conf</command>. | 41 имя конфигурационного файла <path>nginx.conf</path>. |
42 При желании nginx можно всегда запустить с другим конфигурационным файлом, | 42 При желании nginx можно всегда запустить с другим конфигурационным файлом, |
43 указав его в параметре командной строки | 43 указав его в параметре командной строки |
44 <nobr><command>-c <<value>файл</value>></command></nobr>. | 44 <nobr><literal>-c <value>файл</value></literal></nobr>. |
45 По умолчанию файл называется | 45 По умолчанию файл называется |
46 <command><<value>prefix</value>>/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=<<value>путь</value>></command>—задаёт | 52 <literal>--pid-path=<value>путь</value></literal>—задаёт |
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 файла—<command><<value>prefix</value>>/logs/nginx.pid</command>. | 58 файла—<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=<<value>путь</value>></command>—задаёт | 64 <literal>--error-log-path=<value>путь</value></literal>—задаёт |
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 файла—<command><<value>prefix</value>>/logs/error.log</command>. | 70 файла—<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=<<value>путь</value>></command>—задаёт | 76 <literal>--http-log-path=<value>путь</value></literal>—задаёт |
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 файла—<command><<value>prefix</value>>/logs/access.log</command>. | 82 файла—<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=<<value>имя</value>></command>—задаёт | 88 <literal>--user=<value>имя</value></literal>—задаёт |
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=<<value>имя</value>></command>—задаёт | 100 <literal>--group=<value>имя</value></literal>—задаёт |
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>—разрешает или запрещает | 112 <literal>--without-select_module</literal>—разрешает или запрещает |
113 сборку модуля для работы сервера с помощью метода <c-func>select</c-func>. | 113 сборку модуля для работы сервера с помощью метода <c-func>select</c-func>. |
114 Этот модуль собирается автоматически, если на платформе не обнаружено | 114 Этот модуль собирается автоматически, если на платформе не обнаружено |
115 более подходящего метода—kqueue, epoll, rtsig или /dev/poll. | 115 более подходящего метода—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>—разрешает или запрещает | 122 <literal>--without-poll_module</literal>—разрешает или запрещает |
123 сборку модуля для работы сервера с помощью метода <c-func>poll</c-func>. | 123 сборку модуля для работы сервера с помощью метода <c-func>poll</c-func>. |
124 Этот модуль собирается автоматически, если на платформе не обнаружено | 124 Этот модуль собирается автоматически, если на платформе не обнаружено |
125 более подходящего метода—kqueue, epoll, rtsig или /dev/poll. | 125 более подходящего метода—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>—запрещает сборку модуля | 131 <literal>--without-http_gzip_module</literal>—запрещает сборку модуля |
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>—запрещает сборку модуля | 139 <literal>--without-http_rewrite_module</literal>—запрещает сборку модуля |
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 Модуль экспериментальный—директивы модуля впоследствии могут измениться. | 143 Модуль экспериментальный—директивы модуля впоследствии могут измениться. |
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>—запрещает сборку | 149 <literal>--without-http_proxy_module</literal>—запрещает сборку |
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>—разрешает сборку модуля | 160 <literal>--with-http_ssl_module</literal>—разрешает сборку модуля |
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=<<value>путь</value>></command>—задаёт | 170 <literal>--with-pcre=<value>путь</value></literal>—задаёт |
171 путь к исходным текстам библиотеки PCRE. | 171 путь к исходным текстам библиотеки PCRE. |
172 Дистрибутив библиотеки (версию | 172 Дистрибутив библиотеки (версию |
173 4.4—6.1) нужно взять на сайте <link url="http://www.pcre.org">PCRE</link> | 173 4.4—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=<<value>путь</value>></command>—задаёт | 185 <literal>--with-zlib=<value>путь</value></literal>—задаёт |
186 путь к исходным текстам библиотеки zlib. Дистрибутив библиотеки (версию | 186 путь к исходным текстам библиотеки zlib. Дистрибутив библиотеки (версию |
187 1.1.3—1.2.2) нужно взять на сайте | 187 1.1.3—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=<<value>параметры</value>></command>—задаёт | 197 <literal>--with-cc-opt=<value>параметры</value></literal>—задаёт |
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=<<value>параметры</value>></command>—задаёт | 209 <literal>--with-ld-opt=<value>параметры</value></literal>—задаёт |
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 |