欢迎您, 来到 宁时修博客.^_^

Nginx--02 编译参数(nginx-1.10.2)

2016/12/20 言则行 Nginx 1472
温故而知新,遗漏之处要补上。

Nginx版本:nginx-1.10.2

  

--with开头的模块默认没有启用,--without开头的模块默认启用。


使用"./configure --help" 查看编译参数


--help  
打印命令帮助信息

--prefix=PATH 
设置nginx安装根路径,其它的路径都要依赖于该选项

--sbin-path=PATH  
设置nginx二进制文件路径(nginx命令) 

--modules-path=PATH 
设置nginx模块存放路径

--conf-path=PATH  
设置nginx.conf文件路径

--error-log-path=PATH 
设置error日志文件路径

--pid-path=PATH 
设置nginx master进程pid路径

--lock-path=PATH  
设置互斥锁文件nginx.lock路径

--user=USER 
设置worker进程运行所用非特权用户

--group=GROUP 
设置worker进程运行所用非特权用户组

--build=NAME  
设置编译名,一个描述,没有任何其他作用

--builddir=DIR  
设置编译目录,会将编译后生成的文件写入到这个目录中

--with-select_module
启用select事件驱动模型(一种轮询模式,不推荐在高载环境下使用)

--without-select_module
禁用select事件驱动模型

--with-poll_module
启用poll事件驱动模型(功能与select相同,与select特性相同,一种轮询模式,不推荐在高载环境下使用)

--without-poll_module 
禁用poll事件驱动模型

--with-threads  
启用线程池,开启线程池需要AIO的支持

--with-file-aio
启用异步文件IO(AIO)支持(一种APL文件传输格式)

--with-ipv6 
启用IPv6

--with-http_ssl_module  
启用http_ssl模块(使Nginx支持HTTPS,需要安装OpenSSL)

--with-http_v2_module 
启用http_v2模块(使Nginx支持HTTP 2)

--with-http_realip_module 
启用http_realip模块(这个模块允许从请求标头更改客户端的IP地址值,一般用于反向代理中,将真实的客户端IP传送给后端的应用服务器)

--with-http_addition_module 
启用http_addition模块(作为一个输出过滤器,使你能够在请求经过一个 location 前或者后时在该 location 本身添加内容。)

--with-http_xslt_module 
启用http_xslt模块(通过XSLT模板转换成XML响应)该模块依赖于libxml2和libxslt库

--with-http_xslt_module=dynamic 
启用动态加载http_xslt模块,允许在配置文件中通过"load_module"指令手动启用和禁用模块的使用

--with-http_image_filter_module 
启用http_image_filter模块(传输JPEG/GIF/PNG图片的一个过滤器)(默认为不启用。依赖于libgd库)

--with-http_image_filter_module=dynamic 
启用动态加载http_image_filter模块,允许在配置文件中通过"load_module"指令手动启用和禁用模块的使用

--with-http_geoip_module  
启用http_geoip模块(用于处理不同地区的访问,当来自某一个区域的访问时将其重定向到对应的服务或者项目上,需要MaxMind GeoIP库的支持)

--with-http_geoip_module=dynamic  
启用动态加载http_geoip模块,允许在配置文件中通过"load_module"指令手动启用和禁用模块的使用

--with-http_sub_module  
启用http_sub模块(这个模块是一个过滤器,用于修改响应的内容,可以将一个指定的字符串替换成另一个字符串)

--with-http_dav_module
启用http_dav模块(启用对WebDav协议的支持,增加PUT,DELETE,MKCOL(创建集合),COPY和MOVE方法),默认情况下为关闭,需编译开启

--with-http_flv_module  
启用http_flv模块(为Flash Video(FLV)文件提供伪流视频服务端支持,开启它则允许在网页上播放FLV格式的视频 )

--with-http_mp4_module  
启用http_mp4模块(为MP4格式的视频文件提供伪流视频服务端支持,开启它则允许在网页上播放MP4格式的视频)

--with-http_gunzip_module 
启用http_gunzip模块(为不支持"gzip"编码方式的客户端解压响应,有些浏览器不支持"gzip"编码格式的请求和响应传输,若服务器开启了内容传输压缩功能(Gzip),则需要开启此项,服务器会本地解压数据,将数据传送给浏览器客户端)

--with-http_gzip_static_module  
启用http_gzip_static模块(将静态内容压缩成".gz"为文件扩展名的预压缩文件,并缓存在本地,在响应时会将此文件发送以替代普通文件,运用此模块的好处就是不需要(Gzip)每次传输时都需要对文件进行处理压缩)

--with-http_auth_request_module 
启用http_auth_request模块(请求验证模块。实现基于服务器内部子请求的返回结果来控制用户鉴权。可以使用外部服务器或服务对网站的每个请求进行身份验证,当用户访问时,Nginx会向用于验证请求的外部服务器发出验证请求,若返回的状态码为200,则通过允许访问,若返回401或403,则访问会被拒绝。)

--with-http_random_index_module
启用http_random_index模块(随机主页模块。当用户访问时,随机响应一个主页,而并非由"index"指令定义的一个主页,而是从主页池中随机选中一个主页面返回。)

--with-http_secure_link_module
启用http_secure_link模块(防盗链模块。计算和检查要求所需的安全链接网址)

--with-http_degradation_module
启用http_degradation模块(允许当主机剩余内存较低时,用户请求访问,Nginx会对某些"location"的请求返回204或444的响应码。)

--with-http_slice_module
启用http_slice模块(此模块是一个过滤器,用于将一个大的完整的文件分割成多个小块文件,分段传送给用户,一般用于大文件传输的场景下,使用它可以让用户快速的得到响应。常用在 proxy_cache 大文件的场景,将大文件切片缓存)

--with-http_stub_status_module  
启用http_stub_status模块(状态信息统计模块,用于返回一个Nginx状态信息统计信息页面,管理员访问这个页面可以获取Nginx的请求处理、当前连接、等待连接等统计信息,一般用于监控Nginx的运行状态。)

--without-http_charset_module 
禁用http_charset模块(此模块用于将指定的字符集添加到"Content-Type"响应头字段中。此外此模块还可以将数据从一个字符集转换为另一个字符集,此模块用于字符集设置。不建议禁用。)

--without-http_gzip_module
禁用http_gzip模块(此模块用于HTTP响应内容传输压缩,可以将响应内存在传输时将其压缩成Gzip编码格式的响应传送给客户端,使用Gzip编码格式响应内容体积会变小,会提高传输效率。不建议禁用)

--without-http_ssi_module
禁用http_ssi模块(此模块是一个过滤器,用于处理通过它响应中的SSI(Server Side Includes)命令。目前支持的SSI命令列表并不完整,SSI指令是一种可以嵌入WEB页面的一种语法指令。)

--without-http_userid_module  
禁用http_userid模块(此模块用于识别客户端的Cookie。可以使用嵌入变量"$uid_got"和"$uid_set"记录已接受和设置的Cookie)

--without-http_access_module
禁用http_access模块(该模块提供了一个简单的基于主机的访问控制。允许/拒绝某些客户端IP地址的访问,Allow or Deny。不建议禁用。)

--without-http_auth_basic_module
禁用http_auth_basic模块(该模块用于HTTP基本身份验证,使用用户名和密码来限制对资源的访问。)

--without-http_autoindex_module
禁用http_autoindex模块(该模块用于处理以斜杠字符('/')结尾的请求,在ngx_http_index_module模块未找到索引文件时自动生成目录列表。该模块提供简单目录浏览功能)

--without-http_geo_module
禁用http_geo模块(用于从指定变量中获取客户端的IP地址,并将其嵌入到另外一个变量中。默认情况下从"$remote_addr"变量中取得客户端的IP地址。我们可以通过它结合"HTTP_Upstream"实现对来源客户端的负载均衡,当来自不同的客户端请求时,将其负载均衡给后端的不同的服务器处理;还可以使用它结合"HTTP_Map"+"HTTP_Limit_Conn"模块实现对来源客户端的限速功能)

--without-http_map_module   
禁用http_map模块(该模块用于创建一个变量的映射表,结果变量可以是一个字符串也可以是另外一个变量。使用任意的键/值对设置变量)

--without-http_split_clients_module
禁用http_split_clients模块(该模块用来基于某些条件划分用户。条件如:ip地址、报头、cookies等等)

--without-http_referer_module 
禁用http_referer模块(该模块用于防盗链,用于阻止对请求头部"referer"字段具有无效值的请求访问,可以设置一个白名单,非白名单的无效来源网址的连接则会拒绝请求,使用此模块我们还需考虑到,即使对于有效的请求,常规浏览器也可能不发送"referer"字段。不建议禁用。)

--without-http_rewrite_module 
禁用http_rewrite模块(该模块允许使用正则表达式改变URI,并且根据变量来转向以及选择配置。如果在server级别设置该选项,那么他们将在location之前生效。如果在location还有更进一步的重写规则,location部分的规则依然会被行。如果这个URI重写是因为location部分的规则造成的,那么location部分会再次被执行作为新的URI。这个循环会执行10次,然后Nginx会返回一个500错误。依赖pcre库)。即重定向功能,不建议禁用。

--without-http_proxy_module 
禁用http_proxy模块(用于将请求代理传递到另外一台WEB服务器去处理,Nginx的核心模块。不建议禁用。)

--without-http_fastcgi_module 
禁用http_fastcgi模块(该模块允许Nginx与FastCGI进程交互,并通过传递参数来控制FastCGI进程工作)FastCGI一个常驻型的公共网关接口。不建议禁用

--without-http_uwsgi_module
禁用http_uwsgi模块(使 Nginx 将请求传递到 uWSGI 服务器)

--without-http_scgi_module  
禁用http_scgi(SCGI 模块能够让 Nginx 将请求传递到 SCGI 服务器)

--without-http_memcached_module 
禁用http_memcached模块(用于Nginx从Memcached服务器获取响应内容。提供简单的缓存,以提高系统效率)

--without-http_limit_conn_module  
禁用http_limit_conn模块(该模块可以针对条件,进行会话的并发连接数控制,用于限制并发连接数量以及下载带宽限制)

--without-http_limit_req_module 
禁用http_limit_req模块(该模块允许对于一个地址进行请求数量的限制,限制请求的频率)

--without-http_empty_gif_module 
禁用http_empty_gif模块(该模块在内存中常驻了一个1*1的透明空白的GIF图像,可以被非常快速的调用。当用户请求时,返回该图像,一般用于测试)

--without-http_browser_module 
禁用http_browser模块(该模块用于创建变量,变量的值取决于请求头中"user-agent"的值,一般用于区别新式或者旧式浏览器,若新式浏览器则将请求重定向到新式的WEB页面中,呈现新页面,若为旧式浏览器则将返回旧式的WEB页面。)

--without-http_upstream_hash_module 
禁用http_upstream_hash模块(该模块提供了由"Upstream"指令定义的一组服务器的负载均衡方法"Hash",该方法基于散列键值(hash),它会将客户端+服务端的映射关系存放到一个散列键值表中,当客户端第二次请求时则会匹配关系将请求转发至后端的同一台服务器上,实现会话保持功能。该模块提供指令"hash",在会话保持中,我们唯一能标识客户端的标志就是SessionID,所以我们可以使用指令"hash $cookie_jsession"实现会话保持功能。不建议禁用)

--without-http_upstream_ip_hash_module  
禁用http_upstream_ip_hash模块(该模块提供了由"Upstream"指令定义的一组服务器的负载均衡方法"ip_hash",该方法也用于会话保持,不过它是基于客户端IP的Hash方法,由于用户可能是ADSL接入的网络,所以客户端可能受动态IP影响会发生变化,所以一般不建议采用这种方法。)

--without-http_upstream_least_conn_module 
禁用http_upstream_least_conn模块(该模块提供了由"Upstream"指令定义的一组服务器的负载均衡方法"least_conn",该方法用于将请求传递到具有最少活动连接、权重较高(性能最好)的后端服务器上去处理。)

--without-http_upstream_keepalive_module  
禁用http_upstream_keepalive模块(设定代理服务器连接到后端服务器的时候是否使用keepalive长连接,减少创建连接的消耗,提升效率。连接数由"keepalive"指令指定,当空闲的长连接数量超过指定值时,将关闭最近最少使用的连接。)

--without-http_upstream_zone_module 
禁用http_upstream_zone模块(该模块可以将由"Upstream"指令定义的服务器组运行时的状态存储在共享内存区域中。)

--with-http_perl_module 
启用http_perl模块(增加Perl支持,用于在Perl中实现位置和变量处理程序,并将Perl调用插入到SSI中。)

--with-http_perl_module=dynamic 
启用动态加载http_perl模块,允许在配置文件中通过"load_module"指定手动启用和禁用模块的使用

--with-perl_modules_path=PATH 
设置Perl模块路径

--with-perl=PATH  
设置Perl二进制文件路径

--http-log-path=PATH  
设置nginx访问日志路径,可以在主配置文件中使用"access_log"指令修改

--http-client-body-temp-path=PATH 
设置用于存储客户端请求主体的临时文件存放目录路径。安装后,可以在主配置文件中使用"client_body_temp_path"指令修改。

--http-proxy-temp-path=PATH 
设置用于存储从代理服务器接收的数据临时文件存放目录路径。安装后,可以在主配置文件中使用"proxy_temp_path"指令修改。

--http-fastcgi-temp-path=PATH 
设置用于存储从FastCGI服务器接收的数据临时文件存放目录路径。安装后,可以在主配置文件中使用"fastcgi_temp_path"指令修改。

--http-uwsgi-temp-path=PATH 
设置用于存储从UwSGI服务器接收的数据临时文件存放目录路径。安装后,可以在主配置文件中使用"uwsgi_temp_path"指令修改。

--http-scgi-temp-path=PATH  
设置用于存储从SCGI服务器接收的数据临时文件存放目录路径。安装后,可以在主配置文件中使用"scgi_temp_path"指令修改。

--without-http  
禁用HTTP_Core模块,该模块为Nginx的核心模块,用于提供HTTP服务所有核心功能。

--without-http-cache  
禁用HTTP缓存

--with-mail 
启用POP3/IMAP4/SMTP邮件代理模块(邮件反向代理模块,nginx可以反向代理IMAP,pop3,smtp等常见的邮件协议,默认不安装)

--with-mail=dynamic 
启用动态加载POP3/IMAP4/SMTP代理模块,允许在配置文件中通过"load_module"指令手动启用和禁用模块的使用

--with-mail_ssl_module  
启用mail_ssl模块(邮件代理服务对ssl/tls的支持,依赖openssl)

--without-mail_pop3_module  
禁用pop3邮件协议模块,启用--with-mail参数时,会自动安装,以使nginx支持pop3,若不想使用POP3协议,则可以考虑单独禁用此模块。

--without-mail_imap_module  
禁用IAMP邮件协议模块,启用--with-mail参数时,会自动安装,以使nginx支持IMAP,若不想使用IAMP协议,则可以考虑单独禁用此模块。

--without-mail_smtp_module  
禁用smtp邮件协议模块,启用--with-mail参数时,会自动安装,以使nginx支持SMTP,若不想使用SMTP协议,则可以考虑单独禁用此模块。

--with-stream 
启用TCP/UDP代理模块(以前Nginx代理是7层HTTP代理,现在支持TCP/UDP四层代理了)

--with-stream=dynamic 
启用动态加载TCP/UDP代理模块,允许在配置文件中通过"load_module"指令手动启用和禁用模块的使用

--with-stream_ssl_module  
启用stream_ssl模块,提供Nginx TCP/UDP四层代理对SSL/TLS的支持,依赖openssl库

--without-stream_limit_conn_module  
禁用stream_limit_conn模块,该模块用于限制并发连接数量以及下载带宽限制功能

--without-stream_access_module  
禁用stream_access模块,该模块用于限制对某些客户端地址的访问。

--without-stream_upstream_hash_module
禁用stream_upstream_hash模块,该模块提供四层负载均衡的一种调度方法,一般用于基于SessionID的会话保持场景下,当开启Stream_Core模块时自动开启此功能。不建议禁用。

--without-stream_upstream_least_conn_module
禁用stream_upstream_least_conn模块,该模块用于将请求传递到具有最少活动连接、权重较高(性能最好)的后端服务器上去处理。

--without-stream_upstream_zone_module
禁用stream_upstream_zone模块,该模块可以将由"Upstream"指令定义的服务器组运行时的状态存储在共享内存区域中

--with-google_perftools_module
启用google_perftools模块,可以使用Google Performance Tools分析Nginx的工作进程,分析程序性能瓶颈。该模块适用于Nginx开发人员

--with-cpp_test_module
启用cpp_test模块,用于C++测试。该模块适用于Nginx开发人员

--add-module=PATH 
启用外部模块(使用该参数可在编译时添加非nginx官方的第三方模块,需要指定第三方模块所在目录路径)

--add-dynamic-module=PATH 
启用动态外部模块,需要指定第三方模块所在目录路径

--with-cc=PATH  
设置GCC编译器的路径

--with-cpp=PATH 
设置GCC-C++编译器的路径

--with-cc-opt=OPTIONS 
设置GCC编译器其它参数(设置将添加到CFLAGS变量的其他参数,若在FreeBSD系统下使用PCRE库时,应指定"--with-ccc-opt="-I /usr/local/include""。若你在使用select事件驱动模型时,还可以使用它设置可打开的最大文件描述符数量,突破1024的限制,比如"--with-ccc-opt="-D FD_SETSIZE=2048"")

--with-ld-opt=OPTIONS 
设置链接文件其它参数(若在FreeBSD系统下使用PCRE库时,应指定"--with-ccc-opt="-L /usr/local/lib""。)

--with-cpu-opt=CPU  
指定编译的CPU型号,可用的值为: pentium, pentiumpro, pentium3,pentium4, athlon,opteron, amd64, sparc32, sparc64, ppc64

--without-pcre  
禁用PCRE库,PCRE库是一个Perl库,包含Perl兼容的正则表达式。

--with-pcre 
启用PCRE库

--with-pcre=DIR   
设置PCRE源码安装路径

--with-pcre-opt=OPTIONS 
为pcre库设置其它要编译的附加参数

--with-pcre-jit 
启用"即时编译"的支持,开启此项,则会利用"pcre_jit"指令快速编译PCRE库。

--with-md5=DIR  
设置md5源码安装路径(消息摘要算法第五版,用以提供消息的完整性保护)

--with-md5-opt=OPTIONS  
为md5库设置其它要编译的附加参数

--with-md5-asm  
使用md5 汇编程序

--with-sha1=DIR 
设置sha1库源码安装路径(数字签名算法,主要用于数字签名)

--with-sha1-opt=OPTIONS 
为sha1库设置其它要编译的附加参数

--with-sha1-asm 
使用sha1汇编程序

--with-zlib=DIR 
设置zlib库源码安装路径

--with-zlib-opt=OPTIONS 
为zlib库设置其它要编译的附加参数

--with-zlib-asm=CPU 
为指定的CPU使用zlib汇编程序进行优化,CPU类型为pentium, pentiumpro

--with-libatomic  
启用Libatomic_Ops库的使用,为原子内存的更新操作的实现提供一个架构

--with-libatomic=DIR  
设置libatomic_ops库源码安装路径

--with-openssl=DIR  
设置OpenSSL库源码安装路径

--with-openssl-opt=OPTIONS  
为openssl库设置其它要编译的附加参数

--with-debug  
启用debug日志,也可以手动修改主配置文件,使用"error_log /path/to/log debug;"指令设置调试级别的日志。


点赞
说说你的看法

所有评论: (0)