通俗易懂讲解 nginx-rtmp-module 是干嘛的？

概述

nginx-rtmp-module 是一个用于 Nginx 的第三方模块，它扩展了 Nginx 服务器的功能，使其能够处理实时流媒体数据，特别是支持 RTMP (Real-Time Messaging Protocol) 协议。RTMP 是 Adobe Systems 开发的一种协议，常用于实时音视频通信，尤其是在直播场景中。

nginx-rtmp-module 的主要用途包括：

1. 直播服务器：允许用户设置一个简单的直播服务器，主播可以通过 RTMP 协议推送直播流到服务器，而观众可以通过 HLS (HTTP Live Streaming)、RTMP 或其他协议观看直播。

2. 视频点播(VOD)：支持视频文件作为点播内容，用户可以随时请求观看存储的视频内容。

3. 转码与录制：可以配置模块进行实时流的转码（需要集成如 FFmpeg 等工具）以及录制直播流到本地文件。

4. 防盗链与访问控制：提供了一些基本的安全措施，比如限制来源 IP、设置密钥验证等，以保护流媒体内容。

5. 负载均衡与故障转移：可以配置 Nginx 作为负载均衡器，将客户端请求分发到多个后端 RTMP 服务器，提高系统的稳定性和可用性。

6. 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 格式的录制文件。