Mercurial > hg > nginx-site

view xml/ru/docs/install.xml @ 79:0a45870d0160

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Fixed cross-document links to use doc and id.
author Maxim Dounin <mdounin@mdounin.ru>
date Wed, 12 Oct 2011 15:47:58 +0000
parents 4a4caa566120
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=&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>