Mercurial > hg > nginx-site
comparison xml/ru/docs/install.xml @ 76:4a4caa566120
Russian documentation import.
Changes in module.dtd: <example> now allowed to contain <value> and
<emphasis> elements (we need this to show important parts in examples),
less strict checking of <directive> syntax (we don't want to fully
document some directives, notably deprecated ones).
Known issues:
1. <syntax> elements are preserved as is, they will require manual conversion
(likely to some not-yet-existed format a la DocBook cmdsynopsis, as
currently used one seems to be incomplete);
2. <value> no longer corresponds to replaceable content, and it's use in
examples isn't correct;
3. <link doc="document#fragment"> doesn't work with current xslt, either
should be supported or changed to <link doc="document" id="fragment">.
The following files are intentionally omitted: maillists.xml (support.xml
should be used instead), experimental.xml (obsolete), faq.xml (conflicts
with existing one, needs discussion).
Not yet linked to site.
author | Maxim Dounin <mdounin@mdounin.ru> |
---|---|
date | Tue, 11 Oct 2011 12:57:50 +0000 |
parents | |
children | 7db449e89e92 |
comparison
equal
deleted
inserted
replaced
75:2bf4cd2787c5 | 76:4a4caa566120 |
---|---|
1 <!DOCTYPE article SYSTEM "../../../dtd/article.dtd"> | |
2 | |
3 <article title="Установка nginx" | |
4 link="/ru/docs/install.html" | |
5 lang="ru"> | |
6 | |
7 <section> | |
8 | |
9 <para> | |
10 Конфигурация сборки осуществляется командой <command>configure</command>. | |
11 Она определяет особенности системы и, в частности, методы, которые nginx | |
12 может использовать для обработки соединений. | |
13 В конце концов она создаёт <command>Makefile</command>. | |
14 <command>configure</command> поддерживает следующие параметры: | |
15 <list> | |
16 | |
17 <listitem> | |
18 <para> | |
19 <command>--prefix=<<value>путь</value>></command>—задаёт каталог, | |
20 в котором будут находиться файлы сервера. | |
21 Этот же каталог будет использоваться для всех относительных путей, | |
22 задаваемых <command>./configure</command> (кроме путей к исходным текстам | |
23 библиотек) и в конфигурационном файле <command>nginx.conf</command>. | |
24 По умолчанию—каталог <command>/usr/local/nginx</command>. | |
25 </para> | |
26 </listitem> | |
27 | |
28 <listitem> | |
29 <para> | |
30 <command>--sbin-path=<<value>путь</value>></command>—задаёт | |
31 имя исполняемого файла nginx. | |
32 Это имя используется только на стадии установки. | |
33 По умолчанию файл называется | |
34 <command><<value>prefix</value>>/sbin/nginx</command>. | |
35 </para> | |
36 </listitem> | |
37 | |
38 <listitem> | |
39 <para> | |
40 <command>--conf-path=<<value>путь</value>></command>—задаёт | |
41 имя конфигурационного файла <command>nginx.conf</command>. | |
42 При желании nginx можно всегда запустить с другим конфигурационным файлом, | |
43 указав его в параметре командной строки | |
44 <nobr><command>-c <<value>файл</value>></command></nobr>. | |
45 По умолчанию файл называется | |
46 <command><<value>prefix</value>>/conf/nginx.conf</command>. | |
47 </para> | |
48 </listitem> | |
49 | |
50 <listitem> | |
51 <para> | |
52 <command>--pid-path=<<value>путь</value>></command>—задаёт | |
53 имя файла nginx.pid, в котором будет хранится номер главного процесса. | |
54 После установки имя файла можно всегда поменять в конфигурационном | |
55 файле <command>nginx.conf</command> с помощью директивы <dirname>pid</dirname>. | |
56 По умолчанию имя | |
57 файла—<command><<value>prefix</value>>/logs/nginx.pid</command>. | |
58 </para> | |
59 </listitem> | |
60 | |
61 <listitem> | |
62 <para> | |
63 <command>--error-log-path=<<value>путь</value>></command>—задаёт | |
64 имя основного файла ошибок, предупреждений и диагностики. | |
65 После установки имя файла можно всегда поменять в конфигурационном | |
66 файле <command>nginx.conf</command> с помощью директивы | |
67 <dirname>error_log</dirname>. | |
68 По умолчанию имя | |
69 файла—<command><<value>prefix</value>>/logs/error.log</command>. | |
70 </para> | |
71 </listitem> | |
72 | |
73 <listitem> | |
74 <para> | |
75 <command>--http-log-path=<<value>путь</value>></command>—задаёт | |
76 имя основного файла регистрации запросов http сервера. | |
77 После установки имя файла можно всегда поменять в конфигурационном | |
78 файле <command>nginx.conf</command> с помощью директивы | |
79 <dirname>access_log</dirname>. | |
80 По умолчанию имя | |
81 файла—<command><<value>prefix</value>>/logs/access.log</command>. | |
82 </para> | |
83 </listitem> | |
84 | |
85 <listitem> | |
86 <para> | |
87 <command>--user=<<value>имя</value>></command>—задаёт | |
88 имя непривилегированного пользователя, с правами которого будут | |
89 выполняться рабочие процессы. | |
90 После установки это имя можно всегда поменять в конфигурационном | |
91 файле <command>nginx.conf</command> с помощью директивы | |
92 <dirname>user</dirname>. | |
93 По умолчанию имя пользователя nobody. | |
94 </para> | |
95 </listitem> | |
96 | |
97 <listitem> | |
98 <para> | |
99 <command>--group=<<value>группа</value>></command>—задаёт | |
100 группу, с правами которой будут выполняться рабочие процессы. | |
101 После установки это имя можно всегда поменять в конфигурационном | |
102 файле <command>nginx.conf</command> с помощью директивы <dirname>user</dirname>. | |
103 По умолчанию группа совпадает с именем непривилегированного пользователя. | |
104 </para> | |
105 </listitem> | |
106 | |
107 <listitem> | |
108 <para> | |
109 <command>--with-select_module</command><br/> | |
110 <command>--without-select_module</command>—разрешает или запрещает | |
111 сборку модуля для работы сервера с помощью метода select. | |
112 Этот модуль собирается автоматически, если на платформе не обнаружено | |
113 более подходящего метода—kqueue, epoll, rtsig или /dev/poll. | |
114 </para> | |
115 </listitem> | |
116 | |
117 <listitem> | |
118 <para> | |
119 <command>--with-poll_module</command><br/> | |
120 <command>--without-poll_module</command>—разрешает или запрещает | |
121 сборку модуля для работы сервера с помощью метода poll. | |
122 Этот модуль собирается автоматически, если на платформе не обнаружено | |
123 более подходящего метода—kqueue, epoll, rtsig или /dev/poll. | |
124 </para> | |
125 </listitem> | |
126 | |
127 <listitem> | |
128 <para> | |
129 <command>--without-http_gzip_module</command>—запрещает сборку модуля | |
130 сжатия ответов http сервера. | |
131 Для сборки и работы этого модуля нужна библиотека zlib. | |
132 </para> | |
133 </listitem> | |
134 | |
135 <listitem> | |
136 <para> | |
137 <command>--without-http_rewrite_module</command>—запрещает сборку модуля | |
138 http сервера, позволяющего делать редиректы и менять URI запросов. | |
139 Для сборки и работы этого модуля нужна библиотека PCRE. | |
140 Модуль экспериментальный—директивы модуля впоследствии могут измениться. | |
141 </para> | |
142 </listitem> | |
143 | |
144 <listitem> | |
145 <para> | |
146 <command>--without-http_proxy_module</command>—запрещает сборку | |
147 проксирующего модуля http сервера. | |
148 <!-- | |
149 Для сборки и работы этого модуля нужна библиотека md5. | |
150 --> | |
151 </para> | |
152 </listitem> | |
153 | |
154 <listitem> | |
155 <para> | |
156 <command>--with-http_ssl_module</command>—разрешает сборку модуля | |
157 для работы http сервера по протоколу HTTPS. По умолчанию модуль не собирается. | |
158 Для сборки и работы этого модуля нужна библиотека OpenSSL. | |
159 </para> | |
160 </listitem> | |
161 | |
162 <listitem> | |
163 <para> | |
164 <command>--with-pcre=<<value>путь</value>></command>—задаёт | |
165 путь к исходным текстам библиотеки PCRE. Дистрибутив библиотеки (версию | |
166 4.4—6.1) нужно взять на сайте <link url="http://www.pcre.org">PCRE</link> | |
167 и распаковать. | |
168 Всё остальное сделают nginx'овские ./configure и make. | |
169 Библиотека нужна для использования регулярных выражений в | |
170 <dirname>location</dirname> и для модуля ngx_http_rewrite_module. | |
171 </para> | |
172 </listitem> | |
173 | |
174 <listitem> | |
175 <para> | |
176 <command>--with-zlib=<<value>путь</value>></command>—задаёт | |
177 путь к исходным текстам библиотеки zlib. Дистрибутив библиотеки (версию | |
178 1.1.3—1.2.2) нужно взять на сайте | |
179 <link url="http://www.gzip.org/zlib/">zlib</link> и распаковать. | |
180 Всё остальное сделают nginx'овские ./configure и make. | |
181 Библиотека нужна для модуля ngx_http_gzip_module. | |
182 </para> | |
183 </listitem> | |
184 | |
185 <listitem> | |
186 <para> | |
187 <command>--with-cc-opt=<<value>параметры</value>></command>—задаёт | |
188 дополнительные параметры, которые будут добавлены к переменной CFLAGS. | |
189 При использовании системной библиотеки PCRE во FreeBSD, нужно указать | |
190 <command>--with-cc-opt="-I /usr/local/include"</command>. | |
191 Если нужно увеличить число файлов, с которыми может работать select(), | |
192 то это тоже можно задать здесь же: | |
193 <command>--with-cc-opt="-D FD_SETSIZE=2048"</command>. | |
194 </para> | |
195 </listitem> | |
196 | |
197 <listitem> | |
198 <para> | |
199 <command>--with-ld-opt=<<value>параметры</value>></command>—задаёт | |
200 дополнительные параметры, которые будут использованы при линковке. | |
201 При использовании системной библиотеки PCRE во FreeBSD, нужно указать | |
202 <command>--with-ld-opt="-L /usr/local/lib"</command>. | |
203 </para> | |
204 </listitem> | |
205 | |
206 </list> | |
207 | |
208 </para> | |
209 | |
210 <para> | |
211 Пример использования параметров (всё это нужно набрать в одной строке): | |
212 <programlisting> | |
213 ./configure | |
214 --sbin-path=/usr/local/nginx/nginx | |
215 --conf-path=/usr/local/nginx/nginx.conf | |
216 --pid-path=/usr/local/nginx/nginx.pid | |
217 --with-http_ssl_module | |
218 --with-pcre=../pcre-4.4 | |
219 --with-zlib=../zlib-1.1.3 | |
220 </programlisting> | |
221 </para> | |
222 | |
223 </section> | |
224 | |
225 </article> |