概述
nginx-rtmp-module 是一个用于 Nginx 的第三方模块，它扩展了 Nginx 服务器的功能，使其能够处理实时流媒体数据，特别是支持 RTMP (Real-Time Messaging Protocol) 协议。RTMP 是 Adobe Systems 开发的一种协议，常用于实时音视频通信，尤其是在直播场景中。
nginx-rtmp-module 的主要用途包括：
- 直播服务器：允许用户设置一个简单的直播服务器，主播可以通过 RTMP 协议推送直播流到服务器，而观众可以通过 HLS (HTTP Live Streaming)、RTMP 或其他协议观看直播。
- 视频点播(VOD)：支持视频文件作为点播内容，用户可以随时请求观看存储的视频内容。
- 转码与录制：可以配置模块进行实时流的转码（需要集成如 FFmpeg 等工具）以及录制直播流到本地文件。
- 防盗链与访问控制：提供了一些基本的安全措施，比如限制来源 IP、设置密钥验证等，以保护流媒体内容。
- 负载均衡与故障转移：可以配置 Nginx 作为负载均衡器，将客户端请求分发到多个后端 RTMP 服务器，提高系统的稳定性和可用性。
- HLS 支持：自动将 RTMP 流转换为 HLS 格式，使得直播内容可以在不直接支持 RTMP 的设备和浏览器上播放，如 iOS 设备和现代网页浏览器。
通过配置 nginx-rtmp-module，开发者或系统管理员可以轻松搭建高效、可扩展的流媒体服务，适用于各种规模的直播应用需求。这个模块通过其灵活的配置选项，提供了对流媒体处理流程的强大控制能力。
nginx-rtmp-module 的使用涉及配置 Nginx 的配置文件来实现特定的流媒体处理逻辑。下面是一个简化的示例，展示如何配置 Nginx 使用 nginx-rtmp-module 来搭建一个基础的直播服务器。
安装 nginx 和 nginx-rtmp-module
首先，确保你的系统已经安装了 Nginx。然后，你需要下载 nginx-rtmp-module 源码并编译 Nginx 以包含此模块。以下是基于 Linux 系统的一个基本步骤（具体命令可能根据你的操作系统和版本有所不同）：
# 下载 Nginx 源码 wget http://nginx.org/download/nginx-1.18.0.tar.gz tar -xzf nginx-1.18.0.tar.gz # 下载 nginx-rtmp-module git clone https://github.com/arut/nginx-rtmp-module.git # 进入 Nginx 源码目录并配置编译参数以包含 nginx-rtmp-module cd nginx-1.18.0 ./configure --add-module=/path/to/nginx-rtmp-module make sudo make install
配置 Nginx
接下来，修改 Nginx 的配置文件（通常位于 /etc/nginx/nginx.conf 或 /usr/local/nginx/conf/nginx.conf），添加关于 nginx-rtmp-module 的配置。以下是一个基本的配置示例：
worker_processes 1; events { worker_connections 1024; } http { # HTTP 相关配置可以在这里添加，例如服务器根目录等 } rtmp { server { listen 1935; # RTMP 默认监听端口 application live { # 应用名为 live live on; # 启用直播模式 record off; # 不记录直播流，默认关闭，可改为 'record all' 来记录所有流 # 可以在这里添加更多配置，比如推流和拉流的权限控制、转码设置等 } # 如果需要支持 HLS，可以添加如下配置 application hls { live on; hls on; hls_path /tmp/hls; # HLS 文件存放路径 hls_fragment 5s; # HLS 分片时长 } } }
启动 Nginx
配置完成后，重启或启动 Nginx 以使配置生效：
sudo service nginx restart
使用示例
推流
主播使用支持 RTMP 的软件（如 OBS Studio）向你的服务器推流，URL 为 rtmp://your_server_ip/live/your_stream_key。
拉流
- RTMP 拉流：
rtmp://your_server_ip/live/your_stream_key - HLS 拉流：
http://your_server_ip/hls/your_stream_key.m3u8
请替换 your_server_ip 为你的服务器 IP 地址，your_stream_key 为自定义的流名称。这只是一个非常基础的示例，实际上 nginx-rtmp-module 提供了丰富的配置选项，可以实现更复杂的流媒体处理逻辑，如多路复用、转码、鉴权等。
在上面的基础上，让我们深入探讨一些高级功能和配置示例，以进一步扩展你的流媒体服务器的能力。
转码
nginx-rtmp-module 可以与 FFmpeg 配合实现流的实时转码。这允许你接收一个编码格式的流，然后将其转换为不同格式或比特率，以适应不同客户端的需求。
配置示例（添加到 rtmp 配置块内）：
application adaptive { live on; hls on; hls_path /tmp/hls_adaptive; hls_nested on; # 转码设置 exec_push /usr/bin/ffmpeg -i rtmp://localhost/$app/$name -c:v libx264 -preset veryfast -b:v 400k -maxrate 400k -bufsize 800k -vf scale=-1:480 -c:a aac -b:a 96k -ar 44100 -f flv rtmp://localhost/hls_adaptive/$name_low; exec_push /usr/bin/ffmpeg -i rtmp://localhost/$app/$name -c:v libx264 -preset veryfast -b:v 1000k -maxrate 1000k -bufsize 2000k -vf scale=-1:720 -c:a aac -b:a 128k -ar 44100 -f flv rtmp://localhost/hls_adaptive/$name_high; }
这段配置会为每个推送到 adaptive 应用的流创建两个转码版本：一个低比特率（400kbps），一个高比特率（1000kbps），同时生成对应的 HLS 播放列表。
鉴权与安全
为了增强安全性，你可以为推流和拉流添加基本的鉴权机制。
location /live { auth_basic "Restricted"; # 弹出的认证对话框提示信息 auth_basic_user_file /etc/nginx/.htpasswd; # 用户名密码文件路径 } rtmp { server { application private { live on; # 推流鉴权 on_publish http://localhost/auth.php; # 拉流鉴权 on_play http://localhost/auth.php; } } }
这里，on_publish 和 on_play 指令分别在推流和拉流时调用外部脚本进行鉴权检查。你需要自己编写 auth.php 脚本来实现具体的逻辑，比如检查请求头中的认证信息是否有效。
自动录制
你可以设置自动录制直播流，这对于存档或后期编辑非常有用。
application myapp { live on; record all; record_path /tmp/records; record_unique on; record_suffix .flv; }
这段配置会在 /tmp/records 目录下为每个流自动创建 FLV 格式的录制文件。
