《上一小节介绍了如何获取Nginx以及如何配置、编译、安装运行Nginx。但是很多情况下我们是根据自己web需要(需要哪些功能,不需要哪些功能)来编译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库,需要指定�Cwith-cc-opt=”-I /usr/local/include”,如果使用select()函数则需要同时增加文件描述符数量,可以通过�Cwith-cc-opt=”-D FD_SETSIZE=2048”指定。 | |
--with-ld-opt=OPTIONS | 设置连接文件参数。(PCRE库,需要指定�Cwith-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面,但只能是一个方向�C服务器端到客户端,并且只有一个字节的编码可以被重新编码) |
--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_image_filter_module | 启用ngx_http_image_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执行过程。