Nginx编译参数.md

Nginx 介绍

简介

Nginx（发音同engine x）是一个网页服务器，它能反向代理HTTP, HTTPS, SMTP, POP3, IMAP的协议链接，以及一个负载均衡器和一个HTTP缓存。
起初是供俄国大型的门户网站及搜索引擎Rambler（俄语：Рамблер）使用。此软件BSD-like协议下发行，可以在UNIX、GNU/Linux、BSD、Mac OS X、Solaris，以及Microsoft Windows等操作系统中运行。

特点

Nginx是一款面向性能设计的HTTP服务器，相较于Apache、lighttpd具有占有内存少，稳定性高等优势。与旧版本（<=2.2）的Apache不同，nginx不采用每客户机一线程的设计模型，而是充分使用异步逻辑，削减了上下文调度开销，所以并发服务能力更强。
整体采用模块化设计，有丰富的模块库和第三方模块库，配置灵活。
在Linux操作系统下，nginx使用epoll事件模型，得益于此，nginx在Linux操作系统下效率相当高。同时Nginx在OpenBSD或FreeBSD操作系统上采用类似于epoll的高效事件模型kqueue。
Nginx在官方测试的结果中，能够支持五万个平行连接，而在实际的运作中，可以支持二万至四万个平行链接。
整体采用模块化设计是nginx的一个重大特点，甚至http服务器核心功能也是一个模块。旧版本的nginx的模块是静态的，添加和删除模块都要对nginx进行重新编译，1.9.11以及更新的版本已经支持动态模块加载。
支持热部署，不停机更新配置文件、更换日志、更新服务器程序版本；

基本功能

• 静态资源的web服务器；

• http协议的反向代理服务器；

• pop3, smpt, imap4等邮件协议的反向代理；

• 能缓存打开的文件（元数据）

• 支持FastCGI（php-fpm）, uWSGI（Python Web Framwork）等协议

关于 IO 模型的介绍

参考下面的文章：
Linux IO模式及 select、poll、epoll详解
select、poll、epoll之间的区别总结
关于同步，异步，阻塞，非阻塞，IOCP/epoll,select/poll,AIO ,NIO ,BIO的总结

安装

rpm/yum 安装

在CentOS 系统中安装nginx 可以直接yum 安装，但是安装前需要安装epel 源：

# yum install -y epel-release
# yum install -y nginx

源码编译安装参数

路径相关的参数

./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
--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	指定http客户端请求报文临时文件缓存的存放路径	<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

编译相关的参数

./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

依赖软件的相关参数

./confugure的参数	参数含义
--without-pcre	禁用pcre库
--with-pcre	启用pcre库
--with-pcre=DIR	指向pcre库文件目录
--with-pcre-opt=OPTIONS	在编译时为pcre库设置附加参数
--with-pcre-jit	建立pcre jit支持

OpenSSL相关参数

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

原子库的相关参数

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

散列函数库相关参数

./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汇编源

zlib库的设置参数

./confugure的参数	参数含义
--with-zlib=DIR	指向zlib库目录
--with-zlib-opt=OPTIONS	在编译时为zlib设置附加参
--with-zlib-asm=CPU	为指定的CPU使用zlib汇编源进行优化，CPU类型为pentium, pentiumpro

模块相关的参数

除了少量核心代码外，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特性相同，一种轮询模式,不推荐在高载环境下使用）

默认即编译进入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_hash_module
--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支持
--with-http_perl_module	启用with-http_perl_module
--with-threads	启用线程池支持

邮件代理服务器相关的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）

源码安装

# yum install -y openssl-devel zlib-devel pcre-devel gcc gcc-c++
# groupadd -r nginx
# useradd -r -M -s /sbin/nologin -g nginx nginx
# wget http://nginx.org/download/nginx-1.8.1.tar.gz
# tar xf nginx-1.8.1.tar.gz
# cd nginx-1.8.1
# ./configure --prefix=/usr/local/nginx --user=nginx --group=nginx --error-log-path=/var/log/nginx/error.log --http-log-path=/var/log/nginx/access.log --pid-path=/var/run/nginx/nginx.pid --lock-path=/var/lock/nginx.lock --with-pcre  --with-http_ssl_module --with-http_stub_status_module --with-http_gzip_static_module
# make && make install