Mercurial > hg > nginx-site
diff xml/ru/docs/install.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 | 65e75e59a714 |
children | b93422ca9fe7 |
line wrap: on
line diff
--- a/xml/ru/docs/install.xml +++ b/xml/ru/docs/install.xml @@ -8,239 +8,52 @@ <article name="Установка nginx" link="/ru/docs/install.html" lang="ru" - rev="3"> + rev="1" + toc="no"> <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. +nginx устанавливается по-разному в зависимости от операционной системы. </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> +</section> -<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> +<section id="linux" name="Установка на Linux"> -<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> -и распаковать. -Всё остальное сделают ./configure nginx’а и make. -Библиотека нужна для использования регулярных выражений в директиве -<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> и распаковать. -Всё остальное сделают ./configure nginx’а и make. -Библиотека нужна для модуля -<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> - +Для установки nginx на Linux могут быть использованы +<link doc="../linux_packages.xml">пакеты</link> с nginx.org. </para> +</section> + + +<section id="freebsd" name="Установка на FreeBSD"> + <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> +На FreeBSD можно установить nginx либо из +<link +url="http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/packages-using.html"> +пакетов</link>, либо с помощью системы +<link url="http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/ports-using.html"> +портов</link>. +Система портов даёт большую гибкость, позволяя выбирать из широкого +набора настроек. +Порт скомпилирует nginx с выбранными опциями и установит. +</para> + +</section> + + +<section id="source_install" name="Сборка из исходных файлов"> + +<para> +Если необходима специфическая функциональность, недоступная из пакетов или +портов, можно скомпилировать nginx из исходного кода. +Будучи наиболее гибким, этот подход может быть сложным для начинающего. +<link doc="configure.xml"/> освещает этот вопрос более подробно. </para> </section>