从源码构建 nginx

Building nginx from Sources - 从源码构建 nginx

https://nginx.org/en/docs/configure.html

The build is configured using the configure command. It defines various aspects of the system, including the methods nginx is allowed to use for connection processing. At the end it creates a Makefile.

​ 构建过程使用 configure 命令进行配置。它定义了系统的各个方面，包括 nginx 允许使用的连接处理方法。在最后，它会创建一个 Makefile。

The configure command supports the following parameters:

​ configure 命令支持以下参数：

--help

prints a help message.

​ 打印帮助消息。

--prefix=path

defines a directory that will keep server files. This same directory will also be used for all relative paths set by configure (except for paths to libraries sources) and in the nginx.conf configuration file. It is set to the /usr/local/nginx directory by default.

​ 定义保存服务器文件的目录。这个目录也会用于所有由 configure 设置的相对路径（除了库源文件的路径）和 nginx.conf 配置文件中的路径。默认情况下，它设置为 /usr/local/nginx 目录。

--sbin-path=path

sets the name of an nginx executable file. This name is used only during installation. By default the file is named prefix/sbin/nginx.

​ 设置 nginx 可执行文件的名称。此名称仅在安装过程中使用。默认情况下，文件名为 prefix/sbin/nginx。

--modules-path=path

defines a directory where nginx dynamic modules will be installed. By default the prefix/modules directory is used.

​ 定义 nginx 动态模块将安装的目录。默认情况下，使用 prefix/modules 目录。

--conf-path=path

sets the name of an nginx.conf configuration file. If needs be, nginx can always be started with a different configuration file, by specifying it in the command-line parameter -c file. By default the file is named prefix/conf/nginx.conf.

​ 设置 nginx.conf 配置文件的名称。如果需要的话，可以始终通过在命令行参数中指定 -c file 来使用不同的配置文件启动 nginx。默认情况下，文件名为 prefix/conf/nginx.conf。

--error-log-path=path

sets the name of the primary error, warnings, and diagnostic file. After installation, the file name can always be changed in the nginx.conf configuration file using the error_log directive. By default the file is named prefix/logs/error.log.

​ 设置主错误、警告和诊断文件的名称。在安装后，可以在 nginx.conf 配置文件中使用 error_log 指令来随时更改文件名。默认情况下，文件名为 prefix/logs/error.log。

--pid-path=path

sets the name of an nginx.pid file that will store the process ID of the main process. After installation, the file name can always be changed in the nginx.conf configuration file using the pid directive. By default the file is named prefix/logs/nginx.pid.

​ 设置一个将存储主进程的进程 ID 的 nginx.pid 文件的名称。在安装后，可以在 nginx.conf 配置文件中使用 pid 指令来随时更改文件名。默认情况下，文件名为 prefix/logs/nginx.pid。

--lock-path=path

sets a prefix for the names of lock files. After installation, the value can always be changed in the nginx.conf configuration file using the lock_file directive. By default the value is prefix/logs/nginx.lock.

​ 设置锁文件名称的前缀。在安装后，可以在 nginx.conf 配置文件中使用 lock_file 指令来随时更改值。默认情况下，值为 prefix/logs/nginx.lock。

--user=name

sets the name of an unprivileged user whose credentials will be used by worker processes. After installation, the name can always be changed in the nginx.conf configuration file using the user directive. The default user name is nobody.

​ 设置一个非特权用户的名称，该用户的凭据将被 worker 进程使用。在安装后，可以在 nginx.conf 配置文件中使用 user 指令来随时更改名称。默认用户名为 nobody。

--group=name

sets the name of a group whose credentials will be used by worker processes. After installation, the name can always be changed in the nginx.conf configuration file using the user directive. By default, a group name is set to the name of an unprivileged user.

​ 设置一个组的名称，该组的凭据将被 worker 进程使用。在安装后，可以在 nginx.conf 配置文件中使用 user 指令来随时更改名称。默认情况下，组名设置为非特权用户的名称。

--build=name

sets an optional nginx build name.

​ 设置一个可选的 nginx 构建名称。

--builddir=path

sets a build directory.

​ 设置构建目录。

--with-select_module --without-select_module

enables or disables building a module that allows the server to work with the select() method. This module is built automatically if the platform does not appear to support more appropriate methods such as kqueue, epoll, or /dev/poll.

​ 启用或禁用构建一个允许服务器使用 select() 方法的模块。如果平台不支持更合适的方法，如 kqueue、epoll 或 /dev/poll，则将自动构建此模块。

--with-poll_module --without-poll_module

enables or disables building a module that allows the server to work with the poll() method. This module is built automatically if the platform does not appear to support more appropriate methods such as kqueue, epoll, or /dev/poll.

​ 启用或禁用构建一个允许服务器使用 poll() 方法的模块。如果平台不支持更合适的方法，如 kqueue、epoll 或 /dev/poll，则将自动构建此模块。

--with-threads

enables the use of thread pools.

​ 启用使用 线程池。

--with-file-aio

enables the use of asynchronous file I/O (AIO) on FreeBSD and Linux.

​ 在 FreeBSD 和 Linux 上启用使用 异步文件 I/O（AIO）。

--with-http_ssl_module

enables building a module that adds the HTTPS protocol support to an HTTP server. This module is not built by default. The OpenSSL library is required to build and run this module.

​ 启用构建一个模块，为 HTTP 服务器添加 HTTPS 协议支持。默认情况下，不构建此模块。构建和运行此模块需要 OpenSSL 库。

--with-http_v2_module

enables building a module that provides support for HTTP/2. This module is not built by default.

​ 启用构建一个模块，为 HTTP/2 提供支持。默认情况下，不构建此模块。

--with-http_v3_module

enables building a module that provides support for HTTP/3. This module is not built by default. An SSL library that provides HTTP/3 support is recommended to build and run this module, such as BoringSSL, LibreSSL, or QuicTLS. Otherwise, if using the OpenSSL library, OpenSSL compatibility layer will be used that does not support QUIC early data.

​ 启用构建一个模块，为 HTTP/3 提供支持。默认情况下，不构建此模块。建议使用支持 HTTP/3 的 SSL 库来构建和运行此模块，如 BoringSSL、LibreSSL 或 QuicTLS。否则，如果使用 OpenSSL 库，将使用不支持 QUIC 早期数据 的 OpenSSL 兼容性层。

--with-http_realip_module

enables building the ngx_http_realip_module module that changes the client address to the address sent in the specified header field. This module is not built by default.

​ 启用构建 ngx_http_realip_module 模块，将客户端地址更改为指定标头字段中发送的地址。默认情况下，不构建此模块。

--with-http_addition_module

enables building the ngx_http_addition_module module that adds text before and after a response. This module is not built by default.

​ 启用构建 ngx_http_addition_module 模块，向响应之前和之后添加文本。默认情况下，不构建此模块。

--with-http_xslt_module --with-http_xslt_module=dynamic

enables building the ngx_http_xslt_module module that transforms XML responses using one or more XSLT stylesheets. This module is not built by default. The libxml2 and libxslt libraries are required to build and run this module.

​ 启用构建 ngx_http_xslt_module 模块，使用一个或多个 XSLT 样式表转换 XML 响应。默认情况下，不构建此模块。构建和运行此模块需要 libxml2 和 libxslt 库。

--with-http_image_filter_module --with-http_image_filter_module=dynamic

enables building the ngx_http_image_filter_module module that transforms images in JPEG, GIF, PNG, and WebP formats. This module is not built by default.

​ 启用构建 ngx_http_image_filter_module 模块，转换 JPEG、GIF、PNG 和 WebP 格式的图像。默认情况下，不构建此模块。

--with-http_geoip_module --with-http_geoip_module=dynamic

enables building the ngx_http_geoip_module module that creates variables depending on the client IP address and the precompiled MaxMind databases. This module is not built by default.

​ 启用构建 ngx_http_geoip_module 模块，根据客户端 IP 地址和预编译的 MaxMind 数据库创建变量。默认情况下，不构建此模块。

--with-http_sub_module

enables building the ngx_http_sub_module module that modifies a response by replacing one specified string by another. This module is not built by default.

​ 启用构建 ngx_http_sub_module 模块，通过将一个指定的字符串替换为另一个字符串来修改响应。默认情况下，不构建此模块。

--with-http_dav_module

enables building the ngx_http_dav_module module that provides file management automation via the WebDAV protocol. This module is not built by default.

​ 启用构建 ngx_http_dav_module 模块，通过 WebDAV 协议提供文件管理自动化。默认情况下，不构建此模块。

--with-http_flv_module

enables building the ngx_http_flv_module module that provides pseudo-streaming server-side support for Flash Video (FLV) files. This module is not built by default.

​ 启用构建 ngx_http_flv_module 模块，为 Flash Video (FLV) 文件提供伪流式服务器端支持。默认情况下，不构建此模块。

--with-http_mp4_module

enables building the ngx_http_mp4_module module that provides pseudo-streaming server-side support for MP4 files. This module is not built by default.

​ 启用构建 ngx_http_mp4_module 模块，为 MP4 文件提供伪流式服务器端支持。默认情况下，不构建此模块。

--with-http_gunzip_module

enables building the ngx_http_gunzip_module module that decompresses responses with “Content-Encoding: gzip” for clients that do not support “gzip” encoding method. This module is not built by default.

​ 启用构建 ngx_http_gunzip_module 模块，对于不支持“gzip”编码方法的客户端，对“Content-Encoding: gzip”进行解压缩。默认情况下，不构建此模块。

--with-http_gzip_static_module

enables building the ngx_http_gzip_static_module module that enables sending precompressed files with the “.gz” filename extension instead of regular files. This module is not built by default.

​ 启用构建 ngx_http_gzip_static_module 模块，通过“.gz”文件扩展名而不是常规文件发送预压缩文件。默认情况下，不构建此模块。

--with-http_auth_request_module

enables building the ngx_http_auth_request_module module that implements client authorization based on the result of a subrequest. This module is not built by default.

​ 启用构建 ngx_http_auth_request_module 模块，基于子请求的结果实现客户端授权。默认情况下，不构建此模块。

--with-http_random_index_module

enables building the ngx_http_random_index_module module that processes requests ending with the slash character (‘/’) and picks a random file in a directory to serve as an index file. This module is not built by default.

​ 启用构建 ngx_http_random_index_module 模块，处理以斜杠字符（‘/’）结束的请求，并在目录中选择一个随机文件作为索引文件。默认情况下，不构建此模块。

--with-http_secure_link_module

enables building the ngx_http_secure_link_module module. This module is not built by default.

​ 启用构建 ngx_http_secure_link_module 模块。默认情况下，不构建此模块。

--with-http_degradation_module

enables building the ngx_http_degradation_module module. This module is not built by default.

​ 启用构建 ngx_http_degradation_module 模块。默认情况下，不构建此模块。

--with-http_slice_module

enables building the ngx_http_slice_module 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.

​ 启用构建 ngx_http_slice_module 模块，将请求分割成子请求，每个子请求返回一定范围的响应。该模块提供了更有效的大响应缓存。默认情况下，不构建此模块。

--with-http_stub_status_module

enables building the ngx_http_stub_status_module module that provides access to basic status information. This module is not built by default.

​ 启用构建 ngx_http_stub_status_module 模块，提供基本状态信息的访问。默认情况下，不构建此模块。

--without-http_charset_module

disables building the ngx_http_charset_module module that adds the specified charset to the “Content-Type” response header field and can additionally convert data from one charset to another.

​ 禁用构建 ngx_http_charset_module 模块，将指定的字符集添加到“Content-Type”响应头字段，并可以将数据从一个字符集转换为另一个字符集。

--without-http_gzip_module

disables building a module that compresses responses of an HTTP server. The zlib library is required to build and run this module.

​ 禁用构建 压缩响应 的模块。构建和运行此模块需要 zlib 库。

--without-http_ssi_module

disables building the ngx_http_ssi_module module that processes SSI (Server Side Includes) commands in responses passing through it.

​ 禁用构建 ngx_http_ssi_module 模块，处理通过它传递的响应中的 SSI (Server Side Includes) 命令。

--without-http_userid_module

disables building the ngx_http_userid_module module that sets cookies suitable for client identification.

​ 禁用构建 ngx_http_userid_module 模块，设置适用于客户端标识的 cookie。

--without-http_access_module

disables building the ngx_http_access_module module that allows limiting access to certain client addresses.

​ 禁用构建 ngx_http_access_module 模块，允许限制对某些客户端地址的访问。

--without-http_auth_basic_module

disables building the ngx_http_auth_basic_module module that allows limiting access to resources by validating the user name and password using the “HTTP Basic Authentication” protocol.

​ 禁用构建 ngx_http_auth_basic_module 模块，通过验证用户名称和密码来限制对资源的访问，使用“HTTP 基本认证”协议。

--without-http_mirror_module

disables building the ngx_http_mirror_module module that implements mirroring of an original request by creating background mirror subrequests.

​ 禁用构建 ngx_http_mirror_module 模块，通过创建后台镜像子请求来实现原始请求的镜像。

--without-http_autoindex_module

disables building the ngx_http_autoindex_module module that processes requests ending with the slash character (‘/’) and produces a directory listing in case the ngx_http_index_module module cannot find an index file.

​ 禁用构建 ngx_http_autoindex_module 模块，处理以斜杠字符（‘/’）结束的请求，并在 ngx_http_index_module 模块无法找到索引文件的情况下产生目录列表。

--without-http_geo_module

disables building the ngx_http_geo_module module that creates variables with values depending on the client IP address.

​ 禁用构建 ngx_http_geo_module 模块，根据客户端 IP 地址创建值的变量。

--without-http_map_module

disables building the ngx_http_map_module module that creates variables with values depending on values of other variables.

​ 禁用构建 ngx_http_map_module 模块，根据其他变量的值创建值的变量。

--without-http_split_clients_module

disables building the ngx_http_split_clients_module module that creates variables for A/B testing.

​ 禁用构建 ngx_http_split_clients_module 模块，该模块用于创建用于 A/B 测试的变量。

--without-http_referer_module

disables building the ngx_http_referer_module module that can block access to a site for requests with invalid values in the “Referer” header field.

​ 禁用构建 ngx_http_referer_module 模块，该模块用于阻止带有无效值的“Referer”请求头字段的访问。

--without-http_rewrite_module

disables building a module that allows an HTTP server to redirect requests and change URI of requests. The PCRE library is required to build and run this module.

​ 禁用构建模块，允许 HTTP 服务器重定向请求并更改请求的 URI。构建和运行此模块需要 PCRE 库。

--without-http_proxy_module

disables building an HTTP server proxying module.

​ 禁用构建一个 HTTP 服务器 代理模块。

--without-http_fastcgi_module

disables building the ngx_http_fastcgi_module module that passes requests to a FastCGI server.

​ 禁用构建 ngx_http_fastcgi_module 模块，该模块用于将请求传递给 FastCGI 服务器。

--without-http_uwsgi_module

disables building the ngx_http_uwsgi_module module that passes requests to a uwsgi server.

​ 禁用构建 ngx_http_uwsgi_module 模块，该模块用于将请求传递给 uwsgi 服务器。

--without-http_scgi_module

disables building the ngx_http_scgi_module module that passes requests to an SCGI server.

​ 禁用构建 ngx_http_scgi_module 模块，该模块用于将请求传递给 SCGI 服务器。

--without-http_grpc_module

disables building the ngx_http_grpc_module module that passes requests to a gRPC server.

​ 禁用构建 ngx_http_grpc_module 模块，该模块用于将请求传递给 gRPC 服务器。

--without-http_memcached_module

disables building the ngx_http_memcached_module module that obtains responses from a memcached server.

​ 禁用构建 ngx_http_memcached_module 模块，该模块用于从 memcached 服务器获取响应。

--without-http_limit_conn_module

disables building the ngx_http_limit_conn_module module that limits the number of connections per key, for example, the number of connections from a single IP address.

​ 禁用构建 ngx_http_limit_conn_module 模块，该模块用于限制每个键的连接数，例如来自单个 IP 地址的连接数。

--without-http_limit_req_module

disables building the ngx_http_limit_req_module module that limits the request processing rate per key, for example, the processing rate of requests coming from a single IP address.

​ 禁用构建 ngx_http_limit_req_module 模块，该模块用于限制每个键的请求处理速率，例如来自单个 IP 地址的请求处理速率。

--without-http_empty_gif_module

disables building a module that emits single-pixel transparent GIF.

​ 禁用构建一个模块，用于生成单像素透明 GIF。

--without-http_browser_module

disables building the ngx_http_browser_module module that creates variables whose values depend on the value of the “User-Agent” request header field.

​ 禁用构建 ngx_http_browser_module 模块，该模块用于创建取决于“User-Agent”请求头字段值的变量。

--without-http_upstream_hash_module

disables building a module that implements the hash load balancing method.

​ 禁用构建一个模块，该模块实现 hash 负载均衡方法。

--without-http_upstream_ip_hash_module

disables building a module that implements the ip_hash load balancing method.

​ 禁用构建一个模块，该模块实现 ip_hash 负载均衡方法。

--without-http_upstream_least_conn_module

disables building a module that implements the least_conn load balancing method.

​ 禁用构建一个模块，该模块实现 least_conn 负载均衡方法。

--without-http_upstream_random_module

disables building a module that implements the random load balancing method.

​ 禁用构建一个模块，该模块实现 random 负载均衡方法。

--without-http_upstream_keepalive_module

disables building a module that provides caching of connections to upstream servers.

​ 禁用构建一个模块，该模块提供到上游服务器的连接缓存。

--without-http_upstream_zone_module

disables building a module that makes it possible to store run-time state of an upstream group in a shared memory zone.

​ 禁用构建一个模块，该模块使得可以在共享内存 zone 中存储上游组的运行时状态。

--with-http_perl_module --with-http_perl_module=dynamic

enables building the embedded Perl module. This module is not built by default.

​ 启用构建 嵌入式 Perl 模块。默认情况下，不构建此模块。

--with-perl_modules_path=path

defines a directory that will keep Perl modules.

​ 定义存储 Perl 模块的目录。

--with-perl=path

sets the name of the Perl binary.

​ 设置 Perl 二进制文件的名称。

--http-log-path=path

sets the name of the primary request log file of the HTTP server. After installation, the file name can always be changed in the nginx.conf configuration file using the access_log directive. By default the file is named prefix/logs/access.log.

​ 设置 HTTP 服务器的主请求日志文件的名称。安装后，始终可以通过 nginx.conf 配置文件中的 access_log 指令更改文件名。默认情况下，文件名为 prefix/logs/access.log。

--http-client-body-temp-path=path

defines a directory for storing temporary files that hold client request bodies. After installation, the directory can always be changed in the nginx.conf configuration file using the client_body_temp_path directive. By default the directory is named prefix/client_body_temp.

​ 定义存储保存客户端请求主体的临时文件的目录。安装后，始终可以通过 nginx.conf 配置文件中的 client_body_temp_path 指令更改目录。默认情况下，目录名为 prefix/client_body_temp。

--http-proxy-temp-path=path

defines a directory for storing temporary files with data received from proxied servers. After installation, the directory can always be changed in the nginx.conf configuration file using the proxy_temp_path directive. By default the directory is named prefix/proxy_temp.

​ 定义存储保存从代理服务器接收的数据的临时文件的目录。安装后，始终可以通过 nginx.conf 配置文件中的 proxy_temp_path 指令更改目录。默认情况下，目录名为 prefix/proxy_temp。

--http-fastcgi-temp-path=path

defines a directory for storing temporary files with data received from FastCGI servers. After installation, the directory can always be changed in the nginx.conf configuration file using the fastcgi_temp_path directive. By default the directory is named prefix/fastcgi_temp.

​ 定义存储保存从 FastCGI 服务器接收的数据的临时文件的目录。安装后，始终可以通过 nginx.conf 配置文件中的 fastcgi_temp_path 指令更改目录。默认情况下，目录名为 prefix/fastcgi_temp。

--http-uwsgi-temp-path=path

defines a directory for storing temporary files with data received from uwsgi servers. After installation, the directory can always be changed in the nginx.conf configuration file using the uwsgi_temp_path directive. By default the directory is named prefix/uwsgi_temp.

​ 定义存储保存从 uwsgi 服务器接收的数据的临时文件的目录。安装后，始终可以通过 nginx.conf 配置文件中的 uwsgi_temp_path 指令更改目录。默认情况下，目录名为 prefix/uwsgi_temp。

--http-scgi-temp-path=path

defines a directory for storing temporary files with data received from SCGI servers. After installation, the directory can always be changed in the nginx.conf configuration file using the scgi_temp_path directive. By default the directory is named prefix/scgi_temp.

​ 定义存储保存从 SCGI 服务器接收的数据的临时文件的目录。安装后，始终可以通过 nginx.conf 配置文件中的 scgi_temp_path 指令更改目录。默认情况下，目录名为 prefix/scgi_temp。

--without-http

disables the HTTP server.

​ 禁用 HTTP 服务器。

--without-http-cache

disables HTTP cache.

​ 禁用 HTTP 缓存。

--with-mail --with-mail=dynamic

enables POP3/IMAP4/SMTP mail proxy server.

​ 启用构建 POP3/IMAP4/SMTP 邮件代理 服务器。

--with-mail_ssl_module

enables building a module that adds the SSL/TLS protocol support to the mail proxy server. This module is not built by default. The OpenSSL library is required to build and run this module.

​ 启用构建一个模块，为邮件代理服务器添加 SSL/TLS 协议支持。默认情况下，不构建此模块。构建和运行此模块需要 OpenSSL 库。

--without-mail_pop3_module

disables the POP3 protocol in mail proxy server.

​ 禁用邮件代理服务器中的 POP3 协议。

--without-mail_imap_module

disables the IMAP protocol in mail proxy server.

​ 禁用邮件代理服务器中的 IMAP 协议。

--without-mail_smtp_module

disables the SMTP protocol in mail proxy server.

​ 禁用邮件代理服务器中的 SMTP 协议。

--with-stream --with-stream=dynamic

enables building the stream module for generic TCP/UDP proxying and load balancing. This module is not built by default.

​ 启用构建 流模块，用于通用的 TCP/UDP 代理和负载均衡。默认情况下，不构建此模块。

--with-stream_ssl_module

enables building a module that adds the SSL/TLS protocol support to the stream module. This module is not built by default. The OpenSSL library is required to build and run this module.

​ 启用构建一个模块，为流模块添加 SSL/TLS 协议支持。默认情况下，不构建此模块。构建和运行此模块需要 OpenSSL 库。

--with-stream_realip_module

enables building the ngx_stream_realip_module module that changes the client address to the address sent in the PROXY protocol header. This module is not built by default.

​ 启用构建 ngx_stream_realip_module 模块，该模块用于将客户端地址更改为在 PROXY 协议头中发送的地址。默认情况下，不构建此模块。

--with-stream_geoip_module --with-stream_geoip_module=dynamic

enables building the ngx_stream_geoip_module module that creates variables depending on the client IP address and the precompiled MaxMind databases. This module is not built by default.

​ 启用构建 ngx_stream_geoip_module 模块，该模块根据客户端 IP 地址和预编译的 MaxMind 数据库创建变量。默认情况下，不构建此模块。

--with-stream_ssl_preread_module

enables building the ngx_stream_ssl_preread_module module that allows extracting information from the ClientHello message without terminating SSL/TLS. This module is not built by default.

​ 启用构建 ngx_stream_ssl_preread_module 模块，该模块允许在不终止 SSL/TLS 的情况下从 ClientHello 消息中提取信息。默认情况下，不构建此模块。

--without-stream_limit_conn_module

disables building the ngx_stream_limit_conn_module module that limits the number of connections per key, for example, the number of connections from a single IP address.

​ 禁用构建 ngx_stream_limit_conn_module 模块，该模块用于限制每个键的连接数，例如来自单个 IP 地址的连接数。

--without-stream_access_module

disables building the ngx_stream_access_module module that allows limiting access to certain client addresses.

​ 禁用构建 ngx_stream_access_module 模块，该模块允许限制对某些客户端地址的访问。

--without-stream_geo_module

disables building the ngx_stream_geo_module module that creates variables with values depending on the client IP address.

​ 禁用构建 ngx_stream_geo_module 模块，该模块根据客户端 IP 地址创建值的变量。

--without-stream_map_module

disables building the ngx_stream_map_module module that creates variables with values depending on values of other variables.

​ 禁用构建 ngx_stream_map_module 模块，该模块根据其他变量的值创建值的变量。

--without-stream_split_clients_module

disables building the ngx_stream_split_clients_module module that creates variables for A/B testing.

​ 禁用构建 ngx_stream_split_clients_module 模块，该模块用于创建用于 A/B 测试的变量。

--without-stream_return_module

disables building the ngx_stream_return_module module that sends some specified value to the client and then closes the connection.

​ 禁用构建 ngx_stream_return_module 模块，该模块向客户端发送某些指定的值，然后关闭连接。

--without-stream_set_module

disables building the ngx_stream_set_module module that sets a value for a variable.

​ 禁用构建 ngx_stream_set_module 模块，该模块用于设置变量的值。

--without-stream_upstream_hash_module

disables building a module that implements the hash load balancing method.

​ 禁用构建一个模块，该模块实现 hash 负载均衡方法。

--without-stream_upstream_least_conn_module

disables building a module that implements the least_conn load balancing method.

​ 禁用构建一个模块，该模块实现 least_conn 负载均衡方法。

--without-stream_upstream_random_module

disables building a module that implements the random load balancing method.

​ 禁用构建一个模块，该模块实现 random 负载均衡方法。

--without-stream_upstream_zone_module

disables building a module that makes it possible to store run-time state of an upstream group in a shared memory zone.

​ 禁用构建一个模块，该模块使得可以在共享内存 zone 中存储上游组的运行时状态。

--with-google_perftools_module

enables building the ngx_google_perftools_module module that enables profiling of nginx worker processes using Google Performance Tools. The module is intended for nginx developers and is not built by default.

​ 启用构建 ngx_google_perftools_module 模块，该模块使用 Google Performance Tools 对 nginx 工作进程进行分析。该模块针对 nginx 开发人员，不会默认构建。

--with-cpp_test_module

enables building the ngx_cpp_test_module module.

​ 启用构建 ngx_cpp_test_module 模块。

--add-module=path

enables an external module.

​ 启用外部模块。

--add-dynamic-module=path

enables an external dynamic module.

​ 启用外部动态模块。

--with-compat

enables dynamic modules compatibility.

​ 启用动态模块兼容性。

--with-cc=path

sets the name of the C compiler.

​ 设置 C 编译器的名称。

--with-cpp=path

sets the name of the C preprocessor.

​ 设置 C 预处理器的名称。

--with-cc-opt=parameters

sets additional parameters that will be added to the CFLAGS variable. When using the system PCRE library under FreeBSD, --with-cc-opt="-I /usr/local/include" should be specified. If the number of files supported by select() needs to be increased it can also be specified here such as this: --with-cc-opt="-D FD_SETSIZE=2048".

​ 设置将添加到 CFLAGS 变量的附加参数。在 FreeBSD 下使用系统 PCRE 库时，应指定 --with-cc-opt="-I /usr/local/include"。如果需要增加 select() 支持的文件数，也可以在此指定，例如：--with-cc-opt="-D FD_SETSIZE=2048"。

--with-ld-opt=parameters

sets additional parameters that will be used during linking. When using the system PCRE library under FreeBSD, --with-ld-opt="-L /usr/local/lib" should be specified.

​ 设置在链接期间使用的附加参数。在 FreeBSD 下使用系统 PCRE 库时，应指定 --with-ld-opt="-L /usr/local/lib"。

--with-cpu-opt=cpu

enables building per specified CPU: pentium, pentiumpro, pentium3, pentium4, athlon, opteron, sparc32, sparc64, ppc64.

​ 启用为特定 CPU 构建：pentium、pentiumpro、pentium3、pentium4、athlon、opteron、sparc32、sparc64、ppc64。

--without-pcre

disables the usage of the PCRE library.

​ 禁用 PCRE 库的使用。

--with-pcre

forces the usage of the PCRE library.

​ 强制使用 PCRE 库。

--with-pcre=path

sets the path to the sources of the PCRE library. The library distribution needs to be downloaded from the PCRE site and extracted. The rest is done by nginx’s ./configure and make. The library is required for regular expressions support in the location directive and for the ngx_http_rewrite_module module.

​ 设置 PCRE 库源代码的路径。需要从 PCRE 网站下载库分发包并解压。其余工作由 nginx 的 ./configure 和 make 完成。此库在 location 指令中支持正则表达式以及 ngx_http_rewrite_module 模块中所需。

--with-pcre-opt=parameters

sets additional build options for PCRE.

​ 为 PCRE 设置额外的构建选项。

--with-pcre-jit

builds the PCRE library with “just-in-time compilation” support (1.1.12, the pcre_jit directive).

​ 以“即时编译”支持构建 PCRE 库（1.1.12，pcre_jit 指令）。

--without-pcre2

disables use of the PCRE2 library instead of the original PCRE library (1.21.5).

​ 禁用使用 PCRE2 库替代原始 PCRE 库（1.21.5）。

--with-zlib=path

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 zlib site and extracted. The rest is done by nginx’s ./configure and make. The library is required for the ngx_http_gzip_module module.

​ 设置 zlib 库源代码的路径。需要从 zlib 网站下载库分发包（版本 1.1.3 — 1.2.11）并解压。其余工作由 nginx 的 ./configure 和 make 完成。此库在 ngx_http_gzip_module 模块中所需。

--with-zlib-opt=parameters

sets additional build options for zlib.

​ 为 zlib 设置额外的构建选项。

--with-zlib-asm=cpu

enables the use of the zlib assembler sources optimized for one of the specified CPUs: pentium, pentiumpro.

​ 启用针对指定 CPU 优化的 zlib 汇编源代码：pentium、pentiumpro。

--with-libatomic

forces the libatomic_ops library usage.

​ 强制使用 libatomic_ops 库。

--with-libatomic=path

sets the path to the libatomic_ops library sources.

​ 设置 libatomic_ops 库源代码的路径。

--with-openssl=path

sets the path to the OpenSSL library sources.

​ 设置 OpenSSL 库源代码的路径。

--with-openssl-opt=parameters

sets additional build options for OpenSSL.

​ 为 OpenSSL 设置额外的构建选项。

--with-debug

enables the debugging log.

​ 启用调试日志。

Example of parameters usage (all of this needs to be typed in one line):

​ 以下是一个参数使用示例（所有内容需要在一行中输入）：

./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.2.11

After configuration, nginx is compiled and installed using make.

​ 配置后，可以使用 make 编译和安装 nginx。