Nginx动态添加模块平滑升级

Nginx动态添加模块与平滑升级指南

最新推荐文章于 2025-07-24 15:01:46 发布

原创最新推荐文章于 2025-07-24 15:01:46 发布 · 258 阅读

0 ·

CC 4.0 BY-SA版权

文章标签：

#nginx #linux

Nginx 专栏收录该内容

6 篇文章

订阅专栏

本文详细介绍了如何在已安装的Nginx上动态添加新的模块，例如nginx-rtmp-module。首先，下载并解压所需模块，然后查看当前Nginx的编译参数。接下来，在原有编译参数基础上添加新模块路径，重新编译但不执行`make install`。接着，停止Nginx服务，备份旧的二进制文件，并替换为新编译的二进制文件。最后，验证新模块是否成功安装。此过程确保了服务的平滑升级，避免了系统中断。

Nginx动态添加模块平滑升级
已经安装好的Nginx动态添加模块

说明：

已经安装好的Nginx，需要添加一个未被编译安装的模块，需要怎么弄呢？这里已安装第三方nginx-rtmp-module模块为例

nginx的模块是需要重新编译nginx，而不是像apache一样配置文件引用.so

具体操作步骤：

（1）下载第三方扩展模块nginx-rtmp-module

# cd /home/work/software/
# wget https://github.com/arut/nginx-rtmp-module/archive/master.zip
# unzip master.zip
# ls nginx-rtmp-module-master/

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

# /opt/nginx-1.9.5/sbin/nginx -V 
nginx version: nginx/1.9.5
built by gcc 4.4.7 20120313 (Red Hat 4.4.7-23) (GCC) 
built with OpenSSL 1.0.1g 7 Apr 2014
TLS SNI support enabled
configure arguments: --prefix=/opt/nginx-1.9.5 --with-pcre=/home/work/software/pcre-8.38 --with-zlib=/home/work/software/zlib-1.2.8 --conf-path=/opt/nginx-1.9.5/conf/nginx.conf --pid-path=/opt/nginx-1.9.5/conf/nginx.pid --with-http_ssl_module --with-openssl=/home/work/software/openssl-1.0.1g --add-module=/home/work/software/headers-more-nginx-module-0.23 --add-module=/home/work/software/nginx-http-concat-master --with-http_gzip_static_module

可以看出编译安装使用了--prefix=/opt/nginx-1.9.5 --with-pcre=/home/work/software/pcre-8.38 --with-zlib=/home/work/software/zlib-1.2.8 --conf-path=/opt/nginx-1.9.5/conf/nginx.conf --pid-path=/opt/nginx-1.9.5/conf/nginx.pid --with-http_ssl_module --with-openssl=/home/work/software/openssl-1.0.1g --add-module=/home/work/software/headers-more-nginx-module-0.23 --add-module=/home/work/software/nginx-http-concat-master --with-http_gzip_static_module这些模块。

（3）加入需要安装的模块，重新编译，如这里添加–add-module=/home/work/software/nginx-rtmp-module-master

# cd /home/work/software/nginx-1.9.5     //进入到nginx之前安装的目录
# ./configure --prefix=/opt/nginx-1.9.5 --with-pcre=/home/work/software/pcre-8.38 --with-zlib=/home/work/software/zlib-1.2.8 --conf-path=/opt/nginx-1.9.5/conf/nginx.conf --pid-path=/opt/nginx-1.9.5/conf/nginx.pid --with-http_ssl_module --with-openssl=/home/work/software/openssl-1.0.1g --add-module=/home/work/software/headers-more-nginx-module-0.23 --add-module=/home/work/software/nginx-http-concat-master --with-http_gzip_static_module --add-module=/home/work/software/nginx-rtmp-module-master
# make    //注意：千万不要make install，不然真的就GG了

（4）替换nginx二进制文件

# /etc/init.d/nginx stop　　
# cp /opt/nginx-1.9.5/sbin/nginx /opt/nginx-1.9.5/sbin/nginx.bak
# cp ./objs/nginx /opt/nginx-1.9.5/sbin/

（5）再次确认是否安装成功

# /opt/nginx-1.9.5/sbin/nginx -V 
nginx version: nginx/1.9.5
built by gcc 4.4.7 20120313 (Red Hat 4.4.7-23) (GCC) 
built with OpenSSL 1.0.1g 7 Apr 2014
TLS SNI support enabled
configure arguments: --prefix=/opt/nginx-1.9.5 --with-pcre=/home/work/software/pcre-8.38 --with-zlib=/home/work/software/zlib-1.2.8 --conf-path=/opt/nginx-1.9.5/conf/nginx.conf --pid-path=/opt/nginx-1.9.5/conf/nginx.pid --with-http_ssl_module --with-openssl=/home/work/software/openssl-1.0.1g --add-module=/home/work/software/headers-more-nginx-module-0.23 --add-module=/home/work/software/nginx-http-concat-master --with-http_gzip_static_module --add-module=/home/work/software/nginx-rtmp-module-master