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> |