简介
Nginx 1.9.11开始增加加载动态模块支持，可以在不停机的情况下加载和卸载模块。从此不再需要替换nginx文件即可增加第三方扩展。目前官方只有几个模块支持动态加载，第三方模块需要升级支持才可编译成模块。
通过帮助命令
./configure --help | grep dynamic查看是否支持动态加载模块
~/build/openresty-1.19.3.1$ ./configure --help | grep dynamic
--with-http_xslt_module=dynamic enable dynamic ngx_http_xslt_module
--with-http_image_filter_module=dynamic
enable dynamic ngx_http_image_filter_module
--with-http_geoip_module=dynamic enable dynamic ngx_http_geoip_module
--with-http_perl_module=dynamic enable dynamic ngx_http_perl_module
--with-mail=dynamic enable dynamic POP3/IMAP4/SMTP proxy module
--with-stream=dynamic enable dynamic TCP/UDP proxy module
--with-stream_geoip_module=dynamic enable dynamic ngx_stream_geoip_module
--add-dynamic-module=PATH enable dynamic external module
--with-compat dynamic modules compatibility
如上可看出官方支持9个动态模块编译，需要增加第三方模块，使用参数--add-dynamic-module=即可。
动态模块概述
-
可以加载到NGINX中的模块是用C编写的 -
获取匹配的NGINX开源版本 -
获取模块源，并在必要时更改模块的配置文件 -
使用 configure命令的-?-add-dynamic-module参数针对NGINX开源版本构建动态模块 -
将生成的动态模块（ .so文件）加载到NGINX中（modules目录下），就像使用内置模块一样使用它
动态模块语法
-
命令：load_module -
Default: — -
上下文配置段: main -
说明：版本必须 >=1.9.11 -
实例： load_module modules/ngx_mail_module.so;
编译动态模块
这里安装基于Nginx的流媒体服务器：nginx-rtmp-module 模块
项目地址：https://github.com/arut/nginx-rtmp-module
下载 OpenResty
OpenResty? 是一个基于 Nginx 与 Lua 的高性能 Web 平台，其内部集成了大量精良的 Lua 库、第三方模块以及大多数的依赖项。用于方便地搭建能够处理超高并发、扩展性极高的动态 Web 应用、Web 服务和动态网关。
// 下载
wget https://openresty.org/download/openresty-1.19.3.1.tar.gz
// 解压
tar -zxvf openresty-1.19.3.1.tar.gz
下载 nginx-rtmp-module
git clone https://github.com/arut/nginx-rtmp-module.git
下载模块路径地址为：
/home/www/build/nginx-rtmp-module
编译
进入 OpenResty 目录
cd openresty-1.19.3.1
编译
./configure --prefix=/usr/local/openresty/nginx --with-cc-opt=\\\'-O2 -O3\\\' \\\\
--with-ld-opt=-Wl,-rpath,/usr/local/openresty/luajit/lib --with-pcre-jit \\\\
--with-stream --with-stream_ssl_module --with-stream=dynamic --with-file-aio \\\\
--with-threads --with-http_v2_module --with-http_realip_module \\\\
--with-http_mp4_module --with-http_gzip_static_module --with-http_ssl_module \\\\
--with-http_stub_status_module --with-http_xslt_module \\\\
--with-openssl-opt=\\\'-g enable-tlsext\\\' --with-stream \\\\
--with-stream_ssl_preread_module \\\\
--with-compat --add-dynamic-module=/home/www/build/nginx-rtmp-module
// 编译
make
添加
--with-compat选项，生成可加载模块的 Nginx 可执行文件
注意：这里不要执行
make install命令，否则会覆盖已安装的Nginx二进制文件，我们这里是动态加载只需要编译模块生成第三方模块.so文件就行了。
复制模块到指定目录
将模块库
ngx_rtmp_module.so文件复制到/usr/local/openresty/nginx/modules
cp /home/www/build/openresty-1.19.3.1/build/nginx-1.19.3/objs/ngx_rtmp_module.so /usr/local/openresty/nginx/modules/
加载模块
要将模块加载到Nginx，请将load_module指令添加到nginx.conf主配置文件的主上下文中。
load_module modules/ngx_rtmp_module.so;
nginx.conf主配置文件参考
user tinywan;
worker_processes auto;
// 其他配置...
load_module modules/ngx_rtmp_module.so;
// 其他配置...
使用模块
新增流媒体服务器配置
rtmp {
server {
listen 1935;
chunk_size 4000;
drop_idle_publisher 10s;
idle_streams off;
application live {
live on;
}
application hls {
live on;
hls on;
hls_path /tmp/hls;
}
# MPEG-DASH is similar to HLS
application dash {
live on;
dash on;
dash_path /tmp/dash;
}
}
}
注意：该配置需要和HTTP上下文并列，而不是放在HTTP模块里面
检测Nginx配置文件是否OK
sudo /usr/local/openresty/nginx/sbin/nginx -t
nginx: the configuration file /usr/local/openresty/nginx/conf/nginx.conf syntax is ok
nginx: configuration file /usr/local/openresty/nginx/conf/nginx.conf test is successful
没问题直接重启openresty服务即可。
sudo systemctl restart openresty.service
安全组设置
打开安全组设置，在[入方向] 开放1935端口，1935端口是rtmp默认监听端口，必须在这里设置开放，否则在服务器中打开和监听1935端口后公网环境连接不到该端口。
OBS 推流
推流地址：
rtmp://{服务器公网IP}/live/tinywan2024
VLC 拉流播放
拉流地址：
rtmp://{服务器公网IP}/live/tinywan2024
出现“is not binary compatible in”错误的解决方案
sudo /usr/local/openresty/nginx/sbin/nginx -t
nginx: [emerg] module \\\"/usr/local/openresty/nginx/modules/ngx_rtmp_module.so\\\" is not binary compatible in /usr/local/openresty/nginx/conf/nginx.conf:7
nginx: configuration file /usr/local/openresty/nginx/conf/nginx.conf test failed
原因
第三方模块的编译中包含的签名和使用的nignx不一致。
解决方案
先通过 nginx -V 命令得到当前配置的configure配置
/usr/local/openresty/nginx/sbin/nginx -V
nginx version: openresty/1.19.3.1built by gcc 7.5.0 (Ubuntu 7.5.0-3ubuntu1~18.04) built with OpenSSL 1.1.1 11 Sep 2018TLS SNI support enabledconfigure arguments: --prefix=/usr/local/openresty/nginx \\\\
--with-cc-opt=\\\'-O2 -O3\\\' --add-module=../ngx_devel_kit-0.3.1 \\\\
--add-module=../iconv-nginx-module-0.14 \\\\
--add-module=../echo-nginx-module-0.62 \\\\
--add-module=../xss-nginx-module-0.06 \\\\
--add-module=../ngx_coolkit-0.2 \\\\
--add-module=../set-misc-nginx-module-0.32 \\\\
--add-module=../form-input-nginx-module-0.12 \\\\
--add-module=../encrypted-session-nginx-module-0.08 \\\\
--add-module=../srcache-nginx-module-0.32 \\\\
--add-module=../ngx_lua-0.10.19 \\\\
--add-module=../ngx_lua_upstream-0.07 \\\\
--add-module=../headers-more-nginx-module-0.33 \\\\
--add-module=../array-var-nginx-module-0.05 \\\\
--add-module=../memc-nginx-module-0.19 \\\\
--add-module=../redis-nginx-module-0.3.7 \\\\
--add-module=../rds-json-nginx-module-0.15 \\\\
--add-module=../rds-csv-nginx-module-0.09 \\\\
--add-module=../ngx_stream_lua-0.0.9 \\\\
--with-ld-opt=-Wl,-rpath,/usr/local/openresty/luajit/lib \\\\
--with-pcre-jit --with-stream --with-stream_ssl_module \\\\
--with-stream=dynamic --with-file-aio --with-threads \\\\
--with-http_v2_module --with-http_realip_module \\\\
--with-http_mp4_module --with-http_gzip_static_module \\\\
--with-http_ssl_module --with-http_stub_status_module \\\\
--with-http_xslt_module --with-openssl-opt=\\\'-g enable-tlsext\\\' \\\\
--with-stream --with-stream_ssl_preread_module
在复制所有的配置命令。添加到：
./configure [“你的nignx -V 得到的配置参数”] --add-dynamic-module=/home/www/build/nginx-rtmp-module
注意事项：
-
动态模块只能在 Nginx 1.9.11 及以上版本中使用。 -
加载和卸载模块需要 root 权限。 -
加载和卸载模块会影响 Nginx 的性能，建议在低峰期进行操作。 -
加载和卸载模块可能会导致 Nginx 进程崩溃，建议备份配置文件和 Nginx 可执行文件。
原创文章，作者：网络技术联盟站，如若转载，请注明出处：https://www.sudun.com/ask/49828.html
