对于nginx我们在编译的时候,有些编译参数是不需要的,有的是必备编译参数,那么怎么样根据需求来选择nginx的编译参数呢,下面就来讲讲nginx的./configure编译参数相关说明


一 Nginx的./configure编译参数说明介绍

  可以看出,configure命令至关重要,比如根据自己需要选择性的安装nginx是很有必要的,下文将详细介绍如何使用configure命令使用方法。

   我们在解压了nginx的源码后,进入到nginx的源码目录使用“./configure --help”之后可以详细的查看到关于nginx的./confugure的参数介绍,相关参数如下:

1. 路径相关的参数

./confugure的参数参数说明默认值
--prefix=PATH 指定安装目录
/usr/local/nginx
--sbin-path=PATH 指定nginx命令路径<<prefix>/sbin
--conf-path=PATH  指定nginx配置文件路径<prefix>/conf
--error-log-path=PATH 指定错误日志存放路径<prefix>/logs/error.log
--pid-path=PATH指定nginx进程pid文件路径<prefix>/logs/nginx.pid
--lock-path=PATH  指定nginx的lock文件路径<prefix>/logs/nginx.lock
--builddir=DIR 

指定编译文件存放的目录

<nginx source path>/objs

--with-perl_modules_path=PATH 

指定Perl模块的的路径(只有使用了第三方的Perl模块时才可用到)


--with-perl=PATH  指定Perl binary路径,只有当nginx会使用Perl脚本时才用到
--http-log-path=PATH 指定访问日志文件路径<prefix>/logs/access.log
--http-client-body-temp-path=PATH 指定客户端访问的缓存网页文件存放路径<prefix>/client_body_temp
--http-proxy-temp-path=PATH 指定nginx用于代理时产生的缓存文件存放路径<prefix>/proxy_temp
--http-fastcgi-temp-path=PATH指定fastcgi的临时文件存放路径<prefix>/fastcgi_temp
--http-uwsgi-temp-path=PATH 指定uwsgi的临时文件存放路径<prefix>/uwsgi_temp
--http-scgi-temp-path=PATH 指定scgi的临时文件存放路径<prefix>/scgi_temp

2编译相关的参数                 

如下列出了编译Nginx时与编译器相关的参数。

./confugure的参数参数含义
--with-cc=PATH 指定C编译器的路径

--with-cpp=PATH     

指定C预编译器的路径

--with-cc-opt=OPTIONS

设置C编译器参数(PCRE库,需要指定–with-cc-opt=”-I /usr/local/include”,如果使用select()函数则需要同时增加文件描述符数量,可以通过–with-cc-opt=”-D FD_SETSIZE=2048”指定。
--with-ld-opt=OPTIONS 设置连接文件参数。(PCRE库,需要指定–with-ld-opt=”-L /usr/local/lib”。)
--with-cpu-opt=CPU  指定编译的CPU,可用的值为: pentium, pentiumpro, pentium3,pentium4, athlon,opteron, amd64, sparc32, sparc64, ppc64

3. 依赖软件的相关参数

如下列出了Nginx依赖的常用软件支持的参数。

./confugure的参数参数含义
--without-pcre 

禁用pcre库

--without-pcre 

启用pcre库

--with-pcre=DIR   指向pcre库文件目录
--with-pcre-opt=OPTIONS  在编译时为pcre库设置附加参数
--with-pcre-jit   建立pcre jit支持

4. OpenSSL相关参数

./confugure的参数参数含义
--with-openssl=DIR 指定openssl安装目录
--with-openssl-opt=OPTIONS在编译时为openssl设置附加参数

5. 原子库的相关参数

./confugure的参数参数含义
--with-libatomic 为原子内存的更新操作的实现提供一个架构
--with-libatomic=DIR  

指定libatomic的安装目录

6 .散列函数库相关参数

./confugure的参数参数含义
--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汇编源

7. zlib库的设置参数

./confugure的参数参数含义

--with-zlib=DIR        

指向zlib库目录

--with-zlib-opt=OPTIONS

在编译时为zlib设置附加参

--with-zlib-asm=CPU

为指定的CPU使用zlib汇编源进行优化,CPU类型为pentium, pentiumpro

8.模块相关的参数

 除了少量核心代码外,Nginx完全是由各种功能模块组成的。这些模块会根据配置参数决定自己的行为,因此,正确地使用各个模块非常关键。在configure的参数中,我们把它们分为五大类。

  • 事件模块。(nginx的处理请求的方式)

  • 默认即编译进入Nginx的HTTP模块。

  • 默认不会编译进入Nginx的HTTP模块。

  • 邮件代理服务器相关的mail 模块。

  • 其他模块。

* 事件模块

./confugure的参数参数含义
--with-rtsig_module   

启用rtsig模块支持(实时信号)

--with-select_module 

启用select模块支持(一种轮询模式,不推荐在高载环境下使用)

--without-select_module  禁用select模块支持(一种轮询模式,不推荐在高载环境下使用
--with-poll_module 启用poll模块支持(功能与select相同,与select特性相同,一种轮询模式,不推荐在高载环境下使用)
--without-poll_module 禁用poll模块支持(功能与select相同,与select特性相同,一种轮询模式,不推荐在高载环境下使用)
--with-aio-module 使用AI的方式处理事件驱动,仅限于FreeBSD系统上使用,Linux默认不支持。

* 默认即编译进入Nginx的HTTP模块 

  注意下列模块在编译安装nginx时,是默认安装到nginx中,即nginx默认支持相关功能。如不需要,禁用即可!

         

./confugure的参数参数含义


--without-http_charset_module

禁用ngx_http_charset_module支持(重新编码web面,但只能是一个方向–服务器端到客户端,并且只有一个字节的编码可以被重新编码)

--without-http_gzip_module禁用ngx_http_gzip_module支持(该模块同--with-http_gzip_static_module功能一样)


--without-http_ssi_module 

禁用ngx_http_ssi_module支持(该模块提供了一个在输入端处理处理服务器包含文件(SSI)的过滤器,目前支持SSI命令的列表是不完整的)
--without-http_userid_module 

禁用ngx_http_userid_module支持(该模块用来处理用来确定客户端后续请求的cookies)

--without-http_access_module 禁用ngx_http_access_module支持(该模块提供了一个简单的基于主机的访问控制。允许/拒绝基于ip地址)
--without-http_auth_basic_module禁用ngx_http_auth_basic_module(该模块是可以使用用户名和密码基于http基本认证方法来保护你的站点或其部分内容)
--without-http_autoindex_module 

禁用disable 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支持(该模块用来基于某些条件划分用户。条件如:ip地址、报头、cookies等等)
--without-http_referer_module

禁用disable ngx_http_referer_module支持(该模块用来过滤请求,拒绝报头中Referer值不正确的请求)




--without-http_rewrite_module 

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

禁用ngx_http_proxy_module支持(有关代理服务器)


--without-http_fastcgi_module 

禁用ngx_http_fastcgi_module支持(该模块允许Nginx与FastCGI进程交互,并通过传递参数来控制FastCGI进程工作。)FastCGI一个常驻型的公共网关接口。
--without-http_uwsgi_module 禁用ngx_http_uwsgi_module支持(该模块用来医用uwsgi协议,uWSGI服务器相关)


--without-http_scgi_module 

禁用ngx_http_scgi_module支持(该模块用来启用SCGI协议支持,SCGI协议是CGI协议的替代。它是一种应用程与HTTP服务接口标准。它有些像FastCGI但他的设计更容易实现。)

--without-http_memcached_module 

禁用ngx_http_memcached_module支持(该模块用来提供简单的缓存,以提高系统效率)

--without-http_limit_conn_module禁用ngx_http_limit_zone_module支持(该模块可以针对条件,进行会话的并发连接数控制)
--without-http_limit_req_module 

禁用ngx_http_limit_req_module支持(该模块允许你对于一个地址进行请求数量的限制用一个给定的session或一个特定的事件)

--without-http_empty_gif_module

禁用ngx_http_empty_gif_module支持(该模块在内存中常驻了一个1*1的透明GIF图像,可以被非常快速的调用)



--without-http_browser_module

禁用ngx_http_browser_module支持(该模块用来创建依赖于请求报头的值。如果浏览器为modern,则$modern_browser等于modern_browser_value指令分配的值;如果浏览器为old,则$ancient_browser等于ancient_browser_value指令分配的值;如果浏览器为MSIE中的任意版本,则$msie等于1)

--without-http_upstream_ip_hash_module

禁用ngx_http_upstream_ip_hash_module支持(该模块用于简单的负载均衡)nginx负载均衡的一种算法

--without-http_upstream_least_conn_module
--without-http_upstream_keepalive_module不启用用高可用支持模块


* 默认即编译不进入Nginx的HTTP模块   

  注意下列模块在编译安装nginx时,是默认不安装到nginx中,即需要nginx支持相关功能,必须添加相关./configure参数启动该功能。


./confugure的参数参数含义
--with-http_ssl_module

启用ngx_http_ssl_module支持(使nginx支持https请求,需已安装openssl)

--with-http_spdy_module
--with-http_realip_module启用ngx_http_realip_module支持(这个模块允许从请求标头更改客户端的IP地址值,默认为关)
--with-http_addition_module启用ngx_http_addition_module支持(作为一个输出过滤器,支持不完全缓冲,分部分响应请求)
--with-http_xslt_module 

启用ngx_http_xslt_module支持(过滤转换XML请求)该模块依赖于libxml2和libxslt,启动前需要安装相关依赖包

--with-http_p_w_picpath_filter_module启用ngx_http_p_w_picpath_filter_module支持(传输JPEG/GIF/PNG图片的一个过滤器)(默认为不启用。依赖于libgd库)

--with-http_geoip_module 、

启用ngx_http_geoip_module支持(该模块创建基于与MaxMind GeoIP二进制文件相配的客户端IP地址的ngx_http_geoip_module变量)
--with-http_sub_module启用ngx_http_sub_module支持(允许用一些其他文本替换nginx响应中的一些文本)
--with-http_dav_module   

启用ngx_http_dav_module支持(增加PUT,DELETE,MKCOL:创建集合,COPY和MOVE方法)默认情况下为关闭,需编译开启

--with-http_flv_module 启用ngx_http_flv_module支持(提供寻求内存使用基于时间的偏移量文件,使客户端可以观看,拖动flv视频)
--with-http_mp4_module

启动MP4模块,使客户端可以观看,拖动MP4视频

--with-http_gunzip_module  
--with-http_gzip_static_module 

启用ngx_http_gzip_static_module支持(在线实时压缩输出数据流)

--with-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支持(允许在内存不足的情况下返回204或444码)

--with-http_stub_status_module

启用ngx_http_stub_status_module支持(获取nginx自上次启动以来的工作状态,并发连接数情况)

--with-google_perftools_module 

启用ngx_google_perftools_module支持(提供谷歌性能测试)

--with-cpp_test_module

启用ngx_cpp_test_module支持

* 邮件代理服务器相关的mail模块

./confugure的参数参数含义
--with-mail       安装邮件反向代理模块,nginx可以反向代理IMAP,pop3,smtp等常见的邮件协议,默认不安装
--with-mail_ssl_module  

启用ngx_mail_ssl_module支持,以支持邮件协议对ssl的支持,默认不安装并依赖openssl

--without-mail_pop3_module禁用pop3邮件协议模块,启用--with-mail参数时,会自动安装,以使nginx支持pop3
--without-mail_imap_module禁用IAMP邮件协议模块,启用--with-mail参数时,会自动安装,以使nginx支持IMAP
--without-mail_smtp_module  禁用smtp邮件协议模块,启用--with-mail参数时,会自动安装,以使nginx支持SMTP

其他参数模块

./confugure的参数参数含义
--with-debug 开启debug日志调试功能,以利于nginx问题排查
--add-module=PATH启用外部模块(第三方模块)
--without-http禁用http服务
--without-http-cache 禁用http缓存功能
--with-file-aio启动文件异步I/O功能来处理磁盘文件,这需要系统原生支持异步I/O
--with-ipv6 启动ipv6功能
--user=USER  指定nginx work进程的运行用户(推介使用nginx)
--group=GROUP   指定nginx work进程的运行用户组(推介使用nginx)


以上就是nginx关于./configure阶段相关参数的介绍,后面我们说到关于nginx的configuure执行过程。