Last Updated on

前言

nginx作为一个高性能的web服务器和负载均衡服务器,被广泛使用。而nginx的各种功能是需要通过各种模块来实现的,经常会遇到安装时并没有安装此模块,但后面由于业务需求等会使用到未安装的模块,此时就需要在原来nginx的基础上添加新模块,也可以是第三方模块,而根据安装nginx的方式,添加模块的方法也不一样。

nginx的安装有yum安装或源码安装,详情可参考我的另一篇博文:

《centos7 nginx 安装与配置实现负载均衡》

下面我就根据这两种安装方式,分别记录介绍以下如何不中断nginx服务的添加新模块

正文

首先说以下nginx新增模块的总体思路:nginx新增模块,不管什么安装的,都只能在编译的时候指定新增的模块,重新编译生成可执行的nginx文件。

根据这个思路,下面分别介绍源码安装和yum安装的nginx如何新增模块

1. 源码安装的nginx

源码安装的nginx新增模块比较方便,进入在安装时,我们下的源码包,如果除掉了,就去官网下载页面,重新下载相同版本的nginx的源码包

# 查看nginx版本和编译信息
$ nginx -V
nginx version: nginx/1.16.0
built by gcc 4.8.5 20150623 (Red Hat 4.8.5-36) (GCC) 
built with OpenSSL 1.0.2k-fips  26 Jan 2017
TLS SNI support enabled
configure arguments: --user=nginx --group=nginx --with-http_ssl_module

如上所示,版本为nginx 1.16.0,编译参数为最下面一行configure arguments的内容。现在进入之前的源码包,重新编译,编译时需要将原先已有的编译参数原封不动的写上,避免原有功能收到影响,再在后面添加新的模块。

# 进入之前安装时的源码包
$ cd /opt/nginx-1.16.0

# 因为这里我示例添加第三方模块nginx-auth-ldap,需要安装openldap-devel
$ yum install openldap-devel -y

# 添加第三方模块时,需要先的下载好第三方安装包,然后通过--add-moudle来指定目录
# 重新编译,添加新模块--with-stream,还有第三方模块nginx-auth-ldap
$ ./configure --user=nginx --group=nginx --with-stream --with-stream_ssl_module --with-stream --add-module=/root/nginx-auth-ldap

# 编译安装
# 执行make install会自动替换原来的nginx,无须手动,也不会中断nginx进程
$ make && make install

# 编译安装后,原有的配置文件等都会保留,只会有nginx的执行文件发生改变
# 查看nginx会发现nginx进程并没有中断
$ ps -ef|grep nginx

# 查看nginx 信息,发现新模块已添加
$ nginx -V
nginx version: nginx/1.16.0
built by gcc 4.8.5 20150623 (Red Hat 4.8.5-36) (GCC) 
built with OpenSSL 1.0.2k-fips  26 Jan 2017
TLS SNI support enabled
configure arguments: --user=nginx --group=nginx --with-http_ssl_module --with-stream --add-module=/root/nginx-auth-ldap


# 重新重载nginx就可以生效了
$ nginx -s reload

2. yum安装的nginx

yum安装的nginx默认就会安装很多常用的模块,如果要新增模块,思路跟源码安装的nginx是一样的,需要先去官网网站下载相同版本的nginx源码,然后重新进行编译。

# 查看现有nginx版本与编译的参数
$ nginx -V

如上图所示,yum安装的nginx默认就安装了很多了模块,重新编译时,需要都原封不动的复制上去,然后再在后面新增模块和第三方模块

# 官网下载nginx-1.12.2 并解压
$ wget http://nginx.org/download/nginx-1.12.2.tar.gz
$ tar -zxvf nginx-1.12.2.tar.gz

# 安装编译的依赖包
yum install -y gcc gcc-c++ automake pcre pcre-devel zlib zlib-devel openssl openssl-devel libxml2 libxml2-devel libxslt-devel gd-devel perl-devel perl-ExtUtils-Embed GeoIP GeoIP-devel GeoIP-data gperftools redhat-rpm-config
 
# 进入nginx,进行编译,编译时需要将上面查看到的现有nginx的参数都带上,然后在最后面添加你需要新增的模块
$ cd nginx-1.12.2
 
# 因为这里我示例添加第三方模块nginx-auth-ldap,需要安装openldap-devel
$ yum install openldap-devel -y
 
# 其中最后的--add-module=为我这里示例的需要增加的第三方模块的存放路径,第三方模块需要提前下载好
# 不管是第三方模块,还是自身模块,都直接在最后添加参数即可。
$ ./configure --prefix=/usr/share/nginx --sbin-path=/usr/sbin/nginx --modules-path=/usr/lib64/nginx/modules --conf-path=/etc/nginx/nginx.conf --error-log-path=/var/log/nginx/error.log --http-log-path=/var/log/nginx/access.log --http-client-body-temp-path=/var/lib/nginx/tmp/client_body --http-proxy-temp-path=/var/lib/nginx/tmp/proxy --http-fastcgi-temp-path=/var/lib/nginx/tmp/fastcgi --http-uwsgi-temp-path=/var/lib/nginx/tmp/uwsgi --http-scgi-temp-path=/var/lib/nginx/tmp/scgi --pid-path=/run/nginx.pid --lock-path=/run/lock/subsys/nginx --user=nginx --group=nginx --with-file-aio --with-ipv6 --with-http_auth_request_module --with-http_ssl_module --with-http_v2_module --with-http_realip_module --with-http_addition_module --with-http_xslt_module=dynamic --with-http_image_filter_module=dynamic --with-http_geoip_module=dynamic --with-http_sub_module --with-http_dav_module --with-http_flv_module --with-http_mp4_module --with-http_gunzip_module --with-http_gzip_static_module --with-http_random_index_module --with-http_secure_link_module --with-http_degradation_module --with-http_slice_module --with-http_stub_status_module --with-http_perl_module=dynamic --with-mail=dynamic --with-mail_ssl_module --with-pcre --with-pcre-jit --with-stream=dynamic --with-stream_ssl_module --with-google_perftools_module --with-debug --with-cc-opt='-O2 -g -pipe -Wall -Wp,-D_FORTIFY_SOURCE=2 -fexceptions -fstack-protector-strong --param=ssp-buffer-size=4 -grecord-gcc-switches -specs=/usr/lib/rpm/redhat/redhat-hardened-cc1 -m64 -mtune=generic' --with-ld-opt='-Wl,-z,relro -specs=/usr/lib/rpm/redhat/redhat-hardened-ld -Wl,-E' --add-module=/root/nginx-auth-ldap
 
 
 
# 编译,注意:这里很多说不能make install,只make就好了,其实不然,
# 在执行./configure命令时则已经查出了原有nginx的各个文件的路径,如果原来没有nginx,则会默认安装到/usr/local/nginx目录下。
# 直接执行make install 则会自动替换原来的nginx,无须手动,也不会中断nginx进程。
$ make && make install

# 安装后一样,只需要重载nginx就能生效
$ systemctl reload nginx

查看新的nginx,结果如下,会发现,我们新增的第三方模块已经加在了最末尾

结束

ok,到此就完成了nginx不中断服务新增第三方模块。

有任何问题,欢迎留言。