# 从源码构建 nginx

编译时使用 `configure` 命令进行配置。它定义了系统的各个方面，包括了 nginx 进行连接处理使用的方法。最终它会创建出一个 `Makefile`。

`configure` 命令支持以下参数：

* **--help**

  打印帮助信息
* **--prefix=path**

  定义一个用于保留服务器文件的目录。此目录也将用于所有通过 `configure` 设置的相对路径（除了库源码路径外）和 `nginx.conf` 配置文件。默认设置为 `/usr/local/nginx` 目录。
* **--sbin-path=path**

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

  定义将安装 nginx 动态模块的目录。默认情况下，使用 `prefix/modules` 目录。
* **--conf-path=path**

  设置 `nginx.conf` 配置文件的名称。如果需要，nginx 可以使用不同的配置文件启动，方法是使用命令行参数 `-c` 指定文件。默认情况下，文件名为 `prefix/conf/nginx.conf`。
* **--error-log-path=path**

  设置主要错误、警告和诊断文件的名称。安装后，可以在 `nginx.conf` 配置文件中使用 [error\_log](http://nginx.org/en/docs/ngx_core_module.html#error_log) 指令更改文件名。默认情况下，文件名为 `prefix/logs/error.log`。
* **--pid-path=path**

  设置存储主进程的进程 ID 的 nginx.pid 文件名称。安装后，可以在 `nginx.conf` 配置文件中使用 [pid](http://nginx.org/en/docs/ngx_core_module.html#pid) 指令更改文件名。默认文件名为 `prefix/logs/nginx.pid`。
* **--lock-path=path**

  设置锁文件的名称前缀。安装后，可以在 `nginx.conf` 配置文件中使用 [lock\_file](http://nginx.org/en/docs/ngx_core_module.html#lock_file) 指令更改对应的值。默认值为 `prefix/logs/nginx.lock`。
* **--user=name**

  设置一个非特权用户名称，其凭据将由工作进程使用。安装后，可以在 `nginx.conf` 配置文件中使用 [user](http://nginx.org/en/docs/ngx_core_module.html#user) 指令更改名称。默认的用户名为 `nobody`。
* **--group=name**

  设置一个组的名称，其凭据将由工作进程使用。安装后，可以在 `nginx.conf` 配置文件中使用 [user](http://nginx.org/en/docs/ngx_core_module.html#user) 指令更改名称。默认情况下，组名称设置为一个非特权用户的名称。
* **--build=name**

  设置一个可选的 nginx 构建名称
* **--builddir=path**

  设置构建文件夹
* **--http-log-path=path**

  设置 HTTP 服务器主请求日志文件名称。安装后，可以在 `nginx.conf` 配置文件中使用 [access\_log](http://nginx.org/en/docs/http/ngx_http_log_module.html#access_log) 指令更改文件名。默认情况下，文件名为 `prefix/logs/access.log`。
* **--with-select\_module 和 --without-select\_module**

  启用或禁用构建允许服务器使用 `select()` 方法的模块。如果平台不支持其他更合适的方法（如 kqueue、epoll 或 /dev/poll），则将自动构建该模块。
* **--with-poll\_module 和 --without-poll\_module**

  启用或禁用构建允许服务器使用 `poll()` 方法的模块。如果平台不支持其他更合适的方法（如 kqueue、epoll 或 /dev/poll），则将自动构建该模块。
* **with-threads**

  允许使用线程池[thread pools](http://nginx.org/en/docs/ngx_core_module.html#thread_pool)
* **with-file-aio**

  启用在FreeBSD和Linux上[asynchronous file I/O](http://nginx.org/en/docs/http/ngx_http_core_module.html#aio) (aio)指令的使用
* **--without-http\_gzip\_module**

  禁用构建 HTTP 服务器[响应压缩](http://nginx.org/en/docs/http/ngx_http_gzip_module.html)模块。需要 zlib 库来构建和运行此模块。
* **--without-http\_rewrite\_module**

  禁用构建允许 HTTP 服务器[重定向请求](http://nginx.org/en/docs/http/ngx_http_rewrite_module.html)和[更改请求 URI](http://nginx.org/en/docs/http/ngx_http_rewrite_module.html) 的模块。需要 PCRE 库来构建和运行此模块。
* **--without-http\_proxy\_module**

  禁用构建 HTTP 服务器[代理模块](http://nginx.org/en/docs/http/ngx_http_proxy_module.html)。
* **--with-http\_ssl\_module**

  允许构建可将 [HTTPS 协议支持](http://nginx.org/en/docs/http/ngx_http_ssl_module.html)添加到 HTTP 服务器的模块。默认情况下，此模块参与构建。构建和运行此模块需要 OpenSSL 库支持。
* **with-http\_v2\_module**

  允许构建一个支持[HTTP/2](http://nginx.org/en/docs/http/ngx_http_v2_module.html) 的模块。默认情况下，该模块不构建。
* **with-http\_realip\_module**

  允许构建[ngx\_http\_realip\_module](http://nginx.org/en/docs/http/ngx_http_realip_module.html) 模块，该模块将客户端地址更改为在指定的header中发送的地址。该模块默认不构建。
* **with-http\_addition\_module**

  允许构建[ngx\_http\_addition\_module](http://nginx.org/en/docs/http/ngx_http_addition_module.html) 模块，该模块能够在响应之前和之后添加文本。该模块默认不构建。
* **with-http\_xslt\_module**和**with-http\_xslt\_module=dynamic**

  允许构建使用一个或者多个XSLT样式表转化为XML响应的[ngx\_http\_xslt\_module](http://nginx.org/en/docs/http/ngx_http_xslt_module.html)。该模块默认不构建。[libxslt](http://xmlsoft.org/XSLT/) 和 [libxml2](http://xmlsoft.org/) 库需要这个模块来构建和启动。
* **with-http\_image\_filter\_module**和**with-http\_image\_filter\_module=dynamic**

  允许构建[ngx\_http\_image\_filter\_module](http://nginx.org/en/docs/http/ngx_http_image_filter_module.html) 模块，该模块可以转换 JPEG, GIF, PNG, 和 WebP 格式的图片。该模块默认不构建。
* **with-http\_geoip\_module**和**with-http\_geoip\_module=dynamic**

  允许构建[ngx\_http\_geoip\_module](http://nginx.org/en/docs/http/ngx_http_geoip_module.html) 模块。该模块根据客户端 IP 地址和预编译[MaxMind](https://www.maxmind.com/en/home) 的数据库创建变量。该模块默认不构建。
* **with-http\_sub\_module**

  允许构建[ngx\_http\_sub\_module](http://nginx.org/en/docs/http/ngx_http_sub_module.html) 模块。该模块通过将一个指定的字符串替换为另一个来修改相应。该模块默认不构建。
* **with-http\_dav\_module**

  允许构建[ngx\_http\_dav\_module ](http://nginx.org/en/docs/http/ngx_http_dav_module.html)模块。该模块通过WebDEV协议提供文件管理自动化。该模块默认不构建。
* **with-http\_flv\_module**

  允许构建[ngx\_http\_flv\_module](http://nginx.org/en/docs/http/ngx_http_flv_module.html) 模块。该模块为 Flash Videos (FLV) 文件提供伪流服务器端的支持。该模块默认不构建。
* **with-http\_mp4\_module**

  允许构建[ngx\_http\_mp4\_module](http://nginx.org/en/docs/http/ngx_http_mp4_module.html) 模块。该模块为 MP4 文件提供伪流服务器端的支持。该模块默认不构建。
* **with-http\_gunzip\_module**

  允许构建[ngx\_http\_gunzip\_module](http://nginx.org/en/docs/http/ngx_http_gunzip_module.html) 模块。该模块使用 `Content-Encoding: gzip` 来解压缩响应对于那些不支持`gzip`编码方法的客户端。该模块默认不构建。
* **with-http\_auth\_request\_module**

  允许构建[ngx\_http\_auth\_request\_module](http://nginx.org/en/docs/http/ngx_http_auth_request_module.html) 模块。该模块基于子请求的结果实现客户端授权。该模块默认不构建。
* **with-http\_random\_index\_module**

  允许构建[ngx\_http\_random\_index\_module](http://nginx.org/en/docs/http/ngx_http_random_index_module.html) 模块。该模块处理斜杠字符 ('/') 结尾的请求，并选择目录中的随机文件作为索引文件。该模块默认不构建。
* **with-http\_secure\_link\_module**

  允许构建[ngx\_http\_secure\_link\_module](http://nginx.org/en/docs/http/ngx_http_secure_link_module.html) 模块。该模块默认不构建。
* **with-http\_degradation\_module**

  允许构建 `with-http_degradation_module` 模块。该模块默认不构建。
* **with-http\_slice\_module**

  允许构建[ngx\_http\_slice\_module](http://nginx.org/en/docs/http/ngx_http_slice_module.html) 将请求拆分为子请求的模块，每个模块都返回一定范围的响应。该模块提供了更有效的大响应缓存。该模块默认不构建。
* **with-http\_stub\_status\_module**

  允许构建[ngx\_http\_stub\_status\_module](http://nginx.org/en/docs/http/ngx_http_stub_status_module.html) 模块。该模块提供对基本状态信息的访问。该模块默认不构建。
* **without-http\_charset\_module**

  禁用构建压缩 HTTP 响应的[ngx\_http\_charset\_module](http://nginx.org/en/docs/http/ngx_http_charset_module.html) 模块。该模块将指定的字符集添加到 `Content-Type` 响应头字段，还可以将数据从一个字符集转化为另一个字符集。
* **without-http\_gzip\_module**

  禁用构建压缩 HTTP 响应的[compresses responses](http://nginx.org/en/docs/http/ngx_http_gzip_module.html) 模块。构建和运行这个模块需要 zlib 库。
* **without-http\_ssi\_module**

  禁用构建[without-http\_ssi\_module](http://nginx.org/en/docs/http/ngx_http_gzip_module.html) 模块。该模块在通过它的响应中处理 SSI (服务端包含) 命令。
* **without-http\_userid\_module**

  允许构建[ngx\_http\_userid\_module](http://nginx.org/en/docs/http/ngx_http_userid_module.html) 模块。该模块设置适合客户端识别的cookie。
* **without-http\_access\_module**

  禁用构建[ngx\_http\_access\_module](http://nginx.org/en/docs/http/ngx_http_access_module.html) 模块。该模块允许限制对某些客户端地址的访问。
* **without-http\_auth\_basic\_module**

  禁用构建[ngx\_http\_auth\_basic\_module](http://nginx.org/en/docs/http/ngx_http_auth_basic_module.html) 模块。该模块允许通过使用HTTP基本身份验证协议验证用户名密码来限制对资源的访问。
* **without-http\_mirror\_module**

  禁用构建[ngx\_http\_mirror\_module](http://nginx.org/en/docs/http/ngx_http_mirror_module.html) 模块。该模块通过创建后台镜像子请求来实现原始请求的镜像。
* **without-http\_autoindex\_module**

  禁用构建[ngx\_http\_autoindex\_module](http://nginx.org/en/docs/http/ngx_http_autoindex_module.html) 模块。该模块处理以斜杠('/')结尾的请求，并在[ngx\_http\_index\_module](http://nginx.org/en/docs/http/ngx_http_index_module.html) 模块找不到索引文件的情况下生成目录列表。
* **without-http\_geo\_module**

  禁用构建[ngx\_http\_geo\_module](http://nginx.org/en/docs/http/ngx_http_geo_module.html) 模块。该模块使用取决于客户端IP地址的值创建变量。
* **without-http\_map\_module**

  禁用构建[ngx\_http\_map\_module](http://nginx.org/en/docs/http/ngx_http_map_module.html) 模块。该模块使用取决于其他变量的值创建变量。
* **without-http\_split\_clients\_module**

  禁用构建[ngx\_http\_split\_clients\_module](http://nginx.org/en/docs/http/ngx_http_split_clients_module.html) 模块。该模块为 A/B 测试创建变量。
* **without-http\_referer\_module**

  禁用构建[ngx\_http\_referer\_module](http://nginx.org/en/docs/http/ngx_http_referer_module.html) 模块。该模块可以阻止对 “Referer” 头字段中具有无效值的请求访问站点。
* **without-http\_proxy\_module**

  禁用构建允许HTTP服务器重定向的请求和更改请求URI [redirect requests and change URI of requests](http://nginx.org/en/docs/http/ngx_http_rewrite_module.html) 的模块。
* **without-http\_proxy\_module**

  禁用构建[proxying module](http://nginx.org/en/docs/http/ngx_http_proxy_module.html) HTTP服务器代理模块。
* **without-http\_fastcgi\_module**

  禁用构建将请求传递给FastCGI服务器的[ngx\_http\_fastcgi\_module](http://nginx.org/en/docs/http/ngx_http_fastcgi_module.html)模块。
* **without-http\_uwsgi\_module**

  禁用构建将请求传递给uwsgi服务器的[ngx\_http\_uwsgi\_module](http://nginx.org/en/docs/http/ngx_http_uwsgi_module.html) 模块。
* **without-http\_scgi\_module**

  禁用构建将请求传递给SCGI服务器的[ngx\_http\_scgi\_module](http://nginx.org/en/docs/http/ngx_http_scgi_module.html) 模块。
* **without-http\_grpc\_module**

  禁用构建将请求传递给个RPC服务器[ngx\_http\_grpc\_module](http://nginx.org/en/docs/http/ngx_http_grpc_module.html) 模块。
* **without-http\_memcached\_module**

  禁用构建[ngx\_http\_memcached\_module](http://nginx.org/en/docs/http/ngx_http_memcached_module.html) 模块。该模块从 memcached 服务器获得响应。
* **without-http\_limit\_conn\_module**

  禁用构建[ngx\_http\_limit\_conn\_module](http://nginx.org/en/docs/http/ngx_http_limit_conn_module.html) 模块。该模块限制每个密钥的链接数，例如，来自单个IP地址的链接数。
* **without-http\_limit\_req\_module**

  禁用构建限制每个键的请求处理速率[ngx\_http\_limit\_req\_module](http://nginx.org/en/docs/http/ngx_http_limit_req_module.html) 模块。例如，来自单个IP地址的请求的处理速率。
* **without-http\_empty\_gif\_module**

  禁用构建发出单像素透明GIF[emits single-pixel transparent GIF](http://nginx.org/en/docs/http/ngx_http_empty_gif_module.html) 模块。
* **without-http\_browser\_module**

  禁用构建[ngx\_http\_browser\_module](http://nginx.org/en/docs/http/ngx_http_browser_module.html) 模块。该模块创建的值的变量取决于 “User-Agent” 请求标头字段的值。
* **without-http\_upstream\_hash\_module**

  禁用构建实现散列负载均衡的方法[hash](http://nginx.org/en/docs/http/ngx_http_upstream_module.html#hash) 模块。
* **without-http\_upstream\_ip\_hash\_module**

  禁用构建实现[IP\_Hash](http://nginx.org/en/docs/http/ngx_http_upstream_module.html#ip_hash) 负载均衡方法的模块。
* **without-http\_upstream\_least\_conn\_module**

  禁用构建实现[least\_conn](http://nginx.org/en/docs/http/ngx_http_upstream_module.html#least_conn) 负载均衡方法的模块。
* **without-http\_upstream\_keepalive\_module**

  禁用构建[caching of connections](http://nginx.org/en/docs/http/ngx_http_upstream_module.html#keepalive) 模块。该模块提供到上游服务器的链接缓存。
* **without-http\_upstream\_zone\_module**

  禁用构建[zone](http://nginx.org/en/docs/http/ngx_http_upstream_module.html#zone) 模块。该模块可以将上游组的运行时状态存储在共享内存区域中。
* **with-http\_perl\_module**和**with-http\_perl\_module=dynamic**

  构建[嵌入式Perl](http://nginx.org/en/docs/http/ngx_http_perl_module.html) 模块。该模块默认不构建。
* **--with-perl\_modules\_path=path**

  定义一个保留Perl模块的路径。
* **with-perl=path**

  设置Perl二进制文件的名字。
* **http-client-body-temp-path**

  定义用于存储保存客户端的请求主体的临时文件的目录。安装后，可以使用[client\_body\_temp\_path](http://nginx.org/en/docs/http/ngx_http_core_module.html#client_body_temp_path) 指令在nginx.conf配置文件中始终更改目录。默认的目录名为 `prefix/client_body_temp`。
* **http-proxy-temp-path=path**

  定义一个目录，用于存储临时文件和从代理服务器接受的数据。安装后可以使用[proxy\_temp\_path](http://nginx.org/en/docs/http/ngx_http_proxy_module.html#proxy_temp_path) 指令在nginx.conf配置文件中更改。默认的目录名为 `profix/proxy_temp`
* **http-fastcgi-temp-path=path**

  定义一个目录，用于存储临时文件和从 FastCGI 服务器接受的数据。安装后可以使用[fastcgi\_temp\_path](http://nginx.org/en/docs/http/ngx_http_fastcgi_module.html#fastcgi_temp_path) 指令在nginx.conf配置文件中更改。 默认的目录为 `prefix/fastcgi_temp`
* **http-uwsgi-temp-path=path**

  定义一个目录，用于存储临时文件和从 uwsgi 服务器接受的数据。安装后可以使用[uwsgi\_temp\_path](http://nginx.org/en/docs/http/ngx_http_uwsgi_module.html#uwsgi_temp_path) 指令在nginx.conf配置文件中更改。 默认的目录为 `prefix/uwsgi_temp`
* **http-scgi-temp-path=path**

  定义一个目录，用于存储临时文件和从 SCGI 服务器接受的数据。安装后可以使用[scgi\_temp\_path](http://nginx.org/en/docs/http/ngx_http_scgi_module.html#scgi_temp_path) 指令在nginx.conf配置文件中更改。 默认的目录为 `prefix/scgi_temp`
* **without-http**

  禁用构建[HTTP](http://nginx.org/en/docs/http/ngx_http_core_module.html) 模块。
* **without-http-cache**

  禁用 HTTP 缓存。
* **with-mail**和**with-mail=dynamic**

  启用构建 POP3/IMAP4/SMTP [mail proxy](http://nginx.org/en/docs/mail/ngx_mail_core_module.html) 模块。
* **with-mail\_ssl\_module**

  启用构建[SSL/TLS protocol support](http://nginx.org/en/docs/mail/ngx_mail_ssl_module.html) 模块，将SSL/TLS协议支持添加到邮件代理服务器。默认不构建此模块。需要OpenSSL库来构建和运行此模块。
* **without-mail\_pop3\_module**

  禁用邮件代理服务器中的[POP3](http://nginx.org/en/docs/mail/ngx_mail_pop3_module.html) 协议。
* **without-mail\_imap\_module**

  禁用邮件代理服务器中的[IMAP](http://nginx.org/en/docs/mail/ngx_mail_imap_module.html) 协议。
* **without-mail\_smtp\_module**

  禁用邮件代理服务器中的[SMTP](http://nginx.org/en/docs/mail/ngx_mail_smtp_module.html) 协议。
* **with-stream**和**with-stream=dynamic**

  启用构建[流模块](http://nginx.org/en/docs/stream/ngx_stream_core_module.html) 模块以进行通用的 TCP/UDP 代理和负载均衡。该模块默认不构建。
* **with-stream\_ssl\_module**

  启用构建[SSL/TLS protocol support](http://nginx.org/en/docs/stream/ngx_stream_ssl_module.html) 模块。为流模块添加SSL/TLS协议支持。默认不构建此模块。需要OpenSSL库来构建和运行此模块。
* **with-stream\_realip\_module**

  启用构建[ngx\_stream\_realip\_module](http://nginx.org/en/docs/http/ngx_stream_realip_module.html) 模块。该模块将客户端地址更改为 PROXY 协议头中发送的地址。默认不构建此模块。
* **with-stream\_geoip\_module**和**with-stream\_geoip\_module=dynamic**

  启用构建[ngx\_stream\_geoip\_module](http://nginx.org/en/docs/stream/ngx_stream_geoip_module.html) 模块。该模块根据客户端地址和预编译的[MaxMind](http://www.maxmind.com/) 数据库创建变量。默认不构建。
* **with-stream\_ssl\_preread\_module**

  禁用构建[with-http\_degradation\_modulengx\_stream\_ssl\_preread\_module](http://nginx.org/en/docs/stream/ngx_stream_ssl_preread_module.html) 模块。该模块允许从[ClientHello](https://tools.ietf.org/html/rfc5246#section-7.4.1.2) 消息中提取消息而不终止SSL/TLS。
* **without-stream\_limit\_conn\_module**

  禁用构建[ngx\_stream\_limit\_conn\_module](http://nginx.org/en/docs/stream/ngx_stream_limit_conn_module.html) 模块。该模块限制每个密钥的连接数，例如，来自单个IP地址的连接数。
* **without-stream\_geo\_module**

  禁用构建[ngx\_stream\_geo\_module](http://nginx.org/en/docs/stream/ngx_stream_geo_module.html) 模块。该模块使用取决于客户端IP地址的值创建变量。
* **without-stream\_map\_module**

  禁用构建[ngx\_stream\_map\_module](http://nginx.org/en/docs/stream/ngx_stream_map_module.html) 模块。该模块根据其他变量的值创建值。
* **without-stream\_split\_clients\_module**

  禁用构建[ngx\_stream\_split\_clients\_module](http://nginx.org/en/docs/stream/ngx_stream_split_clients_module.html) 模块。该模块为 A/B 测试创建变量
* **without-stream\_return\_module**

  禁用构建[ngx\_stream\_return\_module](http://nginx.org/en/docs/stream/ngx_stream_return_module.html) 模块。该模块将一些指定值发送到客户端，然后关闭连接。
* **without-stream\_upstream\_hash\_module**

  禁用构建[hash](http://nginx.org/en/docs/stream/ngx_stream_upstream_module.html#hash) 实现散列负载平衡方法的模块。
* **without-stream\_upstream\_least\_conn\_module**

  禁用构建[least\_conn](http://nginx.org/en/docs/stream/ngx_stream_upstream_module.html#least_conn) 实现散列负载平衡方法的模块。
* **without-stream\_upstream\_zone\_module**

  禁用构建[zone](http://nginx.org/en/docs/stream/ngx_stream_upstream_module.html#zone) 的模块。该模块可以将上游组的运行时状态存储在共享内存区域中
* **with-google\_perftools\_module**

  禁用构建[ngx\_google\_perftools\_module ](http://nginx.org/en/docs/ngx_google_perftools_module.html)模块。该模块可以使用 [Google Performance Tools](https://github.com/gperftools/gperftools) 分析nginx工作进程。该模块适用于nginx开发人员，默认情况下不构建。
* **with-cpp\_test\_module**

  启用构建ngx\_cpp\_test\_module模块。
* **add-module=path**

  启用外部模块。
* **add-dynamic-module=path**

  启用动态模块。
* **with-compat**

  实现动态兼容模块。
* **with-cc=path**

  设置C编译器的名称。
* **with-cpp=path**

  设置C++处理器的名称。
* **with-cc-opt=parameters**

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

  设置将在链接期间使用的其他参数。在FreeBSD下使用系统PCRE库时，应指定`--with-ld-opt =" - L / usr / local / lib"`。
* **with-cpu-opt=cpu**

  指定编译的 CPU ，pentium, pentiumpro, pentium3, pentium4, athlon, opteron, sparc32, sparc64, ppc64。
* **without-pcre**

  禁用 PCRE 库的使用。
* **with-pcre**

  强制使用 PCRE 库。
* **with-pcre=path**

  设置 PCRE 库源的路径。需要从 [PCRE](http://www.pcre.org/) 站点下载分发（版本4.4 - 8.42）并将其解压缩。剩下的工作由nginx的./configure和make完成。该位置指令和 [ngx\_http\_rewrite\_module](http://nginx.org/en/docs/http/ngx_http_rewrite_module.html) 模块中的正则表达式支持需要该库。
* **with-pcre-opt=parameters**

  为PCRE设置其他构建选项。
* **with-zlib-opt=parameters**

  为zlib设置其他构建选项。
* **with-zlib-asm=cpu**

  启用使用针对其中一个指定CPU优化的zlib汇编程序源：pentium，pentiumpro。
* **with-libatomic**

  强制libatomic\_ops库使用。
* **with-libatomic=path**

  设置libatomic\_ops库源的路径。
* **with-openssl=path**

  设置OpenSSL库源的路径。
* **with-openssl-opt=parameters**

  为OpenSSL设置其他构建选项。
* **with-debug**

  启用 [调试日志](http://nginx.org/en/docs/debugging_log.html) 。
* **--with-pcre=path**

  设置 PCRE 库的源路径。发行版（4.4 至 8.40 版本）需要从 [PCRE](http://www.pcre.org/) 站点下载并提取。其余工作由 nginx 的 `./configure` 和 `make` 完成。该库是 [location](http://nginx.org/en/docs/http/ngx_http_core_module.html#location) 指令和 [ngx\_http\_rewrite\_module](http://nginx.org/en/docs/http/ngx_http_rewrite_module.html) 模块中正则表达式支持所必需的。
* **--with-pcre-jit**

  使用“即时编译（just-in-time compilation）”支持（1.1.12版本的 [pcre\_jit](http://nginx.org/en/docs/ngx_core_module.html#pcre_jit) 指令）构建 PCRE 库。
* **--with-zlib=path**

  设置 zlib 库的源路径。发行版（1.1.3 至 1.2.11 版本）需要从 [zlib](http://zlib.net/) 站点下载并提取。其余工作由 nginx 的 `./configure` 和 `make` 完成。该库是 [ngx\_http\_gzip\_module](http://nginx.org/en/docs/http/ngx_http_gzip_module.html) 模块所必需的。
* **--with-cc-opt=parameters**

  设置添加到 CFLAGS 变量的额外参数。当在 FreeBSD 下使用系统的 PCRE 库时，应指定 `--with-cc-opt="-I /usr/local/include"`。如果需要增加 `select()` 所支持的文件数量，也可以在这里指定，如：`--with-cc-opt="-D FD_SETSIZE=2048"`。
* **--with-ld-opt=parameters**

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

参数使用示例：

```bash
./configure \
    --sbin-path=/usr/local/nginx/nginx \
    --conf-path=/usr/local/nginx/nginx.conf \
    --pid-path=/usr/local/nginx/nginx.pid \
    --with-http_ssl_module \
    --with-pcre=../pcre-8.40 \
    --with-zlib=../zlib-1.2.11
```

配置完成之后，使用 `make` 和 `make install` 编译和安装 nginx。

## 原文档

<http://nginx.org/en/docs/configure.html>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docshome.gitbook.io/nginx-docs/readme/cong-yuan-ma-gou-jian-nginx.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.