安装nginx-http-flv-module模块

简介

nginx中的模块虽然就是类似插件的概念,但是它无法像VsCode那样轻松的安装扩展。

nginx要安装其它模块必须同时拿到nginx源代码和模块源代码,然后手动编译,将模块打到nginx中,最终生成一个名为nginx的可执行文件。

nginx-http-flv-module是什么

  • nginx-http-flv-module是nginx的一个模块(拓展插件),它基于 nginx-rtmp-module 二次开发,拥有 nginx-rtmp-module 全部的功能
  • HTTP-FLV播放,GOP缓存,虚拟主机,RTMP/HTTP-FLV纯音频支持,HLS播放等等
  • 兼容性:要求nginx的版本大于等于1.2.6

流程

  • 查看当前nginx 的版本(假设安装位置为:/usr/local/nginx)
  • 下载当前版本nginx的源代码
  • 下载 nginx-http-flv-module 模块源代码
  • 重新编译nginx并追加nginx-http-flv-module
  • 将新编译好的 nginx 可执行文件拷贝到当前nginx安装目录(/usr/local/nginx/sbin)

注意事项

由于nginx-http-flv-module包含了 nginx-rtmp-module 模块,所以不可将 nginx-http-flv-module 和 nginx-rtmp-module 同时编译,当我们编译完 nginx-http-flv-module 之后,其实就已经拥有了 nginx-rtmp-module 的完整功能。

详细步骤

查看当前已经安装的nginx版本

[root@bogon sbin]# ./nginx -V
nginx version: nginx/1.18.0
built by gcc 4.8.5 20150623 (Red Hat 4.8.5-44) (GCC)
built with OpenSSL 1.0.2k-fips  26 Jan 2017
TLS SNI support enabled configure arguments: --prefix=/usr/local/nginx --with-http_dav_module --with-http_stub_status_module --with-http_addition_module --with-http_sub_module --with-http_flv_module --with-http_mp4_module --with-pcre --with-http_ssl_module --with-http_gzip_static_module  
  • V:小v仅打印版本号,大V既打印版本号,也打印扩展信息,这里要使用大V
  • 拿到版本号的目的是待会要下载该版本的源代码
  • 注意保存打印内容中的 arguments 后面的内容,后面编译会用到

下载对应版本的nginx源代码

找一个目录,假设为 /home/cml

下载 1.18.0 版本的nginx

wget http://nginx.org/download/nginx-1.18.0.tar.gz

tar -zxvf   nginx-1.18.0.tar.gz

下载nginx-http-flv-module模块源代码

还是进入到 /home/cml ,下载 nginx-http-flv-module 模块的源代码

git clone https://github.com/winshining/nginx-http-flv-module.git

这里需要注意源代码所在目录的名称和目录的层级。确保在 /home/cml 目录下有一个名为 nginx-http-flv-module 的目录,而目录的内容如下:

[root@bogon nginx-http-flv-module]# tree    -L 1
.
├── AUTHORS
├── config
├── dash ├── doc ├── hls ├── LICENSE ├── ngx_http_flv_live_module.c ├── ngx_http_flv_live_module.h ......  

重新编译nginx

此时,/home/cml 目录下面有两个目录

  • nginx-1.18.0
  • nginx-http-flv-module

进入 nginx-1.18.0 目录,可以看到有一个 configure 可执行文件,执行如下命令

./configure  --prefix=/usr/local/nginx --with-http_dav_module --with-http_stub_status_module --with-http_addition_module --with-http_sub_module --with-http_flv_module --with-http_mp4_module --with-pcre --with-http_ssl_module --with-http_gzip_static_module --add-module=/home/cml/nginx-http-flv-module
  • 使用configure 配置编译环境
  • 将上面 保存的"arguments 后面的内容"作为configure 的第一个参数
  • 第二个参数为 --add-module=/home/cml/nginx-http-flv-module ,即添加一个模块,模块源代码位置是 /home/cml/nginx-http-flv-module

如果没有出错,执行 编译命令

make

编译成功后,在/home/cml/nginx-1.18.0/objs 中会有一个 名为nginx的可执行文件,这个就是编译好的nginx了, 里面包含已经安装的功能和新增加的nginx-rtmp-module,将这个可执行文件拷贝到当前安装目录(/usr/local/nginx/sbin)中就可以了。

注意拷贝之前需要停止nginx,否则会报当前文件繁忙,无法覆盖的错误。

验证nginx-http-flv-module是否安装好了

nginx   -V 

若打印的信息中包含nginx-http-flv-module,说明安装好了。

引用

本文使用 mdnice 排版