Mercurial > hg > nginx-site

diff xml/ru/docs/install.xml @ 76:4a4caa566120

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
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
line wrap: on
line diff
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/xml/ru/docs/install.xml	Tue Oct 11 12:57:50 2011 +0000
@@ -0,0 +1,225 @@
+<!DOCTYPE article SYSTEM "../../../dtd/article.dtd">
+
+<article title="Установка nginx"
+         link="/ru/docs/install.html"
+         lang="ru">
+
+<section>
+
+<para>
+Конфигурация сборки осуществляется командой <command>configure</command>.
+Она определяет особенности системы и, в частности, методы, которые nginx
+может использовать для обработки соединений.
+В конце концов она создаёт <command>Makefile</command>.
+<command>configure</command> поддерживает следующие параметры:
+<list>
+
+<listitem>
+<para>
+<command>--prefix=&lt;<value>путь</value>&gt;</command>&mdash;задаёт каталог,
+в котором будут находиться файлы сервера.
+Этот же каталог будет использоваться для всех относительных путей,
+задаваемых <command>./configure</command> (кроме путей к исходным текстам
+библиотек) и в конфигурационном файле <command>nginx.conf</command>.
+По умолчанию&mdash;каталог <command>/usr/local/nginx</command>.
+</para>
+</listitem>
+
+<listitem>
+<para>
+<command>--sbin-path=&lt;<value>путь</value>&gt;</command>&mdash;задаёт
+имя исполняемого файла nginx.
+Это имя используется только на стадии установки.
+По умолчанию файл называется
+<command>&lt;<value>prefix</value>&gt;/sbin/nginx</command>.
+</para>
+</listitem>
+
+<listitem>
+<para>
+<command>--conf-path=&lt;<value>путь</value>&gt;</command>&mdash;задаёт
+имя конфигурационного файла <command>nginx.conf</command>.
+При желании nginx можно всегда запустить с другим конфигурационным файлом,
+указав его в параметре командной строки
+<nobr><command>-c &lt;<value>файл</value>&gt;</command></nobr>.
+По умолчанию файл называется
+<command>&lt;<value>prefix</value>&gt;/conf/nginx.conf</command>.
+</para>
+</listitem>
+
+<listitem>
+<para>
+<command>--pid-path=&lt;<value>путь</value>&gt;</command>&mdash;задаёт
+имя файла nginx.pid, в котором будет хранится номер главного процесса.
+После установки имя файла можно всегда поменять в конфигурационном
+файле <command>nginx.conf</command> с помощью директивы <dirname>pid</dirname>.
+По умолчанию имя
+файла&mdash;<command>&lt;<value>prefix</value>&gt;/logs/nginx.pid</command>.
+</para>
+</listitem>
+
+<listitem>
+<para>
+<command>--error-log-path=&lt;<value>путь</value>&gt;</command>&mdash;задаёт
+имя основного файла ошибок, предупреждений и диагностики.
+После установки имя файла можно всегда поменять в конфигурационном
+файле <command>nginx.conf</command> с помощью директивы
+<dirname>error_log</dirname>.
+По умолчанию имя
+файла&mdash;<command>&lt;<value>prefix</value>&gt;/logs/error.log</command>.
+</para>
+</listitem>
+
+<listitem>
+<para>
+<command>--http-log-path=&lt;<value>путь</value>&gt;</command>&mdash;задаёт
+имя основного файла регистрации запросов http сервера.
+После установки имя файла можно всегда поменять в конфигурационном
+файле <command>nginx.conf</command> с помощью директивы
+<dirname>access_log</dirname>.
+По умолчанию имя
+файла&mdash;<command>&lt;<value>prefix</value>&gt;/logs/access.log</command>.
+</para>
+</listitem>
+
+<listitem>
+<para>
+<command>--user=&lt;<value>имя</value>&gt;</command>&mdash;задаёт
+имя непривилегированного пользователя, с правами которого будут
+выполняться рабочие процессы.
+После установки это имя можно всегда поменять в конфигурационном
+файле <command>nginx.conf</command> с помощью директивы
+<dirname>user</dirname>.
+По умолчанию имя пользователя nobody.
+</para>
+</listitem>
+
+<listitem>
+<para>
+<command>--group=&lt;<value>группа</value>&gt;</command>&mdash;задаёт
+группу, с правами которой будут выполняться рабочие процессы.
+После установки это имя можно всегда поменять в конфигурационном
+файле <command>nginx.conf</command> с помощью директивы <dirname>user</dirname>.
+По умолчанию группа совпадает с именем непривилегированного пользователя.
+</para>
+</listitem>
+
+<listitem>
+<para>
+<command>--with-select_module</command><br/>
+<command>--without-select_module</command>&mdash;разрешает или запрещает
+сборку модуля для работы сервера с помощью метода select.
+Этот модуль собирается автоматически, если на платформе не обнаружено
+более подходящего метода&mdash;kqueue, epoll, rtsig или /dev/poll.
+</para>
+</listitem>
+
+<listitem>
+<para>
+<command>--with-poll_module</command><br/>
+<command>--without-poll_module</command>&mdash;разрешает или запрещает
+сборку модуля для работы сервера с помощью метода poll.
+Этот модуль собирается автоматически, если на платформе не обнаружено
+более подходящего метода&mdash;kqueue, epoll, rtsig или /dev/poll.
+</para>
+</listitem>
+
+<listitem>
+<para>
+<command>--without-http_gzip_module</command>&mdash;запрещает сборку модуля
+сжатия ответов http сервера.
+Для сборки и работы этого модуля нужна библиотека zlib.
+</para>
+</listitem>
+
+<listitem>
+<para>
+<command>--without-http_rewrite_module</command>&mdash;запрещает сборку модуля
+http сервера, позволяющего делать редиректы и менять URI запросов.
+Для сборки и работы этого модуля нужна библиотека PCRE.
+Модуль экспериментальный&mdash;директивы модуля впоследствии могут измениться.
+</para>
+</listitem>
+
+<listitem>
+<para>
+<command>--without-http_proxy_module</command>&mdash;запрещает сборку
+проксирующего модуля http сервера.
+<!--
+Для сборки и работы этого модуля нужна библиотека md5.
+-->
+</para>
+</listitem>
+
+<listitem>
+<para>
+<command>--with-http_ssl_module</command>&mdash;разрешает сборку модуля
+для работы http сервера по протоколу HTTPS. По умолчанию модуль не собирается.
+Для сборки и работы этого модуля нужна библиотека OpenSSL.
+</para>
+</listitem>
+
+<listitem>
+<para>
+<command>--with-pcre=&lt;<value>путь</value>&gt;</command>&mdash;задаёт
+путь к исходным текстам библиотеки PCRE. Дистрибутив библиотеки (версию
+4.4&mdash;6.1) нужно взять на сайте <link url="http://www.pcre.org">PCRE</link>
+и распаковать.
+Всё остальное сделают nginx'овские ./configure и make.
+Библиотека нужна для использования регулярных выражений в
+<dirname>location</dirname> и для модуля ngx_http_rewrite_module.
+</para>
+</listitem>
+
+<listitem>
+<para>
+<command>--with-zlib=&lt;<value>путь</value>&gt;</command>&mdash;задаёт
+путь к исходным текстам библиотеки zlib. Дистрибутив библиотеки (версию
+1.1.3&mdash;1.2.2) нужно взять на сайте
+<link url="http://www.gzip.org/zlib/">zlib</link> и распаковать.
+Всё остальное сделают nginx'овские ./configure и make.
+Библиотека нужна для модуля ngx_http_gzip_module.
+</para>
+</listitem>
+
+<listitem>
+<para>
+<command>--with-cc-opt=&lt;<value>параметры</value>&gt;</command>&mdash;задаёт
+дополнительные параметры, которые будут добавлены к переменной CFLAGS.
+При использовании системной библиотеки PCRE во FreeBSD, нужно указать
+<command>--with-cc-opt="-I /usr/local/include"</command>.
+Если нужно увеличить число файлов, с которыми может работать select(),
+то это тоже можно задать здесь же:
+<command>--with-cc-opt="-D FD_SETSIZE=2048"</command>.
+</para>
+</listitem>
+
+<listitem>
+<para>
+<command>--with-ld-opt=&lt;<value>параметры</value>&gt;</command>&mdash;задаёт
+дополнительные параметры, которые будут использованы при линковке.
+При использовании системной библиотеки PCRE во FreeBSD, нужно указать
+<command>--with-ld-opt="-L /usr/local/lib"</command>.
+</para>
+</listitem>
+
+</list>
+
+</para>
+
+<para>
+Пример использования параметров (всё это нужно набрать в одной строке):
+<programlisting>
+./configure
+    --sbin-path=/usr/local/nginx/nginx
+    --conf-path=/usr/local/nginx/nginx.conf
+    --pid-path=/usr/local/nginx/nginx.pid
+    --with-http_ssl_module
+    --with-pcre=../pcre-4.4
+    --with-zlib=../zlib-1.1.3
+</programlisting>
+</para>
+
+</section>
+
+</article>