nginx安装configure参数配置说明

╰半橙微兮° 2021-12-12 14:29 1058阅读 0赞

官网说明：[http://nginx.org/en/docs/configure.html][http_nginx.org_en_docs_configure.html]  
使用该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 fileprefix/conf/nginx.conf  
**–error-log-path=path**  
设置主要错误，警告和诊断文件的名称。安装后，可以nginx.conf使用error\_log指令在配置文件中 更改文件名 。默认情况下，该文件已命名 prefix/logs/error.log。  
**–pid-path=path**  
设置nginx.pid将存储主进程的进程ID 的文件的名称。安装后，可以nginx.conf使用pid指令在配置文件中 更改文件名 。默认情况下，该文件已命名 prefix/logs/nginx.pid。  
**–lock-path=path**  
为锁定文件的名称设置前缀。安装后，可以nginx.conf使用lock\_file指令在配置文件中 始终更改该值 。默认情况下，该值为 prefix/logs/nginx.lock。  
**–user=name**  
设置非特权用户的名称，其凭据将由工作进程使用。安装后，可以nginx.conf使用user指令在配置文件中 更改名称 。默认用户名是nobody。  
**–group=name**  
设置工作进程将使用其凭据的组的名称。安装后，可以nginx.conf使用user指令在配置文件中 更改名称 。默认情况下，组名称设置为非特权用户的名称。  
**–build=name**  
设置可选的nginx构建名称。  
**–builddir=path**  
设置构建目录。  
**–with-select\_module  
–without-select\_module**  
启用或禁用构建允许服务器使用该select()方法的模块。如果平台似乎不支持更合适的方法（如kqueue，epoll或/ dev / poll），则会自动构建此模块。  
**–with-poll\_module  
–without-poll\_module**  
启用或禁用构建允许服务器使用该poll()方法的模块。如果平台似乎不支持更合适的方法（如kqueue，epoll或/ dev / poll），则会自动构建此模块。  
**–with-threads**  
允许使用 线程池。  
**–with-file-aio**  
允许 在FreeBSD和Linux上使用 异步文件I / O（AIO）。  
**–with-http\_ssl\_module**  
允许构建一个模块，将HTTPS协议支持添加 到HTTP服务器。默认情况下不构建此模块。需要OpenSSL库来构建和运行此模块。  
**–with-http\_v2\_module**  
可以构建一个支持HTTP / 2的模块 。默认情况下不构建此模块。  
**–with-http\_realip\_module**  
允许构建ngx\_http\_realip\_module 模块，该 模块将客户端地址更改为在指定的头字段中发送的地址。默认情况下不构建此模块。  
**–with-http\_addition\_module**  
允许构建ngx\_http\_addition\_module 模块，该 模块在响应之前和之后添加文本。默认情况下不构建此模块。  
**–with-http\_xslt\_module  
–with-http\_xslt\_module=dynamic**  
允许构建 使用一个或多个XSLT样式表转换XML响应的 ngx\_http\_xslt\_module模块。默认情况下不构建此模块。该libxml2的和 的libxslt库需要构建和运行此模块。  
**–with-http\_image\_filter\_module  
–with-http\_image\_filter\_module=dynamic**  
可以构建ngx\_http\_image\_filter\_module 模块，该 模块可以转换JPEG，GIF，PNG和WebP格式的图像。默认情况下不构建此模块。  
**–with-http\_geoip\_module  
–with-http\_geoip\_module=dynamic**  
允许构建ngx\_http\_geoip\_module 模块，该 模块根据客户端IP地址和预编译的MaxMind数据库创建变量。默认情况下不构建此模块。  
**–with-http\_sub\_module**  
允许构建ngx\_http\_sub\_module 模块，该 模块通过将一个指定的字符串替换为另一个来修改响应。默认情况下不构建此模块。  
**–with-http\_dav\_module**  
支持构建ngx\_http\_dav\_module 模块，该 模块通过WebDAV协议提供文件管理自动化。默认情况下不构建此模块。  
**–with-http\_flv\_module**  
支持构建ngx\_http\_flv\_module 模块，该 模块为Flash Video（FLV）文件提供伪流服务器端支持。默认情况下不构建此模块。  
**–with-http\_mp4\_module**  
支持构建ngx\_http\_mp4\_module 模块，该 模块为MP4文件提供伪流服务器端支持。默认情况下不构建此模块。  
**–with-http\_gunzip\_module**  
对于不支持“gzip”编码方法的客户端， 可以构建ngx\_http\_gunzip\_module 模块，该 模块使用“ Content-Encoding: gzip” 解压缩响应。默认情况下不构建此模块。  
**–with-http\_gzip\_static\_module**  
允许构建ngx\_http\_gzip\_static\_module 模块，该 模块允许使用“ .gz”文件扩展名而不是常规文件发送预压缩文件。默认情况下不构建此模块。  
**–with-http\_auth\_request\_module**  
允许构建ngx\_http\_auth\_request\_module 模块，该 模块基于子请求的结果实现客户端授权。默认情况下不构建此模块。  
**–with-http\_random\_index\_module**  
允许构建ngx\_http\_random\_index\_module 模块，该 模块处理以斜杠字符（’ /’）结尾的请求，并选择目录中的随机文件作为索引文件。默认情况下不构建此模块。  
**–with-http\_secure\_link\_module**  
可以构建 ngx\_http\_secure\_link\_module 模块。默认情况下不构建此模块。  
**–with-http\_degradation\_module**  
可以构建 ngx\_http\_degradation\_module模块。默认情况下不构建此模块。  
**–with-http\_slice\_module**  
允许构建 将请求拆分为子请求的 ngx\_http\_slice\_module模块，每个模块都返回一定范围的响应。该模块提供了更有效的大响应缓存。默认情况下不构建此模块。  
**–with-http\_stub\_status\_module**  
可以构建ngx\_http\_stub\_status\_module 模块，该 模块提供对基本状态信息的访问。默认情况下不构建此模块。  
**–without-http\_charset\_module**  
禁用构建ngx\_http\_charset\_module 模块，该 模块将指定的字符集添加到“Content-Type”响应头字段，并且还可以将数据从一个字符集转换为另一个字符集。  
**–without-http\_gzip\_module**  
禁用构建压缩 HTTP服务器响应的模块。zlib库是构建和运行此模块所必需的。  
**–without-http\_ssi\_module**  
禁用构建ngx\_http\_ssi\_module 模块，该 模块在通过它的响应中处理SSI（服务器端包含）命令。  
**–without-http\_userid\_module**  
禁用构建ngx\_http\_userid\_module 模块，该 模块设置适合客户端识别的cookie。  
**–without-http\_access\_module**  
禁用构建ngx\_http\_access\_module 模块，该 模块允许限制对某些客户端地址的访问。  
**–without-http\_auth\_basic\_module**  
禁用构建ngx\_http\_auth\_basic\_module 模块，该 模块允许通过使用“HTTP基本身份验证”协议验证用户名和密码来限制对资源的访问。  
**–without-http\_mirror\_module**  
禁用构建ngx\_http\_mirror\_module 模块，该 模块通过创建后台镜像子请求来实现原始请求的镜像。  
**–without-http\_autoindex\_module**  
禁用构建ngx\_http\_autoindex\_module 模块，该 模块处理以斜杠字符（’ /’）结尾的请求，并在ngx\_http\_index\_module模块找不到索引文件的情况下生成目录列表 。  
**–without-http\_geo\_module**  
禁用构建ngx\_http\_geo\_module 模块，该 模块使用取决于客户端IP地址的值创建变量。  
**–without-http\_map\_module**  
禁用构建ngx\_http\_map\_module 模块，该 模块使用取决于其他变量值的值创建变量。  
**–without-http\_split\_clients\_module**  
禁用构建ngx\_http\_split\_clients\_module 模块，该 模块为A / B测试创建变量。  
**–without-http\_referer\_module**  
禁用构建ngx\_http\_referer\_module 模块，该 模块可以阻止对“Referer”头字段中具有无效值的请求访问站点。  
**–without-http\_rewrite\_module**  
禁用构建允许HTTP服务器 重定向请求和更改请求URI的模块。需要PCRE库来构建和运行此模块。  
**–without-http\_proxy\_module**  
禁用构建HTTP服务器 代理模块。  
**–without-http\_fastcgi\_module**  
禁用构建 将请求传递给FastCGI服务器的 ngx\_http\_fastcgi\_module模块。  
**–without-http\_uwsgi\_module**  
禁用构建 将请求传递给uwsgi服务器的 ngx\_http\_uwsgi\_module模块。  
**–without-http\_scgi\_module**  
禁用构建 将请求传递给SCGI服务器的 ngx\_http\_scgi\_module模块。  
**–without-http\_grpc\_module**  
禁用构建 将请求传递给gRPC服务器的 ngx\_http\_grpc\_module模块。  
**–without-http\_memcached\_module**  
禁用构建ngx\_http\_memcached\_module 模块，该 模块从memcached服务器获取响应。  
**–without-http\_limit\_conn\_module**  
禁用构建ngx\_http\_limit\_conn\_module 模块，该 模块限制每个密钥的连接数，例如，来自单个IP地址的连接数。  
**–without-http\_limit\_req\_module**  
禁用构建ngx\_http\_limit\_req\_module 模块，该 模块限制每个密钥的请求处理速率，例如，来自单个IP地址的请求的处理速率。  
**–without-http\_empty\_gif\_module**  
禁用构建发出单像素透明GIF的模块 。  
**–without-http\_browser\_module**  
禁用构建ngx\_http\_browser\_module 模块，该 模块创建的值的变量值取决于“User-Agent”请求标头字段的值。  
**–without-http\_upstream\_hash\_module**  
禁用构建实现散列 负载平衡方法的模块 。  
**–without-http\_upstream\_ip\_hash\_module**  
禁用构建实现ip\_hash 负载平衡方法的模块 。  
**–without-http\_upstream\_least\_conn\_module**  
禁用构建实现least\_conn 负载平衡方法的模块 。  
**–without-http\_upstream\_keepalive\_module**  
禁用构建一个模块，该模块提供 到上游服务器的连接缓存。  
**–without-http\_upstream\_zone\_module**  
禁用构建模块，该模块可以将上游组的运行时状态存储在共享内存 区域中。  
**–with-http\_perl\_module  
–with-http\_perl\_module=dynamic**  
可以构建 嵌入式Perl模块。默认情况下不构建此模块。  
**–with-perl\_modules\_path=path**  
定义一个将保留Perl模块的目录。  
**–with-perl=path**  
设置Perl二进制文件的名称。  
**–http-log-path=path**  
设置HTTP服务器的主要请求日志文件的名称。安装后，可以nginx.conf使用access\_log指令在配置文件中 更改文件名 。默认情况下，该文件已命名 prefix/logs/access.log。  
**–http-client-body-temp-path=path**  
定义用于存储保存客户端请求主体的临时文件的目录。安装后，可以nginx.conf使用client\_body\_temp\_path指令在配置文件中 更改目录 。默认情况下，该目录已命名 prefix/client\_body\_temp。  
**–http-proxy-temp-path=path**  
定义一个目录，用于存储临时文件和从代理服务器接收的数据。安装后，可以nginx.conf使用proxy\_temp\_path 指令在配置文件中 更改目录 。默认情况下，该目录已命名 prefix/proxy\_temp。  
**–http-fastcgi-temp-path=path**  
定义一个目录，用于存储从FastCGI服务器接收的数据的临时文件。安装后，可以nginx.conf使用fastcgi\_temp\_path 指令在配置文件中 更改目录 。默认情况下，该目录已命名 prefix/fastcgi\_temp。  
**–http-uwsgi-temp-path=path**  
定义一个目录，用于存储从uwsgi服务器接收的数据的临时文件。安装后，可以nginx.conf使用uwsgi\_temp\_path 指令在配置文件中 更改目录 。默认情况下，该目录已命名 prefix/uwsgi\_temp。  
**–http-scgi-temp-path=path**  
定义用于存储临时文件的目录，其中包含从SCGI服务器接收的数据。安装后，可以nginx.conf使用scgi\_temp\_path 指令始终在配置文件中 更改目录 。默认情况下，该目录已命名 prefix/scgi\_temp。  
**–without-http**  
禁用HTTP服务器。  
**–without-http-cache**  
禁用HTTP缓存。  
**–with-mail  
–with-mail=dynamic**  
启用POP3 / IMAP4 / SMTP 邮件代理服务器。  
**–with-mail\_ssl\_module**  
允许构建一个模块，将 SSL / TLS协议支持添加 到邮件代理服务器。默认情况下不构建此模块。需要OpenSSL库来构建和运行此模块。  
**–without-mail\_pop3\_module**  
禁用邮件代理服务器中的POP3协议。  
**–without-mail\_imap\_module**  
禁用邮件代理服务器中的IMAP协议。  
**–without-mail\_smtp\_module**  
禁用邮件代理服务器中的SMTP协议。  
**–with-stream  
–with-stream=dynamic**  
允许构建 流模块 以进行通用TCP / UDP代理和负载平衡。默认情况下不构建此模块。  
**–with-stream\_ssl\_module**  
可以构建一个模块， 为流模块添加 SSL / TLS协议支持。默认情况下不构建此模块。需要OpenSSL库来构建和运行此模块。  
**–with-stream\_realip\_module**  
启用构建ngx\_stream\_realip\_module 模块，该 模块将客户端地址更改为PROXY协议头中发送的地址。默认情况下不构建此模块。  
**–with-stream\_geoip\_module  
–with-stream\_geoip\_module=dynamic**  
允许构建ngx\_stream\_geoip\_module 模块，该 模块根据客户端IP地址和预编译的MaxMind数据库创建变量 。默认情况下不构建此模块。  
**–with-stream\_ssl\_preread\_module**  
允许构建ngx\_stream\_ssl\_preread\_module 模块，该 模块允许从ClientHello 消息中提取信息 而不终止SSL / TLS。默认情况下不构建此模块。  
**–without-stream\_limit\_conn\_module**  
禁用构建ngx\_stream\_limit\_conn\_module 模块，该 模块限制每个密钥的连接数，例如，来自单个IP地址的连接数。  
**–without-stream\_access\_module**  
禁用构建ngx\_stream\_access\_module 模块，该 模块允许限制对某些客户端地址的访问。  
**–without-stream\_geo\_module**  
禁用构建ngx\_stream\_geo\_module 模块，该 模块使用取决于客户端IP地址的值创建变量。  
**–without-stream\_map\_module**  
禁用构建ngx\_stream\_map\_module 模块，该 模块根据其他变量的值创建值。  
**–without-stream\_split\_clients\_module**  
禁用构建ngx\_stream\_split\_clients\_module 模块，该 模块为A / B测试创建变量。  
**–without-stream\_return\_module**  
禁用构建ngx\_stream\_return\_module 模块，该 模块将一些指定值发送到客户端，然后关闭连接。  
**–without-stream\_upstream\_hash\_module**  
禁用构建实现散列 负载平衡方法的模块 。  
**–without-stream\_upstream\_least\_conn\_module**  
禁用构建实现least\_conn 负载平衡方法的模块 。  
**–without-stream\_upstream\_zone\_module**  
禁用构建模块，该模块可以将上游组的运行时状态存储在共享内存 区域中。  
**–with-google\_perftools\_module**  
可以构建ngx\_google\_perftools\_module 模块，该 模块可以使用Google Performance Tools分析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库源的路径。库分发（版本4.4 - 8.43）需要从PCRE站点下载 并提取。其余的由nginx ./configure和 make。完成。该位置指令和 ngx\_http\_rewrite\_module 模块中的正则表达式支持需要该库 。  
**–with-pcre-opt=parameters**  
为PCRE设置其他构建选项。  
**–with-pcre-jit**  
使用“即时编译”支持（1.1.12，pcre\_jit指令）构建PCRE库 。  
**–with-zlib=path**  
设置zlib库源的路径。需要从zlib站点下载并提取库分发（版本1.1.3 - 1.2.11） 。其余的由nginx ./configure和 make。完成。ngx\_http\_gzip\_module模块需要该库 。  
**–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**  
启用调试日志。  
参数用法示例（所有这些都需要在一行中输入）：  
./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.43  
–with-zlib=…/zlib-1.2.11  
配置完成后，使用编译和安装nginx make。

[http_nginx.org_en_docs_configure.html]: http://nginx.org/en/docs/configure.html