简介
Nginx 1.9.11开始增加加载动态模块支持,可以在不停机的情况下加载和卸载模块。从此不再需要替换nginx文件即可增加第三方扩展。目前官方只有几个模块支持动态加载,第三方模块需要升级支持才可编译成模块。
通过帮助命令./configure --help | grep dynamic 查看是否支持动态加载模块
如上可看出官方支持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 服务和动态网关。
下载 nginx-rtmp-module
下载模块路径地址为:/home/www/build/nginx-rtmp-module
编译
进入 OpenResty 目录
编译
添加 --with-compat 选项,生成可加载模块的 Nginx 可执行文件
注意:这里不要执行make install 命令,否则会覆盖已安装的Nginx二进制文件,我们这里是动态加载只需要编译模块生成第三方模块.so文件就行了。
复制模块到指定目录
将模块库ngx_rtmp_module.so文件复制到 /usr/local/openresty/nginx/modules
加载模块
要将模块加载到Nginx,请将load_module指令添加到nginx.conf主配置文件的主上下文中。
nginx.conf主配置文件参考
使用模块
新增流媒体服务器配置
注意:该配置需要和HTTP上下文并列,而不是放在HTTP模块里面
检测Nginx配置文件是否OK
没问题直接重启openresty服务即可。
安全组设置
打开安全组设置,在[入方向] 开放1935端口,1935端口是rtmp默认监听端口,必须在这里设置开放,否则在服务器中打开和监听1935端口后公网环境连接不到该端口。
图片
OBS 推流
推流地址:rtmp://{服务器公网IP}/live/tinywan2024
图片
VLC 拉流播放
拉流地址:rtmp://{服务器公网IP}/live/tinywan2024
图片
出现“is not binary compatible in”错误的解决方案
原因
第三方模块的编译中包含的签名和使用的nignx不一致。
解决方案
先通过 nginx -V 命令得到当前配置的configure配置
在复制所有的配置命令。添加到:
注意事项:
- 动态模块只能在 Nginx 1.9.11 及以上版本中使用。
- 加载和卸载模块需要 root 权限。
- 加载和卸载模块会影响 Nginx 的性能,建议在低峰期进行操作。
- 加载和卸载模块可能会导致 Nginx 进程崩溃,建议备份配置文件和 Nginx 可执行文件。