Mercurial > hg > nginx-site
view xml/ru/docs/configure.xml @ 3088:7b7dbaa7d777
Documented XOAUTH2 and OAUTHBEARER authentication methods.
author | Maxim Dounin <mdounin@mdounin.ru> |
---|---|
date | Tue, 04 Jun 2024 18:35:21 +0300 |
parents | f55e18559df9 |
children |
line wrap: on
line source
<!-- 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="23"> <section> <para> Сборка настраивается командой <command>configure</command>. Она определяет особенности системы и, в частности, методы, которые nginx может использовать для обработки соединений. В конце концов она создаёт <path>Makefile</path>. </para> <para> Команда <command>configure</command> поддерживает следующие параметры: </para> <para> <list type="tag"> <tag-name> <literal>--help</literal> </tag-name> <tag-desc> печатает справочное сообщение. </tag-desc> </list> </para> <para> <list type="tag"> <tag-name id="prefix"> <literal>--prefix=<value>путь</value></literal> </tag-name> <tag-desc> задаёт каталог, в котором будут находиться файлы сервера. Этот же каталог будет использоваться для всех относительных путей, задаваемых <command>configure</command> (кроме путей к исходным текстам библиотек) и в конфигурационном файле <path>nginx.conf</path>. По умолчанию—каталог <path>/usr/local/nginx</path>. </tag-desc> <tag-name> <literal>--sbin-path=<value>путь</value></literal> </tag-name> <tag-desc> задаёт имя исполняемого файла nginx. Это имя используется только на стадии установки. По умолчанию файл называется <path><value>префикс</value>/sbin/nginx</path>. </tag-desc> <tag-name> <literal>--modules-path=<value>путь</value></literal> </tag-name> <tag-desc> задаёт каталог, в который будут устанавливаться динамические модули. По умолчанию используется каталог <path><value>префикс</value>/modules</path>. </tag-desc> <tag-name id="conf_path"> <literal>--conf-path=<value>путь</value></literal> </tag-name> <tag-desc> задаёт имя конфигурационного файла <path>nginx.conf</path>. При желании nginx можно всегда запустить с другим конфигурационным файлом, указав его в параметре командной строки <nobr><literal>-c <value>файл</value></literal></nobr>. По умолчанию файл называется <path><value>префикс</value>/conf/nginx.conf</path>. </tag-desc> <tag-name> <literal>--error-log-path=<value>путь</value></literal> </tag-name> <tag-desc> задаёт имя основного файла ошибок, предупреждений и диагностики. После установки имя файла можно всегда поменять в конфигурационном файле <path>nginx.conf</path> с помощью директивы <link doc="ngx_core_module.xml" id="error_log"/>. По умолчанию имя файла—<path><value>префикс</value>/logs/error.log</path>. </tag-desc> <tag-name> <literal>--pid-path=<value>путь</value></literal> </tag-name> <tag-desc> задаёт имя файла <path>nginx.pid</path>, в котором будет храниться номер главного процесса. После установки имя файла можно всегда поменять в конфигурационном файле <path>nginx.conf</path> с помощью директивы <link doc="ngx_core_module.xml" id="pid"/>. По умолчанию имя файла—<path><value>префикс</value>/logs/nginx.pid</path>. </tag-desc> <tag-name> <literal>--lock-path=<value>путь</value></literal> </tag-name> <tag-desc> задаёт префикс имён файлов блокировок. После установки значение можно всегда поменять в конфигурационном файле <path>nginx.conf</path> с помощью директивы <link doc="ngx_core_module.xml" id="lock_file"/>. По умолчанию используется значение <path><value>префикс</value>/logs/nginx.lock</path>. </tag-desc> </list> </para> <para> <list type="tag"> <tag-name> <literal>--user=<value>имя</value></literal> </tag-name> <tag-desc> задаёт имя непривилегированного пользователя, с правами которого будут выполняться рабочие процессы. После установки это имя можно всегда поменять в конфигурационном файле <path>nginx.conf</path> с помощью директивы <link doc="ngx_core_module.xml" id="user"/>. По умолчанию имя пользователя nobody. </tag-desc> <tag-name> <literal>--group=<value>имя</value></literal> </tag-name> <tag-desc> задаёт имя группы, с правами которой будут выполняться рабочие процессы. После установки это имя можно всегда поменять в конфигурационном файле <path>nginx.conf</path> с помощью директивы <link doc="ngx_core_module.xml" id="user"/>. По умолчанию группа совпадает с именем непривилегированного пользователя. </tag-desc> </list> </para> <para> <list type="tag"> <tag-name id="build"> <literal>--build=<value>имя</value></literal> </tag-name> <tag-desc> задаёт необязательное имя сборки nginx. </tag-desc> <tag-name> <literal>--builddir=<value>путь</value></literal> </tag-name> <tag-desc> задаёт каталог для сборки. </tag-desc> </list> </para> <para> <list type="tag"> <tag-name> <literal>--with-select_module</literal><br/> <literal>--without-select_module</literal> </tag-name> <tag-desc> разрешает или запрещает сборку модуля для работы сервера с помощью метода <c-func>select</c-func>. Этот модуль собирается автоматически, если на платформе не обнаружено более подходящего метода—kqueue, epoll или /dev/poll. </tag-desc> <tag-name> <literal>--with-poll_module</literal><br/> <literal>--without-poll_module</literal> </tag-name> <tag-desc> разрешает или запрещает сборку модуля для работы сервера с помощью метода <c-func>poll</c-func>. Этот модуль собирается автоматически, если на платформе не обнаружено более подходящего метода—kqueue, epoll или /dev/poll. </tag-desc> <tag-name> <literal>--with-threads</literal> </tag-name> <tag-desc> разрешает использование <link doc="ngx_core_module.xml" id="thread_pool">пулов потоков</link>. </tag-desc> <tag-name> <literal>--with-file-aio</literal> </tag-name> <tag-desc> разрешает использование <link doc="http/ngx_http_core_module.xml" id="aio">файлового асинхронного ввода-вывода</link> (AIO) во FreeBSD и Linux. </tag-desc> </list> </para> <para> <list type="tag"> <tag-name> <literal>--with-http_ssl_module</literal> </tag-name> <tag-desc> разрешает сборку модуля для работы HTTP-сервера по <link doc="http/ngx_http_ssl_module.xml">протоколу HTTPS</link>. По умолчанию модуль не собирается. Для сборки и работы этого модуля нужна библиотека OpenSSL. </tag-desc> <tag-name> <literal>--with-http_v2_module</literal> </tag-name> <tag-desc> разрешает сборку модуля для работы HTTP-сервера по протоколу <link doc="http/ngx_http_v2_module.xml">HTTP/2</link>. По умолчанию модуль не собирается. </tag-desc> <tag-name id="http_v3_module"> <literal>--with-http_v3_module</literal> </tag-name> <tag-desc> разрешает сборку модуля для работы HTTP-сервера по протоколу <link doc="http/ngx_http_v3_module.xml">HTTP/3</link>. По умолчанию модуль не собирается. Для сборки и работы этого модуля рекомендуется библиотека SSL с поддержкой HTTP/3, например <link url="https://boringssl.googlesource.com/boringssl">BoringSSL</link>, <link url="https://www.libressl.org">LibreSSL</link> или <link url="https://github.com/quictls/openssl">QuicTLS</link>. Иначе, при использовании библиотеки OpenSSL, будет использоваться OpenSSL compatibility layer, в котором не поддерживается QUIC <link doc="http/ngx_http_ssl_module.xml" id="ssl_early_data">early data</link>. </tag-desc> <tag-name> <literal>--with-http_realip_module</literal> </tag-name> <tag-desc> разрешает сборку модуля <link doc="http/ngx_http_realip_module.xml">ngx_http_realip_module</link>, позволяющего менять адрес клиента на переданный в указанном поле заголовка. По умолчанию модуль не собирается. </tag-desc> <tag-name> <literal>--with-http_addition_module</literal> </tag-name> <tag-desc> разрешает сборку модуля <link doc="http/ngx_http_addition_module.xml">ngx_http_addition_module</link>, позволяющего добавлять текст до и после ответа. По умолчанию модуль не собирается. </tag-desc> <tag-name> <literal>--with-http_xslt_module</literal><br/> <literal>--with-http_xslt_module=dynamic</literal> </tag-name> <tag-desc> разрешает сборку модуля <link doc="http/ngx_http_xslt_module.xml">ngx_http_xslt_module</link>, позволяющего преобразовывать XML-ответ с помощью XSLT-шаблонов. По умолчанию модуль не собирается. Для сборки и работы этого модуля нужны библиотеки <link url="http://xmlsoft.org">libxml2</link> и <link url="http://xmlsoft.org/XSLT/">libxslt</link>. </tag-desc> <tag-name> <literal>--with-http_image_filter_module</literal><br/> <literal>--with-http_image_filter_module=dynamic</literal> </tag-name> <tag-desc> разрешает сборку модуля <link doc="http/ngx_http_image_filter_module.xml">ngx_http_image_filter_module</link>, позволяющего преобразовывать изображения в форматах JPEG, GIF, PNG и WebP. По умолчанию модуль не собирается. </tag-desc> <tag-name> <literal>--with-http_geoip_module</literal><br/> <literal>--with-http_geoip_module=dynamic</literal> </tag-name> <tag-desc> разрешает сборку модуля <link doc="http/ngx_http_geoip_module.xml">ngx_http_geoip_module</link>, создающего переменные, значения которых зависят от IP-адреса клиента, используя готовые базы данных <link url="http://www.maxmind.com">MaxMind</link>. По умолчанию модуль не собирается. </tag-desc> <tag-name> <literal>--with-http_sub_module</literal> </tag-name> <tag-desc> разрешает сборку модуля <link doc="http/ngx_http_sub_module.xml">ngx_http_sub_module</link>, позволяющего изменять в ответе одну заданную строку на другую. По умолчанию модуль не собирается. </tag-desc> <tag-name> <literal>--with-http_dav_module</literal> </tag-name> <tag-desc> разрешает сборку модуля <link doc="http/ngx_http_dav_module.xml">ngx_http_dav_module</link>, предназначенного для автоматизации задач управления файлами на сервере по протоколу WebDAV. По умолчанию модуль не собирается. </tag-desc> <tag-name> <literal>--with-http_flv_module</literal> </tag-name> <tag-desc> разрешает сборку модуля <link doc="http/ngx_http_flv_module.xml">ngx_http_flv_module</link>, обеспечивающего серверную поддержку псевдо-стриминга для файлов Flash Video (FLV). По умолчанию модуль не собирается. </tag-desc> <tag-name> <literal>--with-http_mp4_module</literal> </tag-name> <tag-desc> разрешает сборку модуля <link doc="http/ngx_http_mp4_module.xml">ngx_http_mp4_module</link>, обеспечивающего серверную поддержку псевдо-стриминга для файлов в формате MP4. По умолчанию модуль не собирается. </tag-desc> <tag-name> <literal>--with-http_gunzip_module</literal> </tag-name> <tag-desc> разрешает сборку модуля <link doc="http/ngx_http_gunzip_module.xml">ngx_http_gunzip_module</link>, позволяющего распаковывать ответы с “<literal>Content-Encoding: gzip</literal>” для тех клиентов, которые не поддерживают метод сжатия “gzip”. По умолчанию модуль не собирается. </tag-desc> <tag-name> <literal>--with-http_gzip_static_module</literal> </tag-name> <tag-desc> разрешает сборку модуля <link doc="http/ngx_http_gzip_static_module.xml">ngx_http_gzip_static_module</link>, позволяющего отдавать вместо обычного файла предварительно сжатый файл с таким же именем и с расширением “<literal>.gz</literal>”. По умолчанию модуль не собирается. </tag-desc> <tag-name> <literal>--with-http_auth_request_module</literal> </tag-name> <tag-desc> разрешает сборку модуля <link doc="http/ngx_http_auth_request_module.xml">ngx_http_auth_request_module</link>, предоставляющего возможность авторизации клиента, основанной на результате подзапроса. По умолчанию модуль не собирается. </tag-desc> <tag-name> <literal>--with-http_random_index_module</literal> </tag-name> <tag-desc> разрешает сборку модуля <link doc="http/ngx_http_random_index_module.xml">ngx_http_random_index_module</link>, обслуживающего запросы, оканчивающиеся слэшом (‘<literal>/</literal>’), и выдающего случайный файл в качестве индексного файла каталога. По умолчанию модуль не собирается. </tag-desc> <tag-name> <literal>--with-http_secure_link_module</literal> </tag-name> <tag-desc> разрешает сборку модуля <link doc="http/ngx_http_secure_link_module.xml">ngx_http_secure_link_module</link>. По умолчанию модуль не собирается. </tag-desc> <tag-name> <literal>--with-http_degradation_module</literal> </tag-name> <tag-desc> разрешает сборку модуля <literal>ngx_http_degradation_module</literal>. По умолчанию модуль не собирается. </tag-desc> <tag-name> <literal>--with-http_slice_module</literal> </tag-name> <tag-desc> разрешает сборку модуля <link doc="http/ngx_http_slice_module.xml">ngx_http_slice_module</link>, позволяющего разбить запрос на подзапросы, каждый из которых возвращает определённый диапазон ответа. Модуль обеспечивает более эффективное кэширование больших ответов. По умолчанию модуль не собирается. </tag-desc> <tag-name> <literal>--with-http_stub_status_module</literal> </tag-name> <tag-desc> разрешает сборку модуля <link doc="http/ngx_http_stub_status_module.xml">ngx_http_stub_status_module</link>, предоставляющего доступ к базовой информации о состоянии сервера. По умолчанию модуль не собирается. </tag-desc> </list> </para> <para> <list type="tag"> <tag-name> <literal>--without-http_charset_module</literal> </tag-name> <tag-desc> запрещает сборку модуля <link doc="http/ngx_http_charset_module.xml">ngx_http_charset_module</link>, позволяющего добавлять указанную кодировку в поле <header>Content-Type</header> заголовка ответа и перекодировать данные из одной кодировки в другую. </tag-desc> <tag-name> <literal>--without-http_gzip_module</literal> </tag-name> <tag-desc> запрещает сборку модуля <link doc="http/ngx_http_gzip_module.xml">сжатия ответов</link> HTTP-сервера. Для сборки и работы этого модуля нужна библиотека zlib. </tag-desc> <tag-name> <literal>--without-http_ssi_module</literal> </tag-name> <tag-desc> запрещает сборку модуля <link doc="http/ngx_http_ssi_module.xml">ngx_http_ssi_module</link>, обрабатывающего команды SSI (Server Side Includes) в проходящих через него ответах. </tag-desc> <tag-name> <literal>--without-http_userid_module</literal> </tag-name> <tag-desc> запрещает сборку модуля <link doc="http/ngx_http_userid_module.xml">ngx_http_userid_module</link>, выдающего куки для идентификации клиентов. </tag-desc> <tag-name> <literal>--without-http_access_module</literal> </tag-name> <tag-desc> запрещает сборку модуля <link doc="http/ngx_http_access_module.xml">ngx_http_access_module</link>, позволяющего ограничить доступ для определённых адресов клиентов. </tag-desc> <tag-name> <literal>--without-http_auth_basic_module</literal> </tag-name> <tag-desc> запрещает сборку модуля <link doc="http/ngx_http_auth_basic_module.xml">ngx_http_auth_basic_module</link>, позволяющего ограничить доступ к ресурсам с проверкой имени и пароля пользователя по протоколу “HTTP Basic Authentication”. </tag-desc> <tag-name> <literal>--without-http_mirror_module</literal> </tag-name> <tag-desc> запрещает сборку модуля <link doc="http/ngx_http_mirror_module.xml">ngx_http_mirror_module</link>, позволяющего зеркалировать исходный запрос при помощи создания фоновых зеркалирующих подзапросов. </tag-desc> <tag-name> <literal>--without-http_autoindex_module</literal> </tag-name> <tag-desc> запрещает сборку модуля <link doc="http/ngx_http_autoindex_module.xml">ngx_http_autoindex_module</link>, обслуживающего запросы, оканчивающиеся слэшом (‘<literal>/</literal>’), и выдающего листинг каталога, когда модуль <link doc="http/ngx_http_index_module.xml">ngx_http_index_module</link> не нашёл индексный файл. </tag-desc> <tag-name> <literal>--without-http_geo_module</literal> </tag-name> <tag-desc> запрещает сборку модуля <link doc="http/ngx_http_geo_module.xml">ngx_http_geo_module</link>, позволяющего создавать переменные, значения которых зависят от IP-адреса клиента. </tag-desc> <tag-name> <literal>--without-http_map_module</literal> </tag-name> <tag-desc> запрещает сборку модуля <link doc="http/ngx_http_map_module.xml">ngx_http_map_module</link>, позволяющего создавать переменные, значения которых зависят от значений других переменных. </tag-desc> <tag-name> <literal>--without-http_split_clients_module</literal> </tag-name> <tag-desc> запрещает сборку модуля <link doc="http/ngx_http_split_clients_module.xml">ngx_http_split_clients_module</link>, позволяющего создавать переменные для A/B тестирования. </tag-desc> <tag-name> <literal>--without-http_referer_module</literal> </tag-name> <tag-desc> запрещает сборку модуля <link doc="http/ngx_http_referer_module.xml">ngx_http_referer_module</link>, позволяющего блокировать доступ к сайту для запросов с неверными значениями поля <header>Referer</header> в заголовке. </tag-desc> <tag-name> <literal>--without-http_rewrite_module</literal> </tag-name> <tag-desc> запрещает сборку модуля HTTP-сервера, позволяющего <link doc="http/ngx_http_rewrite_module.xml">делать перенаправления и менять URI запросов</link>. Для сборки и работы этого модуля нужна библиотека PCRE. </tag-desc> <tag-name> <literal>--without-http_proxy_module</literal> </tag-name> <tag-desc> запрещает сборку <link doc="http/ngx_http_proxy_module.xml">проксирующего модуля</link> HTTP-сервера. <!-- Для сборки и работы этого модуля нужна библиотека md5. --> </tag-desc> <tag-name> <literal>--without-http_fastcgi_module</literal> </tag-name> <tag-desc> запрещает сборку модуля <link doc="http/ngx_http_fastcgi_module.xml">ngx_http_fastcgi_module</link>, позволяющего передавать запросы FastCGI-серверу. </tag-desc> <tag-name> <literal>--without-http_uwsgi_module</literal> </tag-name> <tag-desc> запрещает сборку модуля <link doc="http/ngx_http_uwsgi_module.xml">ngx_http_uwsgi_module</link>, позволяющего передавать запросы uwsgi-серверу. </tag-desc> <tag-name> <literal>--without-http_scgi_module</literal> </tag-name> <tag-desc> запрещает сборку модуля <link doc="http/ngx_http_scgi_module.xml">ngx_http_scgi_module</link>, позволяющего передавать запросы SCGI-серверу. </tag-desc> <tag-name> <literal>--without-http_grpc_module</literal> </tag-name> <tag-desc> запрещает сборку модуля <link doc="http/ngx_http_grpc_module.xml">ngx_http_grpc_module</link>, позволяющего передавать запросы gRPC-серверу. </tag-desc> <tag-name> <literal>--without-http_memcached_module</literal> </tag-name> <tag-desc> запрещает сборку модуля <link doc="http/ngx_http_memcached_module.xml">ngx_http_memcached_module</link>, позволяющего получать ответы из сервера memcached. </tag-desc> <tag-name> <literal>--without-http_limit_conn_module</literal> </tag-name> <tag-desc> запрещает сборку модуля <link doc="http/ngx_http_limit_conn_module.xml">ngx_http_limit_conn_module</link>, позволяющего ограничить число соединений по заданному ключу, в частности, число соединений с одного IP-адреса. </tag-desc> <tag-name> <literal>--without-http_limit_req_module</literal> </tag-name> <tag-desc> запрещает сборку модуля <link doc="http/ngx_http_limit_req_module.xml">ngx_http_limit_req_module</link>, позволяющего ограничить скорость обработки запросов по заданному ключу или, как частный случай, скорость обработки запросов, поступающих с одного IP-адреса. </tag-desc> <tag-name> <literal>--without-http_empty_gif_module</literal> </tag-name> <tag-desc> запрещает сборку модуля, <link doc="http/ngx_http_empty_gif_module.xml">выдающего однопиксельный прозрачный GIF</link>. </tag-desc> <tag-name> <literal>--without-http_browser_module</literal> </tag-name> <tag-desc> запрещает сборку модуля <link doc="http/ngx_http_browser_module.xml">ngx_http_browser_module</link>, создающего переменные, значения которых зависят от значения поля <header>User-Agent</header> в заголовке запроса. </tag-desc> <tag-name> <literal>--without-http_upstream_hash_module</literal> </tag-name> <tag-desc> запрещает сборку модуля, реализующего метод балансировки нагрузки <link doc="http/ngx_http_upstream_module.xml" id="hash"/>. </tag-desc> <tag-name> <literal>--without-http_upstream_ip_hash_module</literal> </tag-name> <tag-desc> запрещает сборку модуля, реализующего метод балансировки нагрузки <link doc="http/ngx_http_upstream_module.xml" id="ip_hash"/>. </tag-desc> <tag-name> <literal>--without-http_upstream_least_conn_module</literal> </tag-name> <tag-desc> запрещает сборку модуля, реализующего метод балансировки нагрузки <link doc="http/ngx_http_upstream_module.xml" id="least_conn"/>. </tag-desc> <tag-name> <literal>--without-http_upstream_random_module</literal> </tag-name> <tag-desc> запрещает сборку модуля, реализующего метод балансировки нагрузки <link doc="http/ngx_http_upstream_module.xml" id="random"/>. </tag-desc> <tag-name> <literal>--without-http_upstream_keepalive_module</literal> </tag-name> <tag-desc> запрещает сборку модуля, реализующего <link doc="http/ngx_http_upstream_module.xml" id="keepalive">кэширование соединений</link> к вышестоящим серверам. </tag-desc> <tag-name> <literal>--without-http_upstream_zone_module</literal> </tag-name> <tag-desc> запрещает сборку модуля, позволяющего сохранять рабочее состояние группы вышестоящих серверов в <link doc="http/ngx_http_upstream_module.xml" id="zone">разделяемой памяти</link>. </tag-desc> </list> </para> <para> <list type="tag"> <tag-name> <literal>--with-http_perl_module</literal><br/> <literal>--with-http_perl_module=dynamic</literal> </tag-name> <tag-desc> разрешает сборку модуля, добавляющего <link doc="http/ngx_http_perl_module.xml">встроенный Perl</link>. По умолчанию модуль не собирается. </tag-desc> <tag-name> <literal>--with-perl_modules_path=<value>путь</value></literal> </tag-name> <tag-desc> задаёт каталог, в котором будут находиться файлы модулей Perl. </tag-desc> <tag-name> <literal>--with-perl=<value>путь</value></literal> </tag-name> <tag-desc> задаёт имя исполняемого файла Perl. </tag-desc> </list> </para> <para> <list type="tag"> <tag-name> <literal>--http-log-path=<value>путь</value></literal> </tag-name> <tag-desc> задаёт имя основного файла регистрации запросов HTTP-сервера. После установки имя файла можно всегда поменять в конфигурационном файле <path>nginx.conf</path> с помощью директивы <link doc="http/ngx_http_log_module.xml" id="access_log"/>. По умолчанию имя файла—<path><value>префикс</value>/logs/access.log</path>. </tag-desc> <tag-name> <literal>--http-client-body-temp-path=<value>путь</value></literal> </tag-name> <tag-desc> задаёт каталог для хранения временных файлов с телами запросов клиентов. После установки имя файла можно всегда поменять в конфигурационном файле <path>nginx.conf</path> с помощью директивы <link doc="http/ngx_http_core_module.xml" id="client_body_temp_path"/>. По умолчанию используется каталог <path><value>префикс</value>/client_body_temp</path>. </tag-desc> <tag-name> <literal>--http-proxy-temp-path=<value>путь</value></literal> </tag-name> <tag-desc> задаёт каталог для хранения временных файлов с данными, полученными от проксируемых серверов. После установки имя файла можно всегда поменять в конфигурационном файле <path>nginx.conf</path> с помощью директивы <link doc="http/ngx_http_proxy_module.xml" id="proxy_temp_path"/>. По умолчанию используется каталог <path><value>префикс</value>/proxy_temp</path>. </tag-desc> <tag-name> <literal>--http-fastcgi-temp-path=<value>путь</value></literal> </tag-name> <tag-desc> задаёт каталог для хранения временных файлов с данными, полученными от FastCGI-серверов. После установки имя файла можно всегда поменять в конфигурационном файле <path>nginx.conf</path> с помощью директивы <link doc="http/ngx_http_fastcgi_module.xml" id="fastcgi_temp_path"/>. По умолчанию используется каталог <path><value>префикс</value>/fastcgi_temp</path>. </tag-desc> <tag-name> <literal>--http-uwsgi-temp-path=<value>путь</value></literal> </tag-name> <tag-desc> задаёт каталог для хранения временных файлов с данными, полученными от uwsgi-серверов. После установки имя файла можно всегда поменять в конфигурационном файле <path>nginx.conf</path> с помощью директивы <link doc="http/ngx_http_uwsgi_module.xml" id="uwsgi_temp_path"/>. По умолчанию используется каталог <path><value>префикс</value>/uwsgi_temp</path>. </tag-desc> <tag-name> <literal>--http-scgi-temp-path=<value>путь</value></literal> </tag-name> <tag-desc> задаёт каталог для хранения временных файлов с данными, полученными от SCGI-серверов. После установки имя файла можно всегда поменять в конфигурационном файле <path>nginx.conf</path> с помощью директивы <link doc="http/ngx_http_scgi_module.xml" id="scgi_temp_path"/>. По умолчанию используется каталог <path><value>префикс</value>/scgi_temp</path>. </tag-desc> </list> </para> <para> <list type="tag"> <tag-name> <literal>--without-http</literal> </tag-name> <tag-desc> запрещает <link doc="http/ngx_http_core_module.xml">HTTP-сервер</link>. </tag-desc> <tag-name> <literal>--without-http-cache</literal> </tag-name> <tag-desc> запрещает HTTP-кэш. </tag-desc> </list> </para> <para> <list type="tag"> <tag-name> <literal>--with-mail</literal><br/> <literal>--with-mail=dynamic</literal> </tag-name> <tag-desc> разрешает POP3/IMAP4/SMTP <link doc="mail/ngx_mail_core_module.xml">почтовый прокси-сервер</link>. </tag-desc> <tag-name> <literal>--with-mail_ssl_module</literal> </tag-name> <tag-desc> разрешает сборку модуля для работы почтового прокси-сервера по <link doc="mail/ngx_mail_ssl_module.xml">протоколу SSL/TLS</link>. По умолчанию модуль не собирается. Для сборки и работы этого модуля нужна библиотека OpenSSL. </tag-desc> <tag-name> <literal>--without-mail_pop3_module</literal> </tag-name> <tag-desc> запрещает протокол <link doc="mail/ngx_mail_pop3_module.xml">POP3</link> в почтовом прокси-сервере. </tag-desc> <tag-name> <literal>--without-mail_imap_module</literal> </tag-name> <tag-desc> запрещает протокол <link doc="mail/ngx_mail_imap_module.xml">IMAP</link> в почтовом прокси-сервере. </tag-desc> <tag-name> <literal>--without-mail_smtp_module</literal> </tag-name> <tag-desc> запрещает протокол <link doc="mail/ngx_mail_smtp_module.xml">SMTP</link> в почтовом прокси-сервере. </tag-desc> </list> </para> <para> <list type="tag"> <tag-name> <literal>--with-stream</literal><br/> <literal>--with-stream=dynamic</literal> </tag-name> <tag-desc> разрешает сборку <link doc="stream/ngx_stream_core_module.xml">модуля stream</link> для TCP/UDP-проксирования и балансировки. По умолчанию модуль не собирается. </tag-desc> <tag-name> <literal>--with-stream_ssl_module</literal> </tag-name> <tag-desc> разрешает сборку модуля для работы модуля stream по <link doc="stream/ngx_stream_ssl_module.xml">протоколу SSL/TLS</link>. По умолчанию модуль не собирается. Для сборки и работы этого модуля нужна библиотека OpenSSL. </tag-desc> <tag-name> <literal>--with-stream_realip_module</literal> </tag-name> <tag-desc> разрешает сборку модуля <link doc="stream/ngx_stream_realip_module.xml">ngx_stream_realip_module</link>, позволяющего менять адрес клиента на переданный в заголовке протокола PROXY. По умолчанию модуль не собирается. </tag-desc> <tag-name> <literal>--with-stream_geoip_module</literal><br/> <literal>--with-stream_geoip_module=dynamic</literal> </tag-name> <tag-desc> разрешает сборку модуля <link doc="stream/ngx_stream_geoip_module.xml">ngx_stream_geoip_module</link>, создающего переменные, значения которых зависят от IP-адреса клиента, используя готовые базы данных <link url="http://www.maxmind.com">MaxMind</link>. По умолчанию модуль не собирается. </tag-desc> <tag-name> <literal>--with-stream_ssl_preread_module</literal> </tag-name> <tag-desc> разрешает сборку модуля <link doc="stream/ngx_stream_ssl_preread_module.xml">ngx_stream_ssl_preread_module</link>, позволяющего извлекать информацию из сообщения <link url="https://datatracker.ietf.org/doc/html/rfc5246#section-7.4.1.2">ClientHello</link> без терминирования SSL/TLS. По умолчанию модуль не собирается. </tag-desc> <tag-name> <literal>--without-stream_limit_conn_module</literal> </tag-name> <tag-desc> запрещает сборку модуля <link doc="stream/ngx_stream_limit_conn_module.xml">ngx_stream_limit_conn_module</link>, позволяющего ограничить число соединений по заданному ключу, в частности, число соединений с одного IP-адреса. </tag-desc> <tag-name> <literal>--without-stream_access_module</literal> </tag-name> <tag-desc> запрещает сборку модуля <link doc="stream/ngx_stream_access_module.xml">ngx_stream_access_module</link>, позволяющего ограничить доступ для определённых адресов клиентов. </tag-desc> <tag-name> <literal>--without-stream_geo_module</literal> </tag-name> <tag-desc> запрещает сборку модуля <link doc="stream/ngx_stream_geo_module.xml">ngx_stream_geo_module</link>, позволяющего создавать переменные, значения которых зависят от IP-адреса клиента. </tag-desc> <tag-name> <literal>--without-stream_map_module</literal> </tag-name> <tag-desc> запрещает сборку модуля <link doc="stream/ngx_stream_map_module.xml">ngx_stream_map_module</link>, позволяющего создавать переменные, значения которых зависят от значений других переменных. </tag-desc> <tag-name> <literal>--without-stream_split_clients_module</literal> </tag-name> <tag-desc> запрещает сборку модуля <link doc="stream/ngx_stream_split_clients_module.xml">ngx_stream_split_clients_module</link>, позволяющего создавать переменные для A/B тестирования. </tag-desc> <tag-name> <literal>--without-stream_return_module</literal> </tag-name> <tag-desc> запрещает сборку модуля <link doc="stream/ngx_stream_return_module.xml">ngx_stream_return_module</link>, позволяющего отправить заданное значение клиенту и после этого закрыть соединение. </tag-desc> <tag-name> <literal>--without-stream_set_module</literal> </tag-name> <tag-desc> запрещает сборку модуля <link doc="stream/ngx_stream_set_module.xml">ngx_stream_set_module</link>, позволяющего устанавливать значение переменной. </tag-desc> <tag-name> <literal>--without-stream_upstream_hash_module</literal> </tag-name> <tag-desc> запрещает сборку модуля, реализующего метод балансировки нагрузки <link doc="stream/ngx_stream_upstream_module.xml" id="hash"/>. </tag-desc> <tag-name> <literal>--without-stream_upstream_least_conn_module</literal> </tag-name> <tag-desc> запрещает сборку модуля, реализующего метод балансировки нагрузки <link doc="stream/ngx_stream_upstream_module.xml" id="least_conn"/>. </tag-desc> <tag-name> <literal>--without-stream_upstream_random_module</literal> </tag-name> <tag-desc> запрещает сборку модуля, реализующего метод балансировки нагрузки <link doc="stream/ngx_stream_upstream_module.xml" id="random"/>. </tag-desc> <tag-name> <literal>--without-stream_upstream_zone_module</literal> </tag-name> <tag-desc> запрещает сборку модуля, позволяющего сохранять рабочее состояние группы вышестоящих серверов в <link doc="stream/ngx_stream_upstream_module.xml" id="zone">разделяемой памяти</link>. </tag-desc> </list> </para> <para> <list type="tag"> <tag-name> <literal>--with-google_perftools_module</literal> </tag-name> <tag-desc> разрешает сборку модуля <link doc="ngx_google_perftools_module.xml">ngx_google_perftools_module</link>, обеспечивающего поддержку профилирования рабочих процессов nginx при помощи <link url="https://github.com/gperftools/gperftools">Google Performance Tools</link>. Модуль предназначен для разработчиков nginx и не собирается по умолчанию. </tag-desc> <tag-name> <literal>--with-cpp_test_module</literal> </tag-name> <tag-desc> разрешает сборку модуля <literal>ngx_cpp_test_module</literal>. </tag-desc> </list> </para> <para> <list type="tag"> <tag-name> <literal>--add-module=<value>путь</value></literal> </tag-name> <tag-desc> разрешает сборку внешнего модуля. </tag-desc> <tag-name> <literal>--add-dynamic-module=<value>путь</value></literal> </tag-name> <tag-desc> разрешает сборку внешнего динамического модуля. </tag-desc> </list> </para> <para> <list type="tag"> <tag-name> <literal>--with-compat</literal> </tag-name> <tag-desc> включает режим совместимости с динамическими модулями. </tag-desc> </list> </para> <para> <list type="tag"> <tag-name> <literal>--with-cc=<value>путь</value></literal> </tag-name> <tag-desc> задаёт компилятор, который будет использоваться при сборке. </tag-desc> <tag-name> <literal>--with-cpp=<value>путь</value></literal> </tag-name> <tag-desc> задаёт препроцессор, который будет использоваться при сборке. </tag-desc> <tag-name> <literal>--with-cc-opt=<value>параметры</value></literal> </tag-name> <tag-desc> задаёт дополнительные параметры, которые будут добавлены к переменной 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>. </tag-desc> <tag-name> <literal>--with-ld-opt=<value>параметры</value></literal> </tag-name> <tag-desc> задаёт дополнительные параметры, которые будут использованы при линковке. При использовании системной библиотеки PCRE во FreeBSD, нужно указать <literal>--with-ld-opt="-L /usr/local/lib"</literal>. </tag-desc> <tag-name> <literal>--with-cpu-opt=<value>cpu</value></literal> </tag-name> <tag-desc> разрешает сборку для одного из следующих процессоров: <literal>pentium</literal>, <literal>pentiumpro</literal>, <literal>pentium3</literal>, <literal>pentium4</literal>, <literal>athlon</literal>, <literal>opteron</literal>, <literal>sparc32</literal>, <literal>sparc64</literal>, <literal>ppc64</literal>. </tag-desc> </list> </para> <para> <list type="tag"> <tag-name> <literal>--without-pcre</literal> </tag-name> <tag-desc> запрещает использование библиотеки PCRE. </tag-desc> <tag-name> <literal>--with-pcre</literal> </tag-name> <tag-desc> разрешает использование библиотеки PCRE. </tag-desc> <tag-name> <literal>--with-pcre=<value>путь</value></literal> </tag-name> <tag-desc> задаёт путь к исходным текстам библиотеки PCRE. Дистрибутив библиотеки нужно взять на сайте <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>. </tag-desc> <tag-name> <literal>--with-pcre-opt=<value>параметры</value></literal> </tag-name> <tag-desc> задаёт дополнительные параметры сборки PCRE. </tag-desc> <tag-name> <literal>--with-pcre-jit</literal> </tag-name> <tag-desc> собирает библиотеку PCRE с поддержкой JIT-компиляции (1.1.12, директива <link doc="ngx_core_module.xml" id="pcre_jit"/>). </tag-desc> <tag-name> <literal>--without-pcre2</literal> </tag-name> <tag-desc> запрещает использование библиотеки PCRE2 вместо исходной библиотеки PCRE (1.21.5). </tag-desc> </list> </para> <para> <list type="tag"> <tag-name> <literal>--with-zlib=<value>путь</value></literal> </tag-name> <tag-desc> задаёт путь к исходным текстам библиотеки zlib. Дистрибутив библиотеки (версию 1.1.3—1.3) нужно взять на сайте <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>. </tag-desc> <tag-name> <literal>--with-zlib-opt=<value>параметры</value></literal> </tag-name> <tag-desc> задаёт дополнительные параметры сборки zlib. </tag-desc> <tag-name> <literal>--with-zlib-asm=<value>cpu</value></literal> </tag-name> <tag-desc> разрешает использование при сборке библиотеки zlib ассемблерных вставок, оптимизированных для одного из следующих процессоров: <literal>pentium</literal>, <literal>pentiumpro</literal>. </tag-desc> </list> </para> <para> <list type="tag"> <tag-name> <literal>--with-libatomic</literal> </tag-name> <tag-desc> разрешает сборку с библиотекой libatomic_ops. </tag-desc> <tag-name> <literal>--with-libatomic=<value>путь</value></literal> </tag-name> <tag-desc> задаёт путь к исходным текстам библиотеки libatomic_ops. </tag-desc> </list> </para> <para> <list type="tag"> <tag-name> <literal>--with-openssl=<value>путь</value></literal> </tag-name> <tag-desc> задаёт путь к исходным текстам библиотеки OpenSSL. </tag-desc> <tag-name> <literal>--with-openssl-opt=<value>параметры</value></literal> </tag-name> <tag-desc> задаёт дополнительные параметры сборки OpenSSL. </tag-desc> </list> </para> <para> <list type="tag"> <tag-name> <literal>--with-debug</literal> </tag-name> <tag-desc> разрешает <link doc="debugging_log.xml">отладочный лог</link>. </tag-desc> </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=../pcre2-10.39 --with-zlib=../zlib-1.3 </programlisting> </para> <para> После конфигурации nginx компилируется и устанавливается с помощью <command>make</command>. </para> </section> </article>