此文章已不再更新,查看最新版内容和更多内容:
《Centos7 nginx 不中断服务添加新模块或第三方模块》
--------------------------------------------------- 分隔符 ---------------------------------------------------
nginx作为一个超常用的web服务器,负载均衡器,被广泛使用。而nginx的各种功能是需要通过各种模块来实现的,经常会遇到安装时并没有安装此模块,但后面由于业务需求等会使用到未安装的模块,此时就需要在原来nginx的基础上添加新模块,也可能是第三方模块,而根据安装nginx的方式,添加模块的方法也不一样。
nginx源码安装,添加模块,请参考我另一篇博文:《centos7.2 源码编译安装nginx,新增编译模块,实现tcp反向代理》
这里详细说明以下,通过yum安装的nginx,如何新增模块。整体思路是,需要下载yum安装的nginx相同版本的nginx源码,然后通过源码进行编译,在编译中添加新的模块,然后将编译完成后的nginx可执行文件进行替换。已实现添加模块。
1. 查看现有nginx版本与编译的参数
# 查看版本与编译参数,就是下面结果中的configure arguments:后面的参数,后面重新编译时需要带上 $ nginx -V
2. 下载相同版本nginx
# 官网下载nginx-1.12.2 并解压 $ wget http://nginx.org/download/nginx-1.12.2.tar.gz $ tar -zxvf nginx-1.12.2.tar.gz
3. 备份原有nginx和配置
# 暂时备份到用户目录下,以备操作错误时,进行还原 $ cp /usr/sbin/nginx ~/nginx.back $ cp -r /ect/nginx ~/nginx.conf.back4. 编译nginx,添加模块
# 安装编译的依赖包 yum install gcc gcc-c++ automake pcre pcre-devel zlib zlib-devel openssl openssl-devel libxml2 libxml2-dev 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
5. 检查新nginx,重启生效
# 编译后,会自动替换原有nginx,查看nginx配置,是否还是之前的,查看conf.d内的配置是否还在 $ cat /etc/nginx/nginx.conf $ ls /etc/nginx/conf.d # 查看nginx参数,看看我们新增的模块在不在 $ nginx -V # 重启nginx生效 $ systemctl restart nginx查看新的nginx,结果如下,会发现,我们新增的第三方模块已经加在了最末尾
编译安装后,原有的nginx配置与文件等都不会发生变化,不需要重新设置nginx配置等。直接重启就可以正常使用了。上面的备份文件只是一以备不时之需,在操作出错时以方便恢复,正常新增模块,测试使用正常后,备份文件则可删除。
有任何不明白或有问题的地方,欢迎留言指正,谢谢