Mercurial > hg > nginx-site
diff xml/ru/docs/configure.xml @ 924:a2aea48ff155
New "installation" article.
Old "installation" was renamed to "configure" and describes how
to build nginx from sources.
author | Ruslan Ermilov <ru@nginx.com> |
---|---|
date | Fri, 31 May 2013 13:05:51 +0400 |
parents | xml/ru/docs/install.xml@65e75e59a714 |
children | eea7541e7c6a |
line wrap: on
line diff
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/xml/ru/docs/configure.xml Fri May 31 13:05:51 2013 +0400 @@ -0,0 +1,255 @@ +<!-- + Copyright (C) Igor Sysoev + Copyright (C) Nginx, Inc. + --> + +<!DOCTYPE article SYSTEM "../../../dtd/article.dtd"> + +<article name="Сборка nginx из исходных файлов" + link="/ru/docs/configure.html" + lang="ru" + rev="4"> + +<section> + +<para> +Сборка настраивается командой <command>configure</command>. +Она определяет особенности системы и, в частности, методы, которые nginx +может использовать для обработки соединений. +В конце концов она создаёт <path>Makefile</path>. +Команда <command>configure</command> поддерживает следующие параметры: +<list type="bullet"> + +<listitem> +<para> +<literal>--prefix=<value>путь</value></literal>—задаёт каталог, +в котором будут находиться файлы сервера. +Этот же каталог будет использоваться для всех относительных путей, +задаваемых <command>configure</command> (кроме путей к исходным текстам +библиотек) и в конфигурационном файле <path>nginx.conf</path>. +По умолчанию—каталог <path>/usr/local/nginx</path>. +</para> +</listitem> + +<listitem> +<para> +<literal>--sbin-path=<value>путь</value></literal>—задаёт +имя исполняемого файла nginx. +Это имя используется только на стадии установки. +По умолчанию файл называется +<path><value>префикс</value>/sbin/nginx</path>. +</para> +</listitem> + +<listitem> +<para> +<literal>--conf-path=<value>путь</value></literal>—задаёт +имя конфигурационного файла <path>nginx.conf</path>. +При желании nginx можно всегда запустить с другим конфигурационным файлом, +указав его в параметре командной строки +<nobr><literal>-c <value>файл</value></literal></nobr>. +По умолчанию файл называется +<path><value>префикс</value>/conf/nginx.conf</path>. +</para> +</listitem> + +<listitem> +<para> +<literal>--pid-path=<value>путь</value></literal>—задаёт +имя файла nginx.pid, в котором будет храниться номер главного процесса. +После установки имя файла можно всегда поменять в конфигурационном +файле <path>nginx.conf</path> с помощью директивы +<link doc="ngx_core_module.xml" id="pid"/>. +По умолчанию имя +файла—<path><value>префикс</value>/logs/nginx.pid</path>. +</para> +</listitem> + +<listitem> +<para> +<literal>--error-log-path=<value>путь</value></literal>—задаёт +имя основного файла ошибок, предупреждений и диагностики. +После установки имя файла можно всегда поменять в конфигурационном +файле <path>nginx.conf</path> с помощью директивы +<link doc="ngx_core_module.xml" id="error_log"/>. +По умолчанию имя +файла—<path><value>префикс</value>/logs/error.log</path>. +</para> +</listitem> + +<listitem> +<para> +<literal>--http-log-path=<value>путь</value></literal>—задаёт +имя основного файла регистрации запросов HTTP-сервера. +После установки имя файла можно всегда поменять в конфигурационном +файле <path>nginx.conf</path> с помощью директивы +<link doc="http/ngx_http_log_module.xml" id="access_log"/>. +По умолчанию имя +файла—<path><value>префикс</value>/logs/access.log</path>. +</para> +</listitem> + +<listitem> +<para> +<literal>--user=<value>имя</value></literal>—задаёт +имя непривилегированного пользователя, с правами которого будут +выполняться рабочие процессы. +После установки это имя можно всегда поменять в конфигурационном +файле <path>nginx.conf</path> с помощью директивы +<link doc="ngx_core_module.xml" id="user"/>. +По умолчанию имя пользователя nobody. +</para> +</listitem> + +<listitem> +<para> +<literal>--group=<value>имя</value></literal>—задаёт +имя группы, с правами которой будут выполняться рабочие процессы. +После установки это имя можно всегда поменять в конфигурационном +файле <path>nginx.conf</path> с помощью директивы +<link doc="ngx_core_module.xml" id="user"/>. +По умолчанию группа совпадает с именем непривилегированного пользователя. +</para> +</listitem> + +<listitem> +<para> +<literal>--with-select_module</literal><br/> +<literal>--without-select_module</literal>—разрешает или запрещает +сборку модуля для работы сервера с помощью метода <c-func>select</c-func>. +Этот модуль собирается автоматически, если на платформе не обнаружено +более подходящего метода—kqueue, epoll, rtsig или /dev/poll. +</para> +</listitem> + +<listitem> +<para> +<literal>--with-poll_module</literal><br/> +<literal>--without-poll_module</literal>—разрешает или запрещает +сборку модуля для работы сервера с помощью метода <c-func>poll</c-func>. +Этот модуль собирается автоматически, если на платформе не обнаружено +более подходящего метода—kqueue, epoll, rtsig или /dev/poll. +</para> +</listitem> + +<listitem> +<para> +<literal>--without-http_gzip_module</literal>—запрещает сборку модуля +<link doc="http/ngx_http_gzip_module.xml">сжатия ответов</link> HTTP-сервера. +Для сборки и работы этого модуля нужна библиотека zlib. +</para> +</listitem> + +<listitem> +<para> +<literal>--without-http_rewrite_module</literal>—запрещает сборку модуля +HTTP-сервера, позволяющего <link doc="http/ngx_http_rewrite_module.xml">делать +перенаправления и менять URI запросов</link>. +Для сборки и работы этого модуля нужна библиотека PCRE. +</para> +</listitem> + +<listitem> +<para> +<literal>--without-http_proxy_module</literal>—запрещает сборку +<link doc="http/ngx_http_proxy_module.xml">проксирующего модуля</link> +HTTP-сервера. +<!-- +Для сборки и работы этого модуля нужна библиотека md5. +--> +</para> +</listitem> + +<listitem> +<para> +<literal>--with-http_ssl_module</literal>—разрешает сборку модуля +для работы HTTP-сервера по <link doc="http/ngx_http_ssl_module.xml">протоколу +HTTPS</link>. +По умолчанию модуль не собирается. +Для сборки и работы этого модуля нужна библиотека OpenSSL. +</para> +</listitem> + +<listitem> +<para> +<literal>--with-pcre=<value>путь</value></literal>—задаёт +путь к исходным текстам библиотеки PCRE. +Дистрибутив библиотеки (версию +4.4—8.32) нужно взять на сайте <link url="http://www.pcre.org">PCRE</link> +и распаковать. +Всё остальное сделают <command>./configure</command> nginx’а и +<command>make</command>. +Библиотека нужна для использования регулярных выражений в директиве +<link doc="http/ngx_http_core_module.xml" id="location"/> +и для модуля +<link doc="http/ngx_http_rewrite_module.xml">ngx_http_rewrite_module</link>. +</para> +</listitem> + +<listitem> +<para> +<literal>--with-pcre-jit</literal>—собирает библиотеку PCRE с +поддержкой JIT-компиляции (1.1.12, директива +<link doc="ngx_core_module.xml" id="pcre_jit"/>). +</para> +</listitem> + +<listitem> +<para> +<literal>--with-zlib=<value>путь</value></literal>—задаёт +путь к исходным текстам библиотеки zlib. Дистрибутив библиотеки (версию +1.1.3—1.2.7) нужно взять на сайте +<link url="http://zlib.net">zlib</link> и распаковать. +Всё остальное сделают <command>./configure</command> nginx’а и +<command>make</command>. +Библиотека нужна для модуля +<link doc="http/ngx_http_gzip_module.xml">ngx_http_gzip_module</link>. +</para> +</listitem> + +<listitem> +<para> +<literal>--with-cc-opt=<value>параметры</value></literal>—задаёт +дополнительные параметры, которые будут добавлены к переменной CFLAGS. +При использовании системной библиотеки PCRE во FreeBSD, нужно указать +<literal>--with-cc-opt="-I /usr/local/include"</literal>. +Если нужно увеличить число файлов, с которыми может работать +<c-func>select</c-func>, то это тоже можно задать здесь же: +<literal>--with-cc-opt="-D FD_SETSIZE=2048"</literal>. +</para> +</listitem> + +<listitem> +<para> +<literal>--with-ld-opt=<value>параметры</value></literal>—задаёт +дополнительные параметры, которые будут использованы при линковке. +При использовании системной библиотеки PCRE во FreeBSD, нужно указать +<literal>--with-ld-opt="-L /usr/local/lib"</literal>. +</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> + +<para> +После конфигурации +nginx компилируется и устанавливается с помощью <command>make</command>. +</para> + +</section> + +</article>