nginx编译安装和模块配置详解

时间:2024-03-12 10:22:16

nginx编译安装和模块配置详解

安装编译环境

# yum -y install gcc
# yum -y install gcc++
# yum -y install gcc-c++
# yum -y install wget

下载依赖文件pcre,openssl,zlib和nginx

pcre:

PCRE库是一组函数,它们使用与Perl 5相同的语法和语义实现正则表达式模式匹配.PCRE具有自己的本机API,以及一组与POSIX正则表达式API对应的包装函数。PCRE库是免费的,即使是用于构建专有软件。

官网最新版本下载地址:https://ftp.pcre.org/pub/pcre/

openssl:

OpenSSL是一种功能强大的商用级全功能工具包,适用于传输层安全性(TLS)和安全套接字层(SSL)协议。它也是一个通用的加密库。

官方最新版本下载地址:https://www.openssl.org/source/

zlib:

一个大型漂亮但又精美不引人注目的压缩库(也是免费的,不提及不受专利限制)

官网最新下载地址:https://zlib.net/

我们先下载到刚创建的目录当中:

# wget https://ftp.pcre.org/pub/pcre/pcre-8.42.tar.gz
# wget https://zlib.net/zlib-1.2.11.tar.gz
# wget https://www.openssl.org/source/openssl-1.1.1a.tar.gz

nginx:

nginx [engine x]是一个HTTP和反向代理服务器,一个邮件代理服务器和一个通用的TCP / UDP代理服务器。

官网最新下载地址:http://nginx.org/en/download.html

# wget http://nginx.org/download/nginx-1.15.6.tar.gz

解压文件

# tar -zxvf pcre-8.42.tar.gz
# tar -zxvf zlib-1.2.11.tar.gz
# tar -zxvf openssl-1.1.1a.tar.gz
# tar -zxvf nginx-1.15.6.tar.gz

创建用户和目录

# groupadd -r nginx //新建系统用户组
# useradd -r -g nginx -s /sbin/nologin -d /opt/runtime/nginx -M nginx //新建系统账号nginx
# mkdir -p /opt/runtime/nginx/{client_body,proxy,fastcgi,uwsgi,scgi,logs,run,lock} //新建nginx需要的目录
# chown -R nginx  /opt/runtime/nginx //递归改变目录所有者
# ./configure \
--prefix=/opt/runtime/nginx \
--sbin-path=/opt/runtime/nginx/sbin/nginx \
--conf-path=/opt/runtime/nginx/etc/nginx/nginx.conf \
--error-log-path=/opt/runtime/nginx/logs/error.log \
--http-log-path=/opt/runtime/nginx/logs/access.log \
--pid-path=/opt/runtime/nginx/run/nginx.pid  \
--lock-path=/opt/runtime/nginx/lock/nginx.lock \
--user=nginx \
--group=nginx \
--with-http_ssl_module \
--with-http_realip_module \
--with-http_stub_status_module \
--with-http_gzip_static_module \
--with-pcre=../pcre-8.42 \
--with-zlib=../zlib-1.2.11 \
--with-openssl=../openssl-1.1.1a \
--with-debug \
--http-client-body-temp-path=/opt/runtime/nginx/client_body \
--http-proxy-temp-path=/opt/runtime/nginx/proxy \
--http-fastcgi-temp-path=/opt/runtime/nginx/fastcgi \
--http-uwsgi-temp-path=/opt/runtime/nginx/uwsgi \
--http-scgi-temp-path=/opt/runtime/nginx/scgi \
--with-stream
# make && make install

源码编译构建nginx命令配置参数详细说明

configure命令支持以下参数:

--help #打印帮助信息

# 打印帮助信息

--prefix=path

# 定义安装目录,默认是/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

# 设置编译名,一个描述,没有任何其他作用。

--builddir=path

# 设置编译目录,会将编译后生成的文件写入到这个目录中。

--with-select_module
--without-select_module

# 启用或禁用select事件驱动模型。默认情况下在Linux2.6以上的内核版本中,Nginx支持使用Epoll高效的事件模型,我们可以在配置文件中使用"use epoll"指令开启它。

--with-poll_module
--without-poll_module

# 启用或禁用poll事件驱动模型。默认情况下在Linux2.6以上的内核版本中,Nginx支持使用Epoll高效的事件模型,我们可以在配置文件中使用"use epoll"指令开启它。

--with-threads
--with-file-aio

# 启用线程池功能。一般情况下主机有几核处理器在启动Nginx时就会创建几个Worker工作进程,进程创建线程处理每一个请求。

# 当在CPU密集型计算、资源访问的环境下,很多请求都会开启对应的线程,可能会由于磁盘IO限制导致的线程处理请求时间变长,这不是我们期望看到的。

# 我们就可以启用线程池功能,让请求排队等待处理,并且可以充分利用CPU提高处理效率。开启线程池需要AIO的支持。 启用异步文件IO(AIO)支持。一般用于大文件传输的场景下。

--with-http_ssl_module

允许构建一个模块,将HTTPS协议支持添加到HTTP服务器。默认情况下不构建此模块。需要OpenSSL库来构建和运行此模块。

--with-http_v2_module

# 启用HTTP_V2模块,新的HTTP协议,相比HTTP1更优更快。默认情况下不构建此模块。

--with-http_realip_module

# 启用HTTP_Realip模块,用于修改客户端请求头中客户端IP地址值,一般用于反向代理中,将真实的客户端IP传送给后端的应用服务器。默认情况下不构建此模块。

--with-http_addition_module

# 启用HTTP_Addition模块,用于在响应之前和之后添加文本。默认情况下不构建此模块。

--with-http_xslt_module 
--with-http_xslt_module=dynamic

# 启用HTTP_Xslt模块,这个模块是一个过滤器,它可以通过XSLT模板转换成XML响应。需要ibxml2和libxslt库的支持。默认情况下不构建此模块。

# 启用HTTP_Xslt动态模块,允许在配置文件中通过"load_module"指令手动启用和禁用模块的使用。默认情况下不构建此模块。

--with-http_image_filter_module
--with-http_image_filter_module=dynamic

# 启用HTTP_Image_Filter模块,这个模块是一个集成图片处理器,我们可以使用它转换JPEG、GIF、PNG和WEBP格式的图像,验证这些格式图像的有效型(是不是此格式的图像),输出JSON格式的图像信息,旋转图像,按比例缩放图像,剪切图片等。默认情况下不构建此模块。

# 启用HTTP_Image_Filter动态模块,允许在配置文件中通过"load_module"指令手动启用和禁用模块的使用。默认情况下不构建此模块。

--with-http_geoip_module
--with-http_geoip_module=dynamic

# 启用HTTP_Geoip模块,这个模块用于处理不同地区的访问,当来自某一个区域的访问时将其重定向到对应的服务或者项目上,需要MaxMind GeoIP库的支持。默认情况下不构建此模块。

# 启用HTTP_Geoip动态模块,允许在配置文件中通过"load_module"指令手动启用和禁用模块的使用。默认情况下不构建此模块。

--with-http_sub_module

# 启用HTTP_Sub模块,这个模块是一个过滤器,用于修改响应的内容,可以将一个指定的字符串替换成另一个字符串。默认情况下不构建此模块。

--with-http_dav_module

# 启用HTTP_DAV模块,用于通过WEBDAV协议提供WEB的文件管理功能,类似于一个WEB的文件管理器,可以对服务器的文件进行管理。默认情况下不构建此模块。

--with-http_flv_module
--with-http_mp4_module

# 启用HTTP_FLV模块,用于为Flash Video(FLV)文件提供伪流视频服务端支持,开启它则允许在网页上播放FLV格式的视频。默认情况下不构建此模块。

# 启用HTTP_MP4模块,用于为MP4格式的视频文件提供伪流视频服务端支持,开启它则允许在网页上播放MP4格式的视频。默认情况下不构建此模块。

--with-http_gunzip_module
--with-http_gzip_static_module

# 启用HTTP_Gunzip模块,用于为不支持"gzip"编码方式的客户端解压响应。

# 有些浏览器不支持"gzip"编码格式的请求和响应传输,若服务器开启了内容传输压缩功能(Gzip),则需要开启此项,服务器会本地解压数据,将数据传送给浏览器客户端。默认情况下不构建此模块。

# 启用HTTP_Gzip_Static模块,用于将静态内容压缩成".gz"为文件扩展名的预压缩文件,并缓存在本地,在响应时会将此文件发送以替代普通文件。

# 运用此模块的好处就是不需要(Gzip)每次传输时都需要对文件进行处理压缩。在用于Squid+Nginx环境下,当Nginx启用(Gzip)内容传输压缩功能时,在使用Squid3.0以前版本搭建环境时会发现,Squid返回给客户端的并不是压缩状态,这就是由于没有启用此模块导致的。默认情况下不构建此模块。

--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模块,此模块是一个过滤器,用于将一个大的完整的文件分割成多个小块文件,分段传送给用户,一般用于大文件传输的场景下,使用它可以让用户快速的得到响应。默认情况下不构建此模块。

--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模块,此模块用于限制对某些客户端地址的访问,Allow or Deny。不建议禁用。

--without-http_auth_basic_module

# 禁用HTTP_Auth_Basic模块,该模块用于HTTP基本身份验证,使用用户名和密码来限制对资源的访问。

--without-http_mirror_module

# 禁用HTTP_Mirror模块,该模块用于将正式环境的流量拷贝到镜像(测试)环境下,一般用于测试环境引入真实环境的流量实现对测试环境的压力测试。

--without-http_autoindex_module

# 禁用HTTP_Autoindex模块,该模块用于在处理以斜杠字符(\'/\')结尾的请求,并在找不到索引文件的情况下生成目录列表。

--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_Splic_Clients模块,该模块用于创建适用于A/B测试的变量,AB测试也称之为拆分测试,也就是将一个项目的两个不同版本发布,看用户更喜欢用于那个版本,若版本A受欢迎则发布版本A。

--without-http_referer_module

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

--without-http_rewrite_module

# 禁用HTTP_Rewerte模块,该模块用于地址重写,用于将来源请求地址重定向到指定的地址上,可以保护真实的地址,增加安全性,该模块需要PCRE库的支持。不建议禁用。

--without-http_proxy_module
--without-http_fastcgi_module
--without-http_uwsgi_module
--without-http_scgi_module
--without-http_grpc_module

# 禁用HTTP_Proxy模块,该模块用于将请求代理传递到另外一台WEB服务器去处理,Nginx的核心模块。不建议禁用。

# 禁用HTTP_FastCGI模块,该模块用于将请求代理传递到另外一台FastCGI服务器去处理,一般用于反代PHP。不建议禁用。

# 禁用HTTP_UwSGI模块,该模块用于将请求代理传递给另外一台UwSGI服务器去处理。

# 禁用HTTP_SCGI模块,该模块用于将请求代理传递给另外一台SCGI服务器去处理。

# 禁用HTTP_Grpc模块,该模块用于将请求代理传递给另外一台Grpc服务器去处理。

--without-http_memcached_module

# 禁用HTTP_Memcached模块,该模块用于Nginx从Memcached服务器获取响应内容。

# 一般用于Nginx+后端服务器+Memcached的环境下,当用户第一请求时,Nginx去Memcached中读取缓存数据,若没有则就请求后端的服务器去处理。

# 后端服务器将静态页面的数据写入到Memcached缓存服务器中并返回响应给Nginx传递给用户,当用户第二次请求时则Nginx直接从Memcached缓存服务器中获取缓存的静态页面内容,Memcached缓存服务器是基于内存的。

# 所以可以减少磁盘IO的使用,提高响应效率。

--without-http_limit_conn_module

# 禁用HTTP_Limit_Conn模块,该模块用于限制并发连接数量以及下载带宽限制。

--without-http_limit_req_module

# 禁用HTTP_Limit_Req模块,该模块用于限制请求数量,可以限制请求的频率。

--without-http_empty_gif_module

# 禁用HTTP_Empty_Gif模块,该模块会在内容中常驻的一个1X1的透明空白的GIF图像,当用户请求时,返回该图像,一般用于测试。

--without-http_browser_module

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

--without-http_upstream_hash_module
--without-http_upstream_ip_hash_module
--without-http_upstream_least_conn_module

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

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

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

--without-http_upstream_keepalive_module

# 禁用HTTP_Upstream_Keepalive模块,该模块可以为由"Upstream"指令定义的一组服务器提供保持长连接的功能,使用它则会为每个Worker工作进程与后端服务器保持空闲的长连接,连接数由"keepalive"指令指定,当空闲的长连接数量超过指定值时,将关闭最近最少使用的连接。

--without-http_upstream_zone_module

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

--with-http_perl_module
--with-http_perl_module=dynamic

# 启用HTTP_Perl模块,用于在Perl中实现位置和变量处理程序,并可以将Perl调用到SSI中。默认情况下不构建此模块。 启用HTTP_Perl动态模块,允许在配置文件中通过"load_module"指定手动启用和禁用模块的使用。默认情况下不构建此模块。

--with-perl_modules_path=PATH

# 设置一个用于保留Perl模块的目录路径。

--with-perl=PATH

# 设置Perl可执行命令文件的路径。

--http-log-path=PATH

# 设置访问日志文件存放目录路径。安装后,可以在主配置文件中使用"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
--with-mail=dynamic

# 启用HTTP_Mail_Core模块,该模块为Nginx的核心模块,用于提供POP3/IMAP4/SMTP邮件代理服务。默认情况下不构建此模块。

# 启用HTTP_Mail_Core动态模块,允许在配置文件中通过"load_module"指令手动启用和禁用模块的使用。默认情况下不构建此模块。

--with-mail_ssl_module

# 启用Mail_SSL模块,用于邮件代理服务支持SSL/TLS协议,需要OpenSSL库的支持。默认情况下不构建此模块。

--without-mail_pop3_module

# 禁用Mail_POP3模块,当启用HTTP_Mail_Core模块时,若你不想使用POP3协议,则可以考虑单独禁用此模块。不建议禁用。

--without-mail_imap_module

# 禁用Mail_IMAP模块,当启用HTTP_Mail_Core模块时,若你不想使用IMAP4协议,则可以考虑单独禁用此模块。不建议禁用。

--without-mail_smtp_module

# 禁用Mail_SMTP模块,当启用HTTP_Mail_Core模块时,若你不想使用SMTP协议,则可以考虑单独禁用此模块。不建议禁用。

--with-stream
--with-stream=dynamic 

# 启用Stream_Core模块,Nginx的核心模块,用于实现TCP/UDP代理和四层负载均衡功能。默认情况下不构建此模块。此模块自Nginx1.9.0版本开始可用。

# 启用Stream_Core动态模块,允许在配置文件中通过"load_module"指令手动启用和禁用模块的使用。默认情况下不构建此模块。

--with-stream_ssl_module

# 启用Stream_SSL模块,用于提供SSL/TLS协议支持,需要OpenSSL库的支持。该模块用于Nginx四层负载功能中使用,需要开启Stream_Core模块。默认情况下不构建此模块。

--with-stream_realip_module

# 启用Stream_Realip模块,用于修改客户端请求头中客户端IP地址值,一般用于反向代理中,将真实的客户端IP传送给后端的应用服务器。该模块用于Nginx四层负载功能中使用,需要开启Stream_Core模块。默认情况下不构建此模块。

--with-stream_geoip_module
--with-stream_geoip_module=dynamic

# 启用Stream_Geoip模块,用于处理不同地区的访问,当来自某一个区域的访问时将其重定向到对应的服务或者项目上,需要MaxMind GeoIP库的支持。该模块用于Nginx四层负载功能中使用,需要开启Stream_Core模块。默认情况下不构建此模块。

# 启用Stream_Geoip动态模块,允许在配置文件中通过"load_module"指令手动启用和禁用模块的使用。默认情况下不构建此模块。

--with-stream_ssl_preread_module

# 启用Stream_SSL_Preread模块,用于从客户端Hello消息中提取信息,而不会终止SSL/TLS。该模块用于Nginx四层负载功能中使用,需要开启Stream_Core模块。默认情况下不构建此模块。

--without-stream_limit_conn_module

# 禁用Stream_Limit_Conn模块,该模块用于限制并发连接数量以及下载带宽限制功能。该模块用于Nginx四层负载功能中使用,当开启Stream_Core模块时自动开启此功能。不建议禁用。

--without-stream_access_module

# 禁用Stream_Access模块,该模块用于限制对某些客户端地址的访问。该模块用于Nginx四层负载功能中使用,当开启Stream_Core模块时自动开启此功能。不建议禁用。

--without-stream_geo_module

# 禁用Stream_Geo模块,该模块用于从指定变量中获取客户端的IP地址,并将其嵌入到另外一个变量中。默认情况下从"$remote_addr"变量中取得客户端的IP地址。该模块用于Nginx四层负载功能中使用,当开启Stream_Core模块时自动开启此功能。不建议禁用。

--without-stream_map_module

# 禁用Stream_Map模块,该模块用于创建一个变量的映射表,结果变量可以是一个字符串也可以是另外一个变量。该模块用于Nginx四层负载功能中使用,当开启Stream_Core模块时自动开启此功能。不建议禁用。

--without-stream_split_clients_module

# 禁用Stream_Splic_Clients模块,该模块用于创建适用于A/B测试的变量,AB测试也称之为拆分测试,也就是将一个项目的两个不同版本发布,看用户更喜欢用于那个版本,若版本A受欢迎则发布版本A。该模块用于Nginx四层负载功能中使用,当开启Stream_Core模块时自动开启此功能。

--without-stream_return_module

# 禁用Stream_Return模块,该模块用于向客户端发送指定值,然后关闭连接。该模块用于Nginx四层负载功能中使用,当开启Stream_Core模块时自动开启此功能。不建议禁用。

--without-stream_upstream_hash_module
--without-stream_upstream_least_conn_module

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

# 禁用Stream_Upstream_IP_Hash模块,该模块提供四层负载均衡的一种调度方法,基于来源IP的会话保持方法,由于来源IP的不稳定性,我们一般很少采用此种方法。当开启Stream_Core模块时自动开启此功能。

--without-stream_upstream_zone_module

# 禁用Stream_Upstream_Zone模块,该模块可以将由"Upstream"指令定义的服务器组运行时的状态存储在共享内存区域中。该模块用于Nginx四层负载功能中使用,当开启Stream_Core模块时自动开启此功能。

--with-google_perftools_module

# 启用Google_Perftools模块,用于可以使用Google Performance Tools分析Nginx的工作进程,分析程序性能瓶颈。该模块适用于Nginx开发人员,默认情况下不构建此模块。

--with-cpp_test_module

# 启用Cpp_Test模块,用于C++测试。该模块适用于Nginx开发人员,默认情况下不构建此模块。

--add-module=PATH
--add-dynamic-module=PATH

# 添加第三方模块,需要指定第三方模块所在目录路径。

# 添加第三方动态模块,需要指定第三方动态模块所在目录路径。

--with-compat

# 启用动态模块兼容性。

--with-cc=PATH

# 设置GCC编译器所在目录路径。

--with-cpp=PATH

# 设置GCC-C++编译器所在目录路径。

--with-cc-opt=OPTIONS

# 设置将添加到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型号,为特定的CPU执行编译操作,有效的值:pentium, pentiumpro, pentium3, pentium4, athlon, opteron, sparc32, sparc64,ppc64。

--without-pcre

# 禁用PCRE库的使用。

--with-pcre

# 启用PCRE库的使用。PCRE库是一个Perl库,包含Perl兼容的正则表达式。

--with-pcre=DIR

# 若你是源码安装的PCRE库,则需要通过此项设置PCRE库的所在目录路径。

--with-pcre-opt=OPTIONS

# 为PCRE设置其他要编译的选项。

--with-pcre-jit

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

--with-zlib=DIR

# 若你是源码安装的Zlib库,则需要通过此项设置Zlib库的所在目录路径。当启用HTTP_Gzip模块的时候需要此库的支持。

--with-zlib-opt=OPTIONS

# 为Zlib设置其他要编译的选项。

--with-zlib-asm=CPU

# 为Zlib库的编译设置特定CPU,会加快编译速度,有效值:pentium, pentiumpro。

--with-libatomic

# 启用Libatomic_Ops库的使用。

--with-libatomic=DIR

# 若你是源码安装的Libatomic_Ops库,则需要通过此项设置Libatomic_Ops库的所在目录路径。

--with-openssl=DIR

# 若你是源码安装的OpenSSL库,则需要通过此项设置OpenSSL库的所在目录路径。

--with-openssl-opt=OPTIONS

# 为OpenSSL设置其他要编译的选项。

--with-debug

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

添加新的模块

已经安装好的nginx,需要添加一个未被编译安装的模块,需要怎么安装呢?

这里以安装第三方ngx_http_google_filter_module模块为例

1、下载第三方扩展模块ngx_http_google_filter_module

$ cd ~
$ git clone https://github.com/cuber/ngx_http_google_filter_module //没有git 先安装git

2、查看nginx编译安装时安装了哪些模块

$ /opt/runtime/nginx/sbin/nginx -V
nginx version: nginx/1.15.6
built by gcc 4.8.5 20150623 (Red Hat 4.8.5-28) (GCC) 
built with OpenSSL 1.1.1a  20 Nov 2018
TLS SNI support enabled
configure arguments: --prefix=/opt/runtime/nginx --sbin-path=/opt/runtime/nginx/sbin/nginx --conf-path=/opt/runtime/nginx/etc/nginx/nginx.conf --error-log-path=/opt/runtime/nginx/logs/error.log --http-log-path=/opt/runtime/nginx/logs/access.log --pid-path=/opt/runtime/nginx/run/nginx.pid --lock-path=/opt/runtime/nginx/lock/nginx.lock --user=nginx --group=nginx --with-http_ssl_module --with-http_realip_module --with-http_stub_status_module --with-http_gzip_static_module --with-pcre=../pcre-8.42 --with-zlib=../zlib-1.2.11 --with-openssl=../openssl-1.1.1a --with-debug --http-client-body-temp-path=/opt/runtime/nginx/client_body --http-proxy-temp-path=/opt/runtime/nginx/proxy --http-fastcgi-temp-path=/opt/runtime/nginx/fastcgi --http-uwsgi-temp-path=/opt/runtime/nginx/uwsgi --http-scgi-temp-path=/opt/runtime/nginx/scgi --with-stream

3、加入需要安装的模块,重新编译,如这里添加–add-module=/data/software/ngx_http_google_filter_module

$ ./configure \
--prefix=/opt/runtime/nginx \
--sbin-path=/opt/runtime/nginx/sbin/nginx \
--conf-path=/opt/runtime/nginx/etc/nginx/nginx.conf \
--error-log-path=/opt/runtime/nginx/logs/error.log \
--http-log-path=/opt/runtime/nginx/logs/access.log \
--pid-path=/opt/runtime/nginx/run/nginx.pid  \
--lock-path=/opt/runtime/nginx/lock/nginx.lock \
--user=nginx \
--group=nginx \
--with-http_ssl_module \
--with-http_realip_module \
--with-http_stub_status_module \
--with-http_gzip_static_module \
--with-pcre=../pcre-8.42 \
--with-zlib=../zlib-1.2.11 \
--with-openssl=../openssl-1.1.1a \
--with-debug \
--http-client-body-temp-path=/opt/runtime/nginx/client_body \
--http-proxy-temp-path=/opt/runtime/nginx/proxy \
--http-fastcgi-temp-path=/opt/runtime/nginx/fastcgi \
--http-uwsgi-temp-path=/opt/runtime/nginx/uwsgi \
--http-scgi-temp-path=/opt/runtime/nginx/scgi \
--with-stream
–add-module=/data/software/ngx_http_google_filter_module
$ make //这里需要 make 一下就行了。不要 make install 了

4、替换二进制文件

先备份一下原来的 Nginx

$ cp /opt/runtime/nginx/sbin/nginx /opt/runtime/nginx/sbin/nginx.bak

再移动编译好的新的 Nginx

$ cp ./dbjs/nginx /opt/runtime/nginx/sbin/

这样就可以了!