Mercurial > hg > nginx-site
changeset 2156:224ca9f697a5
Documented all configure options.
author | Maxim Dounin <mdounin@mdounin.ru> |
---|---|
date | Mon, 23 Apr 2018 21:41:07 +0300 |
parents | fd06f014e6db |
children | 5dd7d258b7e8 |
files | xml/en/docs/configure.xml xml/ru/docs/configure.xml |
diffstat | 2 files changed, 2182 insertions(+), 105 deletions(-) [+] |
line wrap: on
line diff
--- a/xml/en/docs/configure.xml +++ b/xml/en/docs/configure.xml @@ -8,7 +8,7 @@ <article name="Building nginx from Sources" link="/en/docs/configure.html" lang="en" - rev="13"> + rev="14"> <section> @@ -17,7 +17,26 @@ The build is configured using the <comma It defines various aspects of the system, including the methods nginx is allowed to use for connection processing. At the end it creates a <path>Makefile</path>. +</para> + +<para> The <command>configure</command> command supports the following parameters: +</para> + +<para> +<list type="tag"> + +<tag-name> +<literal>--help</literal> +</tag-name> +<tag-desc> +prints a help message. +</tag-desc> + +</list> +</para> + +<para> <list type="tag"> <tag-name> @@ -42,6 +61,14 @@ By default the file is named </tag-desc> <tag-name> +<literal>--modules-path=<value>path</value></literal> +</tag-name> +<tag-desc> +defines a directory where nginx dynamic modules will be installed. +By default the <path><value>prefix</value>/modules</path> directory is used. +</tag-desc> + +<tag-name> <literal>--conf-path=<value>path</value></literal> </tag-name> <tag-desc> @@ -54,6 +81,18 @@ By default the file is named </tag-desc> <tag-name> +<literal>--error-log-path=<value>path</value></literal> +</tag-name> +<tag-desc> +sets the name of the primary error, warnings, and diagnostic file. +After installation, the file name can always be changed in the +<path>nginx.conf</path> configuration file using the +<link doc="ngx_core_module.xml" id="error_log"/> directive. +By default the file is named +<path><value>prefix</value>/logs/error.log</path>. +</tag-desc> + +<tag-name> <literal>--pid-path=<value>path</value></literal> </tag-name> <tag-desc> @@ -67,35 +106,22 @@ By default the file is named </tag-desc> <tag-name> -<literal>--error-log-path=<value>path</value></literal> -</tag-name> -<tag-desc> -sets the name of the primary error, warnings, and diagnostic file. -After installation, the file name can always be changed in the -<path>nginx.conf</path> configuration file using the -<link doc="ngx_core_module.xml" id="error_log"/> directive. -By default the file is named -<path><value>prefix</value>/logs/error.log</path>. -</tag-desc> - -<tag-name> -<literal>--http-log-path=<value>path</value></literal> +<literal>--lock-path=<value>path</value></literal> </tag-name> <tag-desc> -sets the name of the primary request log file of the HTTP server. -After installation, the file name can always be changed in the +sets a prefix for the names of lock files. +After installation, the value can always be changed in the <path>nginx.conf</path> configuration file using the -<link doc="http/ngx_http_log_module.xml" id="access_log"/> directive. -By default the file is named -<path><value>prefix</value>/logs/access.log</path>. +<link doc="ngx_core_module.xml" id="lock_file"/> directive. +By default the value is +<path><value>prefix</value>/logs/nginx.lock</path>. </tag-desc> -<tag-name id="build"> -<literal>--build=<value>name</value></literal> -</tag-name> -<tag-desc> -sets an optional nginx build name. -</tag-desc> +</list> +</para> + +<para> +<list type="tag"> <tag-name> <literal>--user=<value>name</value></literal> @@ -121,6 +147,32 @@ After installation, the name can always By default, a group name is set to the name of an unprivileged user. </tag-desc> +</list> +</para> + +<para> +<list type="tag"> + +<tag-name id="build"> +<literal>--build=<value>name</value></literal> +</tag-name> +<tag-desc> +sets an optional nginx build name. +</tag-desc> + +<tag-name> +<literal>--builddir=<value>path</value></literal> +</tag-name> +<tag-desc> +sets a build directory. +</tag-desc> + +</list> +</para> + +<para> +<list type="tag"> + <tag-name> <literal>--with-select_module</literal><br/> <literal>--without-select_module</literal> @@ -144,6 +196,254 @@ to support more appropriate methods such </tag-desc> <tag-name> +<literal>--with-threads</literal> +</tag-name> +<tag-desc> +enables the use of +<link doc="ngx_core_module.xml" id="thread_pool">thread pools</link>. +</tag-desc> + +<tag-name> +<literal>--with-file-aio</literal> +</tag-name> +<tag-desc> +enables the use of +<link doc="http/ngx_http_core_module.xml" id="aio">asynchronous file I/O</link> +(AIO) on FreeBSD and Linux. +</tag-desc> + +</list> +</para> + +<para> +<list type="tag"> + +<tag-name> +<literal>--with-http_ssl_module</literal> +</tag-name> +<tag-desc> +enables building a module that adds the +<link doc="http/ngx_http_ssl_module.xml">HTTPS protocol support</link> +to an HTTP server. +This module is not built by default. +The OpenSSL library is required to build and run this module. +</tag-desc> + +<tag-name> +<literal>--with-http_v2_module</literal> +</tag-name> +<tag-desc> +enables building a module that provides support for +<link doc="http/ngx_http_v2_module.xml">HTTP/2</link>. +This module is not built by default. +</tag-desc> + +<tag-name> +<literal>--with-http_realip_module</literal> +</tag-name> +<tag-desc> +enables building the +<link doc="http/ngx_http_realip_module.xml">ngx_http_realip_module</link> +module that changes the client address to the address +sent in the specified header field. +This module is not built by default. +</tag-desc> + +<tag-name> +<literal>--with-http_addition_module</literal> +</tag-name> +<tag-desc> +enables building the +<link doc="http/ngx_http_addition_module.xml">ngx_http_addition_module</link> +module that adds text before and after a response. +This module is not built by default. +</tag-desc> + +<tag-name> +<literal>--with-http_xslt_module</literal><br/> +<literal>--with-http_xslt_module=dynamic</literal> +</tag-name> +<tag-desc> +enables building the +<link doc="http/ngx_http_xslt_module.xml">ngx_http_xslt_module</link> +module that transforms XML responses using one or more XSLT stylesheets. +This module is not built by default. +The <link url="http://xmlsoft.org">libxml2</link> and +<link url="http://xmlsoft.org/XSLT/">libxslt</link> libraries +are required to build and run this module. +</tag-desc> + +<tag-name> +<literal>--with-http_image_filter_module</literal><br/> +<literal>--with-http_image_filter_module=dynamic</literal> +</tag-name> +<tag-desc> +enables building the +<link doc="http/ngx_http_image_filter_module.xml">ngx_http_image_filter_module</link> +module that transforms images in JPEG, GIF, PNG, and WebP formats. +This module is not built by default. +</tag-desc> + +<tag-name> +<literal>--with-http_geoip_module</literal><br/> +<literal>--with-http_geoip_module=dynamic</literal> +</tag-name> +<tag-desc> +enables building the +<link doc="http/ngx_http_geoip_module.xml">ngx_http_geoip_module</link> +module that creates variables depending on the client IP address +and the precompiled +<link url="http://www.maxmind.com">MaxMind</link> databases. +This module is not built by default. +</tag-desc> + +<tag-name> +<literal>--with-http_sub_module</literal> +</tag-name> +<tag-desc> +enables building the +<link doc="http/ngx_http_sub_module.xml">ngx_http_sub_module</link> +module that modifies a response by replacing one specified string by another. +This module is not built by default. +</tag-desc> + +<tag-name> +<literal>--with-http_dav_module</literal> +</tag-name> +<tag-desc> +enables building the +<link doc="http/ngx_http_dav_module.xml">ngx_http_dav_module</link> +module that provides file management automation via the WebDAV protocol. +This module is not built by default. +</tag-desc> + +<tag-name> +<literal>--with-http_flv_module</literal> +</tag-name> +<tag-desc> +enables building the +<link doc="http/ngx_http_flv_module.xml">ngx_http_flv_module</link> +module that provides pseudo-streaming server-side support +for Flash Video (FLV) files. +This module is not built by default. +</tag-desc> + +<tag-name> +<literal>--with-http_mp4_module</literal> +</tag-name> +<tag-desc> +enables building the +<link doc="http/ngx_http_mp4_module.xml">ngx_http_mp4_module</link> +module that provides pseudo-streaming server-side support +for MP4 files. +This module is not built by default. +</tag-desc> + +<tag-name> +<literal>--with-http_gunzip_module</literal> +</tag-name> +<tag-desc> +enables building the +<link doc="http/ngx_http_gunzip_module.xml">ngx_http_gunzip_module</link> +module that decompresses responses +with “<literal>Content-Encoding: gzip</literal>” +for clients that do not support “gzip” encoding method. +This module is not built by default. +</tag-desc> + +<tag-name> +<literal>--with-http_gzip_static_module</literal> +</tag-name> +<tag-desc> +enables building the +<link doc="http/ngx_http_gzip_static_module.xml">ngx_http_gzip_static_module</link> +module that enables sending precompressed files +with the “<literal>.gz</literal>” filename extension instead of regular files. +This module is not built by default. +</tag-desc> + +<tag-name> +<literal>--with-http_auth_request_module</literal> +</tag-name> +<tag-desc> +enables building the +<link doc="http/ngx_http_auth_request_module.xml">ngx_http_auth_request_module</link> +module that implements client authorization +based on the result of a subrequest. +This module is not built by default. +</tag-desc> + +<tag-name> +<literal>--with-http_random_index_module</literal> +</tag-name> +<tag-desc> +enables building the +<link doc="http/ngx_http_random_index_module.xml">ngx_http_random_index_module</link> +module that processes requests +ending with the slash character (‘<literal>/</literal>’) and picks a random +file in a directory to serve as an index file. +This module is not built by default. +</tag-desc> + +<tag-name> +<literal>--with-http_secure_link_module</literal> +</tag-name> +<tag-desc> +enables building the +<link doc="http/ngx_http_secure_link_module.xml">ngx_http_secure_link_module</link> +module. +This module is not built by default. +</tag-desc> + +<tag-name> +<literal>--with-http_degradation_module</literal> +</tag-name> +<tag-desc> +enables building the +<literal>ngx_http_degradation_module</literal> module. +This module is not built by default. +</tag-desc> + +<tag-name> +<literal>--with-http_slice_module</literal> +</tag-name> +<tag-desc> +enables building the +<link doc="http/ngx_http_slice_module.xml">ngx_http_slice_module</link> +module that splits a request into subrequests, +each returning a certain range of response. +The module provides more effective caching of big responses. +This module is not built by default. +</tag-desc> + +<tag-name> +<literal>--with-http_stub_status_module</literal> +</tag-name> +<tag-desc> +enables building the +<link doc="http/ngx_http_stub_status_module.xml">ngx_http_stub_status_module</link> +module that provides access to basic status information. +This module is not built by default. +</tag-desc> + +</list> +</para> + +<para> +<list type="tag"> + +<tag-name> +<literal>--without-http_charset_module</literal> +</tag-name> +<tag-desc> +disables building the +<link doc="http/ngx_http_charset_module.xml">ngx_http_charset_module</link> +module that adds the specified charset to the +<header>Content-Type</header> response header field +and can additionally convert data from one charset to another. +</tag-desc> + +<tag-name> <literal>--without-http_gzip_module</literal> </tag-name> <tag-desc> @@ -154,6 +454,106 @@ The zlib library is required to build an </tag-desc> <tag-name> +<literal>--without-http_ssi_module</literal> +</tag-name> +<tag-desc> +disables building the +<link doc="http/ngx_http_ssi_module.xml">ngx_http_ssi_module</link> +module that processes SSI (Server Side Includes) commands in responses +passing through it. +</tag-desc> + +<tag-name> +<literal>--without-http_userid_module</literal> +</tag-name> +<tag-desc> +disables building the +<link doc="http/ngx_http_userid_module.xml">ngx_http_userid_module</link> +module that sets cookies suitable for client identification. +</tag-desc> + +<tag-name> +<literal>--without-http_access_module</literal> +</tag-name> +<tag-desc> +disables building the +<link doc="http/ngx_http_access_module.xml">ngx_http_access_module</link> +module that allows limiting access to certain client addresses. +</tag-desc> + +<tag-name> +<literal>--without-http_auth_basic_module</literal> +</tag-name> +<tag-desc> +disables building the +<link doc="http/ngx_http_auth_basic_module.xml">ngx_http_auth_basic_module</link> +module that allows limiting access to resources by validating the user name +and password using the “HTTP Basic Authentication” protocol. +</tag-desc> + +<tag-name> +<literal>--without-http_mirror_module</literal> +</tag-name> +<tag-desc> +disables building the +<link doc="http/ngx_http_mirror_module.xml">ngx_http_mirror_module</link> +module that implements mirroring of an original request +by creating background mirror subrequests. +</tag-desc> + +<tag-name> +<literal>--without-http_autoindex_module</literal> +</tag-name> +<tag-desc> +disables building the +<link doc="http/ngx_http_autoindex_module.xml">ngx_http_autoindex_module</link> +module that processes requests +ending with the slash character (‘<literal>/</literal>’) and produces +a directory listing in case the +<link doc="http/ngx_http_index_module.xml">ngx_http_index_module</link> module +cannot find an index file. +</tag-desc> + +<tag-name> +<literal>--without-http_geo_module</literal> +</tag-name> +<tag-desc> +disables building the +<link doc="http/ngx_http_geo_module.xml">ngx_http_geo_module</link> +module that creates variables +with values depending on the client IP address. +</tag-desc> + +<tag-name> +<literal>--without-http_map_module</literal> +</tag-name> +<tag-desc> +disables building the +<link doc="http/ngx_http_map_module.xml">ngx_http_map_module</link> +module that creates variables +with values depending on values of other variables. +</tag-desc> + +<tag-name> +<literal>--without-http_split_clients_module</literal> +</tag-name> +<tag-desc> +disables building the +<link doc="http/ngx_http_split_clients_module.xml">ngx_http_split_clients_module</link> +module that creates variables for A/B testing. +</tag-desc> + +<tag-name> +<literal>--without-http_referer_module</literal> +</tag-name> +<tag-desc> +disables building the +<link doc="http/ngx_http_referer_module.xml">ngx_http_referer_module</link> +module that can block access to a site for requests with invalid values +in the <header>Referer</header> header field. +</tag-desc> + +<tag-name> <literal>--without-http_rewrite_module</literal> </tag-name> <tag-desc> @@ -175,54 +575,547 @@ The MD5 library is required to build and </tag-desc> <tag-name> -<literal>--with-http_ssl_module</literal> +<literal>--without-http_fastcgi_module</literal> +</tag-name> +<tag-desc> +disables building the +<link doc="http/ngx_http_fastcgi_module.xml">ngx_http_fastcgi_module</link> +module that passes requests to a FastCGI server. +</tag-desc> + +<tag-name> +<literal>--without-http_uwsgi_module</literal> +</tag-name> +<tag-desc> +disables building the +<link doc="http/ngx_http_uwsgi_module.xml">ngx_http_uwsgi_module</link> +module that passes requests to a uwsgi server. +</tag-desc> + +<tag-name> +<literal>--without-http_scgi_module</literal> +</tag-name> +<tag-desc> +disables building the +<link doc="http/ngx_http_scgi_module.xml">ngx_http_scgi_module</link> +module that passes requests to an SCGI server. +</tag-desc> + +<tag-name> +<literal>--without-http_grpc_module</literal> +</tag-name> +<tag-desc> +disables building the +<link doc="http/ngx_http_grpc_module.xml">ngx_http_grpc_module</link> +module that passes requests to a gRPC server. +</tag-desc> + +<tag-name> +<literal>--without-http_memcached_module</literal> +</tag-name> +<tag-desc> +disables building the +<link doc="http/ngx_http_memcached_module.xml">ngx_http_memcached_module</link> +module that obtains responses from a memcached server. +</tag-desc> + +<tag-name> +<literal>--without-http_limit_conn_module</literal> +</tag-name> +<tag-desc> +disables building the +<link doc="http/ngx_http_limit_conn_module.xml">ngx_http_limit_conn_module</link> +module that limits the number of connections per key, for example, +the number of connections from a single IP address. +</tag-desc> + +<tag-name> +<literal>--without-http_limit_req_module</literal> +</tag-name> +<tag-desc> +disables building the +<link doc="http/ngx_http_limit_req_module.xml">ngx_http_limit_req_module</link> +module that limits the request processing rate per key, for example, +the processing rate of requests coming from a single IP address. +</tag-desc> + +<tag-name> +<literal>--without-http_empty_gif_module</literal> +</tag-name> +<tag-desc> +disables building a module that +<link doc="http/ngx_http_empty_gif_module.xml">emits single-pixel +transparent GIF</link>. +</tag-desc> + +<tag-name> +<literal>--without-http_browser_module</literal> +</tag-name> +<tag-desc> +disables building the +<link doc="http/ngx_http_browser_module.xml">ngx_http_browser_module</link> +module that creates variables whose values depend on the value of the +<header>User-Agent</header> request header field. +</tag-desc> + +<tag-name> +<literal>--without-http_upstream_hash_module</literal> +</tag-name> +<tag-desc> +disables building a module that implements the +<link doc="http/ngx_http_upstream_module.xml" id="hash"/> +load balancing method. +</tag-desc> + +<tag-name> +<literal>--without-http_upstream_ip_hash_module</literal> +</tag-name> +<tag-desc> +disables building a module that implements the +<link doc="http/ngx_http_upstream_module.xml" id="ip_hash"/> +load balancing method. +</tag-desc> + +<tag-name> +<literal>--without-http_upstream_least_conn_module</literal> +</tag-name> +<tag-desc> +disables building a module that implements the +<link doc="http/ngx_http_upstream_module.xml" id="least_conn"/> +load balancing method. +</tag-desc> + +<tag-name> +<literal>--without-http_upstream_keepalive_module</literal> +</tag-name> +<tag-desc> +disables building a module that provides +<link doc="http/ngx_http_upstream_module.xml" id="keepalive">caching of +connections</link> to upstream servers. +</tag-desc> + +<tag-name> +<literal>--without-http_upstream_zone_module</literal> +</tag-name> +<tag-desc> +disables building a module that makes it possible to store run-time state +of an upstream group in a shared memory +<link doc="http/ngx_http_upstream_module.xml" id="zone"/>. +</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> +enables building the +<link doc="http/ngx_http_perl_module.xml">embedded Perl module</link>. +This module is not built by default. +</tag-desc> + +<tag-name> +<literal>--with-perl_modules_path=<value>path</value></literal> +</tag-name> +<tag-desc> +defines a directory that will keep Perl modules. +</tag-desc> + +<tag-name> +<literal>--with-perl=<value>path</value></literal> +</tag-name> +<tag-desc> +sets the name of the Perl binary. +</tag-desc> + +</list> +</para> + +<para> +<list type="tag"> + +<tag-name> +<literal>--http-log-path=<value>path</value></literal> +</tag-name> +<tag-desc> +sets the name of the primary request log file of the HTTP server. +After installation, the file name can always be changed in the +<path>nginx.conf</path> configuration file using the +<link doc="http/ngx_http_log_module.xml" id="access_log"/> directive. +By default the file is named +<path><value>prefix</value>/logs/access.log</path>. +</tag-desc> + +<tag-name> +<literal>--http-client-body-temp-path=<value>path</value></literal> +</tag-name> +<tag-desc> +defines a directory for storing temporary files +that hold client request bodies. +After installation, the directory can always be changed in the +<path>nginx.conf</path> configuration file using the +<link doc="http/ngx_http_core_module.xml" id="client_body_temp_path"/> +directive. +By default the directory is named +<path><value>prefix</value>/client_body_temp</path>. +</tag-desc> + +<tag-name> +<literal>--http-proxy-temp-path=<value>path</value></literal> +</tag-name> +<tag-desc> +defines a directory for storing temporary files +with data received from proxied servers. +After installation, the directory can always be changed in the +<path>nginx.conf</path> configuration file using the +<link doc="http/ngx_http_proxy_module.xml" id="proxy_temp_path"/> +directive. +By default the directory is named +<path><value>prefix</value>/proxy_temp</path>. +</tag-desc> + +<tag-name> +<literal>--http-fastcgi-temp-path=<value>path</value></literal> +</tag-name> +<tag-desc> +defines a directory for storing temporary files +with data received from FastCGI servers. +After installation, the directory can always be changed in the +<path>nginx.conf</path> configuration file using the +<link doc="http/ngx_http_fastcgi_module.xml" id="fastcgi_temp_path"/> +directive. +By default the directory is named +<path><value>prefix</value>/fastcgi_temp</path>. +</tag-desc> + +<tag-name> +<literal>--http-uwsgi-temp-path=<value>path</value></literal> +</tag-name> +<tag-desc> +defines a directory for storing temporary files +with data received from uwsgi servers. +After installation, the directory can always be changed in the +<path>nginx.conf</path> configuration file using the +<link doc="http/ngx_http_uwsgi_module.xml" id="uwsgi_temp_path"/> +directive. +By default the directory is named +<path><value>prefix</value>/uwsgi_temp</path>. +</tag-desc> + +<tag-name> +<literal>--http-scgi-temp-path=<value>path</value></literal> +</tag-name> +<tag-desc> +defines a directory for storing temporary files +with data received from SCGI servers. +After installation, the directory can always be changed in the +<path>nginx.conf</path> configuration file using the +<link doc="http/ngx_http_scgi_module.xml" id="scgi_temp_path"/> +directive. +By default the directory is named +<path><value>prefix</value>/scgi_temp</path>. +</tag-desc> + +</list> +</para> + +<para> +<list type="tag"> + +<tag-name> +<literal>--without-http</literal> +</tag-name> +<tag-desc> +disables the <link doc="http/ngx_http_core_module.xml">HTTP</link> server. +</tag-desc> + +<tag-name> +<literal>--without-http-cache</literal> +</tag-name> +<tag-desc> +disables HTTP cache. +</tag-desc> + +</list> +</para> + +<para> +<list type="tag"> + +<tag-name> +<literal>--with-mail</literal><br/> +<literal>--with-mail=dynamic</literal> +</tag-name> +<tag-desc> +enables POP3/IMAP4/SMTP +<link doc="mail/ngx_mail_core_module.xml">mail proxy</link> server. +</tag-desc> + +<tag-name> +<literal>--with-mail_ssl_module</literal> </tag-name> <tag-desc> enables building a module that adds the -<link doc="http/ngx_http_ssl_module.xml">HTTPS protocol support</link> -to an HTTP server. +<link doc="mail/ngx_mail_ssl_module.xml">SSL/TLS protocol support</link> +to the mail proxy server. This module is not built by default. The OpenSSL library is required to build and run this module. </tag-desc> <tag-name> -<literal>--with-pcre=<value>path</value></literal> +<literal>--without-mail_pop3_module</literal> +</tag-name> +<tag-desc> +disables the <link doc="mail/ngx_mail_pop3_module.xml">POP3</link> protocol +in mail proxy server. +</tag-desc> + +<tag-name> +<literal>--without-mail_imap_module</literal> +</tag-name> +<tag-desc> +disables the <link doc="mail/ngx_mail_imap_module.xml">IMAP</link> protocol +in mail proxy server. +</tag-desc> + +<tag-name> +<literal>--without-mail_smtp_module</literal> +</tag-name> +<tag-desc> +disables the <link doc="mail/ngx_mail_smtp_module.xml">SMTP</link> protocol +in mail proxy server. +</tag-desc> + +</list> +</para> + +<para> +<list type="tag"> + +<tag-name> +<literal>--with-stream</literal><br/> +<literal>--with-stream=dynamic</literal> +</tag-name> +<tag-desc> +enables building the +<link doc="stream/ngx_stream_core_module.xml">stream module</link> +for generic TCP/UDP proxying and load balancing. +This module is not built by default. +</tag-desc> + +<tag-name> +<literal>--with-stream_ssl_module</literal> +</tag-name> +<tag-desc> +enables building a module that adds the +<link doc="stream/ngx_stream_ssl_module.xml">SSL/TLS protocol support</link> +to the stream module. +This module is not built by default. +The OpenSSL library is required to build and run this module. +</tag-desc> + +<tag-name> +<literal>--with-stream_realip_module</literal> </tag-name> <tag-desc> -sets the path to the sources of the PCRE library. -The library distribution (version -4.4—8.41) needs to be downloaded from the -<link url="http://www.pcre.org">PCRE</link> site and extracted. -The rest is done by nginx’s <command>./configure</command> and -<command>make</command>. -The library is required for regular expressions support in the -<link doc="http/ngx_http_core_module.xml" id="location"/> directive -and for the -<link doc="http/ngx_http_rewrite_module.xml">ngx_http_rewrite_module</link> -module. +enables building the +<link doc="http/ngx_stream_realip_module.xml">ngx_stream_realip_module</link> +module that changes the client address to the address +sent in the PROXY protocol header. +This module is not built by default. +</tag-desc> + +<tag-name> +<literal>--with-stream_geoip_module</literal><br/> +<literal>--with-stream_geoip_module=dynamic</literal> +</tag-name> +<tag-desc> +enables building the +<link doc="stream/ngx_stream_geoip_module.xml">ngx_stream_geoip_module</link> +module that creates variables depending on the client IP address +and the precompiled +<link url="http://www.maxmind.com">MaxMind</link> databases. +This module is not built by default. +</tag-desc> + +<tag-name> +<literal>--with-stream_ssl_preread_module</literal> +</tag-name> +<tag-desc> +enables building the +<link doc="stream/ngx_stream_ssl_preread_module.xml">ngx_stream_ssl_preread_module</link> +module that allows extracting information from the +<link url="https://tools.ietf.org/html/rfc5246#section-7.4.1.2">ClientHello</link> +message without terminating SSL/TLS. +This module is not built by default. +</tag-desc> + +<tag-name> +<literal>--without-stream_limit_conn_module</literal> +</tag-name> +<tag-desc> +disables building the +<link doc="stream/ngx_stream_limit_conn_module.xml">ngx_stream_limit_conn_module</link> +module that limits the number of connections per key, for example, +the number of connections from a single IP address. +</tag-desc> + +<tag-name> +<literal>--without-stream_access_module</literal> +</tag-name> +<tag-desc> +disables building the +<link doc="stream/ngx_stream_access_module.xml">ngx_stream_access_module</link> +module that allows limiting access to certain client addresses. +</tag-desc> + +<tag-name> +<literal>--without-stream_geo_module</literal> +</tag-name> +<tag-desc> +disables building the +<link doc="stream/ngx_stream_geo_module.xml">ngx_stream_geo_module</link> +module that creates variables +with values depending on the client IP address. </tag-desc> <tag-name> -<literal>--with-pcre-jit</literal> +<literal>--without-stream_map_module</literal> +</tag-name> +<tag-desc> +disables building the +<link doc="stream/ngx_stream_map_module.xml">ngx_stream_map_module</link> +module that creates variables +with values depending on values of other variables. +</tag-desc> + +<tag-name> +<literal>--without-stream_split_clients_module</literal> +</tag-name> +<tag-desc> +disables building the +<link doc="stream/ngx_stream_split_clients_module.xml">ngx_stream_split_clients_module</link> +module that creates variables for A/B testing. +</tag-desc> + +<tag-name> +<literal>--without-stream_return_module</literal> </tag-name> <tag-desc> -builds the PCRE library with -“just-in-time compilation” support (1.1.12, the -<link doc="ngx_core_module.xml" id="pcre_jit"/> directive). +disables building the +<link doc="stream/ngx_stream_return_module.xml">ngx_stream_return_module</link> +module that sends some specified value to the client +and then closes the connection. +</tag-desc> + +<tag-name> +<literal>--without-stream_upstream_hash_module</literal> +</tag-name> +<tag-desc> +disables building a module that implements the +<link doc="stream/ngx_stream_upstream_module.xml" id="hash"/> +load balancing method. +</tag-desc> + +<tag-name> +<literal>--without-stream_upstream_least_conn_module</literal> +</tag-name> +<tag-desc> +disables building a module that implements the +<link doc="stream/ngx_stream_upstream_module.xml" id="least_conn"/> +load balancing method. </tag-desc> <tag-name> -<literal>--with-zlib=<value>path</value></literal> +<literal>--without-stream_upstream_zone_module</literal> +</tag-name> +<tag-desc> +disables building a module that makes it possible to store run-time state +of an upstream group in a shared memory +<link doc="stream/ngx_stream_upstream_module.xml" id="zone"/>. +</tag-desc> + +</list> +</para> + +<para> +<list type="tag"> + +<tag-name> +<literal>--with-google_perftools_module</literal> +</tag-name> +<tag-desc> +enables building the +<link doc="ngx_google_perftools_module.xml">ngx_google_perftools_module</link> +module that enables profiling of nginx worker processes using +<link url="https://github.com/gperftools/gperftools">Google Performance Tools</link>. +The module is intended for nginx developers and is not built by default. +</tag-desc> + +<tag-name> +<literal>--with-cpp_test_module</literal> </tag-name> <tag-desc> -sets the path to the sources of the zlib library. -The library distribution (version -1.1.3—1.2.11) needs to be downloaded from the -<link url="http://zlib.net">zlib</link> site and extracted. -The rest is done by nginx’s <command>./configure</command> and -<command>make</command>. -The library is required for the -<link doc="http/ngx_http_gzip_module.xml">ngx_http_gzip_module</link> module. +enables building the +<literal>ngx_cpp_test_module</literal> module. +</tag-desc> + +</list> +</para> + +<para> +<list type="tag"> + +<tag-name> +<literal>--add-module=<value>path</value></literal> +</tag-name> +<tag-desc> +enables an external module. +</tag-desc> + +<tag-name> +<literal>--add-dynamic-module=<value>path</value></literal> +</tag-name> +<tag-desc> +enables an external dynamic module. +</tag-desc> + +</list> +</para> + +<para> +<list type="tag"> + +<tag-name> +<literal>--with-compat</literal> +</tag-name> +<tag-desc> +enables dynamic modules compatibility. +</tag-desc> + +</list> +</para> + +<para> +<list type="tag"> + +<tag-name> +<literal>--with-cc=<value>path</value></literal> +</tag-name> +<tag-desc> +sets the name of the C compiler. +</tag-desc> + +<tag-name> +<literal>--with-cpp=<value>path</value></literal> +</tag-name> +<tag-desc> +sets the name of the C preprocessor. </tag-desc> <tag-name> @@ -248,8 +1141,161 @@ When using the system PCRE library under should be specified. </tag-desc> +<tag-name> +<literal>--with-cpu-opt=<value>cpu</value></literal> +</tag-name> +<tag-desc> +enables building per specified CPU: +<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> +disables the usage of the PCRE library. +</tag-desc> + +<tag-name> +<literal>--with-pcre</literal> +</tag-name> +<tag-desc> +forces the usage of the PCRE library. +</tag-desc> + +<tag-name> +<literal>--with-pcre=<value>path</value></literal> +</tag-name> +<tag-desc> +sets the path to the sources of the PCRE library. +The library distribution (version +4.4—8.41) needs to be downloaded from the +<link url="http://www.pcre.org">PCRE</link> site and extracted. +The rest is done by nginx’s <command>./configure</command> and +<command>make</command>. +The library is required for regular expressions support in the +<link doc="http/ngx_http_core_module.xml" id="location"/> directive +and for the +<link doc="http/ngx_http_rewrite_module.xml">ngx_http_rewrite_module</link> +module. +</tag-desc> + +<tag-name> +<literal>--with-pcre-opt=<value>parameters</value></literal> +</tag-name> +<tag-desc> +sets additional build options for PCRE. +</tag-desc> + +<tag-name> +<literal>--with-pcre-jit</literal> +</tag-name> +<tag-desc> +builds the PCRE library with +“just-in-time compilation” support (1.1.12, the +<link doc="ngx_core_module.xml" id="pcre_jit"/> directive). +</tag-desc> + +</list> +</para> + +<para> +<list type="tag"> + +<tag-name> +<literal>--with-zlib=<value>path</value></literal> +</tag-name> +<tag-desc> +sets the path to the sources of the zlib library. +The library distribution (version +1.1.3—1.2.11) needs to be downloaded from the +<link url="http://zlib.net">zlib</link> site and extracted. +The rest is done by nginx’s <command>./configure</command> and +<command>make</command>. +The library is required for the +<link doc="http/ngx_http_gzip_module.xml">ngx_http_gzip_module</link> module. +</tag-desc> + +<tag-name> +<literal>--with-zlib-opt=<value>parameters</value></literal> +</tag-name> +<tag-desc> +sets additional build options for zlib. +</tag-desc> + +<tag-name> +<literal>--with-zlib-asm=<value>cpu</value></literal> +</tag-name> +<tag-desc> +enables the use of the zlib assembler sources optimized +for one of the specified CPUs: +<literal>pentium</literal>, <literal>pentiumpro</literal>. +</tag-desc> + +</list> +</para> + +<para> +<list type="tag"> + +<tag-name> +<literal>--with-libatomic</literal> +</tag-name> +<tag-desc> +forces the libatomic_ops library usage. +</tag-desc> + +<tag-name> +<literal>--with-libatomic=<value>path</value></literal> +</tag-name> +<tag-desc> +sets the path to the libatomic_ops library sources. +</tag-desc> + +</list> +</para> + +<para> +<list type="tag"> + +<tag-name> +<literal>--with-openssl=<value>path</value></literal> +</tag-name> +<tag-desc> +sets the path to the OpenSSL library sources. +</tag-desc> + +<tag-name> +<literal>--with-openssl-opt=<value>parameters</value></literal> +</tag-name> +<tag-desc> +sets additional build options for OpenSSL. +</tag-desc> + +</list> +</para> + +<para> +<list type="tag"> + +<tag-name> +<literal>--with-debug</literal> +</tag-name> +<tag-desc> +enables the <link doc="debugging_log.xml">debugging log</link>. +</tag-desc> + +</list> </para> <para>
--- a/xml/ru/docs/configure.xml +++ b/xml/ru/docs/configure.xml @@ -8,7 +8,7 @@ <article name="Сборка nginx из исходных файлов" link="/ru/docs/configure.html" lang="ru" - rev="13"> + rev="14"> <section> @@ -17,7 +17,26 @@ Она определяет особенности системы и, в частности, методы, которые 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> @@ -42,6 +61,14 @@ </tag-desc> <tag-name> +<literal>--modules-path=<value>путь</value></literal> +</tag-name> +<tag-desc> +задаёт каталог, в который будут устанавливаться динамические модули. +По умолчанию используется каталог <path><value>префикс</value>/modules</path>. +</tag-desc> + +<tag-name> <literal>--conf-path=<value>путь</value></literal> </tag-name> <tag-desc> @@ -54,6 +81,18 @@ </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> @@ -67,35 +106,22 @@ </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>--http-log-path=<value>путь</value></literal> +<literal>--lock-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>. +<link doc="ngx_core_module.xml" id="lock_file"/>. +По умолчанию используется значение +<path><value>префикс</value>/logs/nginx.lock</path>. </tag-desc> -<tag-name id="build"> -<literal>--build=<value>имя</value></literal> -</tag-name> -<tag-desc> -задаёт необязательное имя сборки nginx. -</tag-desc> +</list> +</para> + +<para> +<list type="tag"> <tag-name> <literal>--user=<value>имя</value></literal> @@ -120,6 +146,32 @@ По умолчанию группа совпадает с именем непривилегированного пользователя. </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> @@ -143,6 +195,250 @@ </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> +<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> @@ -152,6 +448,105 @@ </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> @@ -174,52 +569,536 @@ HTTP-сервера. </tag-desc> <tag-name> -<literal>--with-http_ssl_module</literal> +<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_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> -разрешает сборку модуля для работы HTTP-сервера по -<link doc="http/ngx_http_ssl_module.xml">протоколу HTTPS</link>. +разрешает сборку модуля, добавляющего +<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>--with-pcre=<value>путь</value></literal> +<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> -задаёт путь к исходным текстам библиотеки PCRE. -Дистрибутив библиотеки (версию -4.4—8.41) нужно взять на сайте <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>. +разрешает сборку модуля +<link doc="http/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://tools.ietf.org/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>--with-pcre-jit</literal> +<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> -собирает библиотеку PCRE с -поддержкой JIT-компиляции (1.1.12, директива -<link doc="ngx_core_module.xml" id="pcre_jit"/>). +запрещает сборку модуля +<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_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>--with-zlib=<value>путь</value></literal> +<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> -задаёт путь к исходным текстам библиотеки zlib. -Дистрибутив библиотеки (версию -1.1.3—1.2.11) нужно взять на сайте -<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>. +разрешает сборку модуля +<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> @@ -243,8 +1122,160 @@ 1.1.3—1.2.11) нужно взять на сайте <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. +Дистрибутив библиотеки (версию +4.4—8.41) нужно взять на сайте <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> + +</list> +</para> + +<para> +<list type="tag"> + +<tag-name> +<literal>--with-zlib=<value>путь</value></literal> +</tag-name> +<tag-desc> +задаёт путь к исходным текстам библиотеки zlib. +Дистрибутив библиотеки (версию +1.1.3—1.2.11) нужно взять на сайте +<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>