Mercurial > hg > nginx-site
view 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 source
<!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>