Use the configure command to configure build. It defines the various aspects of the system, the method comprising nginx allows for connection processing. Finally, it creates a Makefile.
The configure command supports the following parameters:
--help
Print help information.
--prefix=path
The directory server will retain the definition file. This directory will be the same for all the relative path disposed configure (except library source path) and nginx.conf profile. / Usr / local directory is set to the next / nginx by default.
--sbin-path=path
Sets the name of nginx executable file. This name is used only during installation. By default, the file name prefix / sbin / nginx.
--modules-path=path
Nginx directory defined in the dynamic module installed therein. Use prefix / modules directory by default.
--conf-path=path
Setting name nginx.conf profile. If desired, you can start it by nginx specified on the command line argument to always use a different configuration file. By default, the file name. -c fileprefix / conf / nginx.conf
--error-log-path=path
The main setting errors, warnings, and diagnostic file name. After installation, you can always nginx.conf change the file name in the configuration file using the error_log directive. By default, the file name prefix / logs / error.log.
--pid-path=path
Set nginx.pid the file name stored in the main process ID of the process. After installation, you can always nginx.conf change the file name in the configuration file using the pid directive. By default, the file name prefix / logs / nginx.pid.
--lock-path=path
Set to lock the file name prefix. After installation, you can always change the value nginx.conf in the configuration file used lock_file directive. By default, the value of prefix / logs / Nginx. Lock .
--user=name
Sets the name of a non-privileged user, whose credentials will be used by the worker process. After installation, you can always use nginx.conf user command to change the name in the configuration file. The default user name is nobody.
--group=name
Sets the name of the group to be used by a worker process their credentials. After installation, you can always use nginx.conf user command to change the name in the configuration file. By default, the group name sets the name of a non-privileged user.
--build=name
An optional set of nginx build name.
--builddir=path
Set up the build directory.
--with-select_module 和 --without-select_module
Enable or disable the use of the building block allows the server to select () method. If the platform does not seem to support a more appropriate method kqueue, epoll or / dev / poll and so on, it will automatically build this module.
--with-poll_module 和 --without-poll_module
Enable or disable the use of the building block allows the server to poll () method. If the platform does not seem to support a more appropriate method kqueue, epoll or / dev / poll and so on, it will automatically build this module.
--with-threads
Enables the use of the thread pool.
--with-file-aio
Supports the use of asynchronous file I / O (AIO) on FreeBSD and Linux.
--with-http_ssl_module
Enabling HTTPS protocol support building will be added to the HTTP server function module. This module is not built by default. OpenSSL libraries need to build and run this module.
--with-http_v2_module
Construction of a support module, which provides support for HTTP / 2 in. This module is not built by default.
--with-http_realip_module
Construction ngx_http_realip_module support module, which will change the client address with the address specified in the transmission header field. This module is not built by default.
--with-http_addition_module
Ngx_http_addition_module allows the construction module, which is added before and after the text and response. This module is not built by default.
--with-http_xslt_module 和 --with-http_xslt_module=dynamic
Construction ngx_http_xslt_module support module that uses one or more XSLT stylesheets to transform the XML response. This module is not built by default. The libxml2 and libxslt libraries are required to build and run this module.
--with-http_image_filter_module 和 --with-http_image_filter_module=dynamic
Supports building ngx_http_image_filter_module module that can convert images JPEG, GIF, PNG and WebP format. This module is not built by default.
--with-http_geoip_module 和 --with-http_geoip_module=dynamic
Supports building ngx_http_geoip_module module, which creates a variable based on the client IP address and MaxMind database precompiled. This module is not built by default.
--with-http_sub_module
Construction ngx_http_sub_module support module, which specify the replacement string to another string specified by a modified response. This module is not built by default.
--with-http_dav_module
Supports building ngx_http_dav_module module, which provides automated file management via WebDAV protocol. This module is not built by default.
--with-http_flv_module
Supports building ngx_http_flv_module module, the module for the Flash Video (FLV) to provide pseudo-streaming server-side support files. This module is not built by default.
--with-http_mp4_module
Construction ngx_http_mp4_module support module, which provides support for the pseudo-streaming server MP4 file. This module is not built by default.
--with-http_gunzip_module
Support does not support "gzip" client constructs encoding method ngx_http_gunzip_module module that use the "Content-Encoding: gzip" in response to decompression. This module is not built by default.
--with-http_gzip_static_module
Supports building ngx_http_gzip_static_module module, which supports sending .gz extension "" pre-compressed files instead of regular files. This module is not built by default.
--with-http_auth_request_module
It allows the construction ngx_http_auth_request_module module that implements client authorization based on a result of the sub-request. This module is not built by default.
--with-http_random_index_module
Construction ngx_http_random_index_module support module, the process module with a slash ( ' / ' ) at the end of the request, and randomly select a file from the index file as a directory. This module is not built by default.
--with-http_secure_link_module
Enable building ngx_http_secure_link_module module. This module is not built by default.
--with-http_degradation_module
Enable building ngx_http_degradation_module module. This module is not built by default.
--with-http_slice_module
Construction ngx_http_slice_module support module, which will be split into sub-request request, each sub-request returns a range response. This module provides a more efficient large response cache. This module is not built by default.
--with-http_stub_status_module
Supports building ngx_http_stub_status_module module, which provides access to basic status information. This module is not built by default.
--without-http_charset_module
Construction ngx_http_charset_module disabling module that the specified character set to the "Content-Type" header field in the response, and the data may be converted from one character set to another character set.
--without-http_gzip_module
Disable building blocks of a compressible in response to the HTTP server. zlib library to build and run this module is necessary.
--without-http_ssi_module
Construction ngx_http_ssi_module disable response processing module SSI (Server Side Includes) the command.
--without-http_userid_module
Disable building ngx_http_userid_module module that setting applies to the client's identity cookie.
--without-http_access_module
Disable building ngx_http_access_module module, which allows clients to restrict access to certain addresses.
--without-http_auth_basic_module
Disable building ngx_http_auth_basic_module module, which allows to restrict access to resources by using "HTTP Basic Authentication" protocol to authenticate the user name and password.
--without-http_mirror_module
Construction ngx_http_mirror_module disabling module, which is achieved by mirroring the original request to create background image sub-request.
--without-http_autoindex_module
Construction ngx_http_autoindex_module disabling module to process a slash ( ' / ' generates a directory listing case) at the end of the request, and does not find the index file ngx_http_index_module module.
--without-http_geo_module
Disable building ngx_http_geo_module module, the module creates value variable depending on the client's IP address.
--without-http_map_module
Disable building ngx_http_map_module module, the module creates a variable value depends on the value of other variables.
--without-http_split_clients_module
Construction ngx_http_split_clients_module disabling module, which creates a variable A / B test.
--without-http_referer_module
Construction ngx_http_referer_module disabling module, which can block the site access request having an invalid value of "Referer" header field.
--without-http_rewrite_module
Disable building permit HTTP server redirects requests and change requests URI module. Build and run this module requires the PCRE library.
--without-http_proxy_module
Disable build HTTP server proxy module.
--without-http_fastcgi_module
Construction passes the request to disable FastCGI ngx_http_fastcgi_module server module.
--without-http_uwsgi_module
Construction passes the request to disable ngx_http_uwsgi_module uwsgi server module.
--without-http_scgi_module
Construction passes the request to disable ngx_http_scgi_module SCGI server module.
--without-http_grpc_module
Construction passes the request to disable ngx_http_grpc_module gRPC server module.
--without-http_memcached_module
Construction ngx_http_memcached_module disabling module that memcached acquisition response from the server.
--without-http_limit_conn_module
Construction ngx_http_limit_conn_module disabling module, which limits the number of connections for each key, for example, connections of a single IP address.
--without-http_limit_req_module
Construction ngx_http_limit_req_module disabling module, which limits processing rate for each request key, e.g., the processing rate request from a single IP address.
--without-http_empty_gif_module
Building module issues disabling single pixel transparent GIF.
--without-http_browser_module
Construction ngx_http_browser_module disabling module, the value of the variable depends on the module creates "User-Agent" header field in the request value.
--without-http_upstream_hash_module
Disable building modules to achieve load balancing hashing method.
--without-http_upstream_ip_hash_module
Building implementation module ip_hash disable load balancing method.
--without-http_upstream_least_conn_module
Disable build a module minimum_conn achieve load balancing methods.
--without-http_upstream_keepalive_module
Construction of a disabling module to provide upstream cache server connection.
--without-http_upstream_zone_module
Building blocks is disabled, the module may be run upstream set of state stored in the shared memory area.
--with-http_perl_module 和 --with-http_perl_module=dynamic
Supports building embedded Perl modules. This module is not built by default.
--with-perl_modules_path=path
The definition of a directory, which will retain the Perl module.
--with-perl=path
Sets the name of Perl binary files.
--http-log-path=path
Set HTTP server's main request name of the log file. After installation, you can always use nginx.conf access_log directive to change the file name in the configuration file. By default, the file name prefix / logs / access.log.
--http-client-body-temp-path=path
Definitions used to store temporary files directory that contains the client request body. After installation, you can always change nginx.conf directory in the configuration file using client_body_temp_path instruction. By default, the directory named prefix / client_body_temp.
--http-proxy-temp-path=path
Define a directory for temporarily storing files containing data received from the proxy server to the. After installation, you can always change nginx.conf directory in the configuration file using proxy_temp_path instruction. By default, the directory named prefix / proxy_temp.
--http-fastcgi-temp-path=path
Define a directory for temporarily storing files containing data received from the server to the FastCGI. After installation, you can always change nginx.conf directory in the configuration file using fastcgi_temp_path instruction. By default, the directory named prefix / fastcgi_temp.
--http-uwsgi-temp-path=path
Define a directory, with the data received from the temporary file to the server uwsgi for storing. After installation, you can always change nginx.conf directory in the configuration file using uwsgi_temp_path instruction. By default, the directory named prefix / uwsgi_temp.
--http-scgi-temp-path=path
Definition of a directory, the temporary file with data received from the server to the SCGI for storing. After installation, you can always change nginx.conf directory in the configuration file using scgi_temp_path instruction. By default, the directory named prefix / scgi_temp.
--without-http
Disabling HTTP server.
--without-http-cache
Disable HTTP caching.
--with-mail 和 --with-mail=dynamic
Enabling POP3 / IMAP4 / SMTP mail proxy server.
--with-mail_ssl_module
Support the construction of a module, the module adds SSL / TLS protocol support to mail proxy server. This module is not built by default. OpenSSL libraries need to build and run this module.
--without-mail_pop3_module
Disable POP3 protocol mail proxy server.
--without-mail_imap_module
Disable IMAP mail protocol proxy server.
--without-mail_smtp_module
Disable SMTP mail protocol proxy server.
--with-stream 和 --with-stream=dynamic
Building support for general purpose flow module TCP / UDP proxy and load balancing. This module is not built by default.
--with-stream_ssl_module
Construction of a support module that is added SSL / TLS protocol to support streaming module. This module is not built by default. OpenSSL libraries need to build and run this module.
--with-stream_realip_module
Enable building capabilities ngx_stream_realip_module module, the module will change the address to send the client address is PROXY protocol header. This module is not built by default.
--with-stream_geoip_module 和 --with-stream_geoip_module=dynamic
Supports building ngx_stream_geoip_module module, which creates a variable based on the client IP address and MaxMind database precompiled. This module is not built by default.
--with-stream_ssl_preread_module
Construction ngx_stream_ssl_preread_module support module, which allows to extract information from a ClientHello message, without terminating the SSL / TLS. This module is not built by default.
--without-stream_limit_conn_module
Construction ngx_stream_limit_conn_module disabling module, which limits the number of connections for each key, for example, connections of a single IP address.
--without-stream_access_module
Disable building ngx_stream_access_module module, which allows clients to restrict access to certain addresses.
--without-stream_geo_module
Disable building ngx_stream_geo_module module, the module creates a variable value depending on the client IP address.
--without-stream_map_module
Disable building ngx_stream_map_module module, the module creates a variable value depends on the value of other variables.
--without-stream_split_clients_module
Construction ngx_stream_split_clients_module disabling module, which creates a variable A / B test.
--without-stream_return_module
Construction ngx_stream_return_module disabling module which transmits some of the specified value to the client, and then close the connection.
--without-stream_upstream_hash_module
Disable building modules to achieve load balancing hashing method.
--without-stream_upstream_least_conn_module
Disable build a module minimum_conn achieve load balancing methods.
--without-stream_upstream_zone_module
Building blocks is disabled, the module may be run upstream set of state stored in the shared memory area.
--with-google_perftools_module
It allows you to build ngx_google_perftools_module module that can use Google Performance Tools for nginx worker processes for performance analysis. The module is suitable for developers Nginx, not built by default.
--with-cpp_test_module
Enable building ngx_cpp_test_module module.
--add-module=path
Enabling external module.
--add-dynamic-module=path
Enable external dynamic module.
--with-compat
Enable dynamic module compatibility.
--with-cc=path
Set the name of the C compiler.
--with-cpp=path
Sets the name of the C preprocessor.
--with-cc-opt=parameters
Adding additional parameters to set the CFLAGS variable. When using the system PCRE library in the FreeBSD, --with-opt-CC = " -I / usr / local / the include " should be specified. If you select () the need to increase the number of file support, you can also specify here, for example: --with-CC-opt = " -D FD_SETSIZE = 2048 " .
--with-ld-opt=parameters
Set other parameters to be used during the link. When using the system PCRE library in the FreeBSD, --with-opt-LD = " -L / usr / local / lib " should be specified.
--with-cpu-opt=cpu
Each CPU can be specified in the building: pentium, pentiumpro, pentium3, pentium4, athlon, opteron, sparc32, sparc64, ppc64.
--without-pcre
Disable using the PCRE library.
--with-pcre
Mandatory use of the PCRE library.
--with-pcre=path
Set the path of PCRE library sources. Need to download and distribute library distribution (PCRE site from version 4. 4 - 8.43 ). The rest is done by nginx's ./configure and make. The expression library for support and positive location ngx_http_rewrite_module instruction module is required.
--with-pcre-opt=parameters
Set other options for the construction of PCRE.
--with-pcre-jit
Use "time compiler" support ( 1.1 . 12 , pcre_jit instruction) to build the PCRE library.
--with-zlib=path
Set the path zlib library source. Need from the zlib library site to download the release version (version 1 1.3 - 1.2 . 11 ) and unzip it. The rest is done by nginx's ./configure and make. ngx_http_gzip_module module requires the library.
--with-zlib-opt=parameters
Set other options for the construction of zlib.
--with-zlib-asm=cpu
It enables the use of a specified zlib optimized assembler source program in the CPU: pentium, pentiumpro.
--with-libatomic
Libatomic_ops forced to use the library.
--with-libatomic path =
Set the path libatomic_ops library source.
--with-openssl=path
Set the path OpenSSL library source.
--with-openssl-opt=parameters
Set other options for building OpenSSL.
--with-debug
Enable debug log.