Mercurial > hg > nginx-site
diff 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 |
line wrap: on
line diff
new file mode 100644 --- /dev/null +++ b/xml/ru/docs/install.xml @@ -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=<<value>путь</value>></command>—задаёт каталог, +в котором будут находиться файлы сервера. +Этот же каталог будет использоваться для всех относительных путей, +задаваемых <command>./configure</command> (кроме путей к исходным текстам +библиотек) и в конфигурационном файле <command>nginx.conf</command>. +По умолчанию—каталог <command>/usr/local/nginx</command>. +</para> +</listitem> + +<listitem> +<para> +<command>--sbin-path=<<value>путь</value>></command>—задаёт +имя исполняемого файла nginx. +Это имя используется только на стадии установки. +По умолчанию файл называется +<command><<value>prefix</value>>/sbin/nginx</command>. +</para> +</listitem> + +<listitem> +<para> +<command>--conf-path=<<value>путь</value>></command>—задаёт +имя конфигурационного файла <command>nginx.conf</command>. +При желании nginx можно всегда запустить с другим конфигурационным файлом, +указав его в параметре командной строки +<nobr><command>-c <<value>файл</value>></command></nobr>. +По умолчанию файл называется +<command><<value>prefix</value>>/conf/nginx.conf</command>. +</para> +</listitem> + +<listitem> +<para> +<command>--pid-path=<<value>путь</value>></command>—задаёт +имя файла nginx.pid, в котором будет хранится номер главного процесса. +После установки имя файла можно всегда поменять в конфигурационном +файле <command>nginx.conf</command> с помощью директивы <dirname>pid</dirname>. +По умолчанию имя +файла—<command><<value>prefix</value>>/logs/nginx.pid</command>. +</para> +</listitem> + +<listitem> +<para> +<command>--error-log-path=<<value>путь</value>></command>—задаёт +имя основного файла ошибок, предупреждений и диагностики. +После установки имя файла можно всегда поменять в конфигурационном +файле <command>nginx.conf</command> с помощью директивы +<dirname>error_log</dirname>. +По умолчанию имя +файла—<command><<value>prefix</value>>/logs/error.log</command>. +</para> +</listitem> + +<listitem> +<para> +<command>--http-log-path=<<value>путь</value>></command>—задаёт +имя основного файла регистрации запросов http сервера. +После установки имя файла можно всегда поменять в конфигурационном +файле <command>nginx.conf</command> с помощью директивы +<dirname>access_log</dirname>. +По умолчанию имя +файла—<command><<value>prefix</value>>/logs/access.log</command>. +</para> +</listitem> + +<listitem> +<para> +<command>--user=<<value>имя</value>></command>—задаёт +имя непривилегированного пользователя, с правами которого будут +выполняться рабочие процессы. +После установки это имя можно всегда поменять в конфигурационном +файле <command>nginx.conf</command> с помощью директивы +<dirname>user</dirname>. +По умолчанию имя пользователя nobody. +</para> +</listitem> + +<listitem> +<para> +<command>--group=<<value>группа</value>></command>—задаёт +группу, с правами которой будут выполняться рабочие процессы. +После установки это имя можно всегда поменять в конфигурационном +файле <command>nginx.conf</command> с помощью директивы <dirname>user</dirname>. +По умолчанию группа совпадает с именем непривилегированного пользователя. +</para> +</listitem> + +<listitem> +<para> +<command>--with-select_module</command><br/> +<command>--without-select_module</command>—разрешает или запрещает +сборку модуля для работы сервера с помощью метода select. +Этот модуль собирается автоматически, если на платформе не обнаружено +более подходящего метода—kqueue, epoll, rtsig или /dev/poll. +</para> +</listitem> + +<listitem> +<para> +<command>--with-poll_module</command><br/> +<command>--without-poll_module</command>—разрешает или запрещает +сборку модуля для работы сервера с помощью метода poll. +Этот модуль собирается автоматически, если на платформе не обнаружено +более подходящего метода—kqueue, epoll, rtsig или /dev/poll. +</para> +</listitem> + +<listitem> +<para> +<command>--without-http_gzip_module</command>—запрещает сборку модуля +сжатия ответов http сервера. +Для сборки и работы этого модуля нужна библиотека zlib. +</para> +</listitem> + +<listitem> +<para> +<command>--without-http_rewrite_module</command>—запрещает сборку модуля +http сервера, позволяющего делать редиректы и менять URI запросов. +Для сборки и работы этого модуля нужна библиотека PCRE. +Модуль экспериментальный—директивы модуля впоследствии могут измениться. +</para> +</listitem> + +<listitem> +<para> +<command>--without-http_proxy_module</command>—запрещает сборку +проксирующего модуля http сервера. +<!-- +Для сборки и работы этого модуля нужна библиотека md5. +--> +</para> +</listitem> + +<listitem> +<para> +<command>--with-http_ssl_module</command>—разрешает сборку модуля +для работы http сервера по протоколу HTTPS. По умолчанию модуль не собирается. +Для сборки и работы этого модуля нужна библиотека OpenSSL. +</para> +</listitem> + +<listitem> +<para> +<command>--with-pcre=<<value>путь</value>></command>—задаёт +путь к исходным текстам библиотеки PCRE. Дистрибутив библиотеки (версию +4.4—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=<<value>путь</value>></command>—задаёт +путь к исходным текстам библиотеки zlib. Дистрибутив библиотеки (версию +1.1.3—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=<<value>параметры</value>></command>—задаёт +дополнительные параметры, которые будут добавлены к переменной 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=<<value>параметры</value>></command>—задаёт +дополнительные параметры, которые будут использованы при линковке. +При использовании системной библиотеки 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>