nginx-rtmp-module高级配置：直播录制、转码与HTTP回调实战指南

nginx-rtmp-module高级配置：直播录制、转码与HTTP回调实战指南

【免费下载链接】nginx-rtmp-modulenginx-rtmp-module: nginx-rtmp-module 是一个 Nginx 模块，用于支持 RTMP、HLS 和 MPEG-DASH 直播流媒体，提供录制、转码和HTTP回调等功能。项目地址: https://gitcode.com/gh_mirrors/ng/nginx-rtmp-module

nginx-rtmp-module是一个功能强大的Nginx模块，支持RTMP、HLS和MPEG-DASH直播流媒体，提供录制、转码和HTTP回调等实用功能。本文将详细介绍如何通过高级配置实现直播内容的录制管理、自动转码处理以及实时事件通知，帮助新手用户快速掌握企业级直播服务搭建技巧。

📌 核心功能概览

nginx-rtmp-module作为Nginx的扩展模块，主要提供三大核心能力：

• 直播协议支持：RTMP主协议及HLS、DASH自适应流
• 内容处理：实时录制、格式转换、水印叠加
• 事件驱动：基于HTTP的发布/播放/录制状态回调

nginx-rtmp-module直播服务架构图

🔧 直播录制高级配置

基础录制设置

在nginx.conf中配置直播录制功能，支持按时间分片和自动命名：

rtmp { server { listen 1935; application live { live on; # 基础录制配置 record all; record_path /var/nginx/recordings; record_unique on; record_suffix _%Y%m%d_%H%M%S.flv; } } }

高级录制策略

通过录制规则实现灵活管理：

• 按文件大小切割：record_max_size 500M;
• 按时间长度切割：record_interval 30m;
• 选择性录制：record if=$record_condition;

相关配置示例可参考项目测试配置文件：test/nginx.conf

🎥 实时转码配置指南

利用FFmpeg实现自动转码

通过exec_push指令集成FFmpeg进行实时转码：

application live { live on; exec_push /usr/bin/ffmpeg -i rtmp://localhost/live/$name -c:v libx264 -c:a aac -f flv rtmp://localhost/live/$name_720p; }

这条配置会自动将直播流转码为720p分辨率的备用流，满足不同网络环境的播放需求。项目测试脚本test/ffstream.sh提供了更多转码示例。

多码率自适应流配置

配置HLS多码率输出，实现自适应比特率流：

application hls { live on; hls on; hls_path /var/nginx/hls; hls_variant _low BANDWIDTH=500000; hls_variant _mid BANDWIDTH=1000000; hls_variant _high BANDWIDTH=2500000; }

🔄 HTTP回调与事件通知

常用回调事件配置

在nginx.conf中配置事件回调：

application live { live on; # 发布回调 on_publish http://localhost:8080/api/publish; # 播放回调 on_play http://localhost:8080/api/play; # 录制完成回调 on_record_done http://localhost:8080/api/record_done; }

这些回调接口可以与业务系统集成，实现用户认证、观看统计和内容管理等功能。

回调数据格式

回调请求会包含丰富的流信息，以on_play为例：

POST /api/play HTTP/1.1 Content-Length: 123 Content-Type: application/x-www-form-urlencoded app=live&name=stream1&clientid=12345&ip=192.168.1.100&useragent=FFmpeg/4.2.2

📝 完整配置示例

结合以上功能的完整配置片段：

rtmp { server { listen 1935; application live { live on; # 录制配置 record all; record_path /var/nginx/recordings; record_unique on; # 转码配置 exec_push /usr/bin/ffmpeg -i rtmp://localhost/live/$name -c:v libx264 -s 1280x720 -b:v 2500k -c:a aac -f flv rtmp://localhost/live/$name_720p; # 回调配置 on_publish http://localhost:8080/api/auth; on_record_done http://localhost:8080/api/process_video; } application hls { live on; hls on; hls_path /var/nginx/hls; hls_fragment 10s; } } }

🚀 快速部署步骤

1. 克隆项目仓库：

git clone https://gitcode.com/gh_mirrors/ng/nginx-rtmp-module

2. 编译安装Nginx与模块：

./configure --add-module=./nginx-rtmp-module make && make install

3. 配置示例参考：test/nginx.conf
4. 启动服务：nginx -c /path/to/your/nginx.conf

💡 使用技巧与注意事项

• 录制文件管理：定期清理过期文件，可配合cron任务实现
• 转码性能优化：使用硬件加速（如-c:v h264_nvenc）提升转码效率
• 回调服务可靠性：确保回调接口支持重试机制，避免事件丢失
• 日志分析：通过ngx_rtmp_log_module.c模块输出的日志进行服务监控

通过以上配置，您可以构建一个功能完善的直播服务系统，满足从内容采集、处理到分发的全流程需求。更多高级功能可参考项目文档和模块源码进一步探索。

【免费下载链接】nginx-rtmp-modulenginx-rtmp-module: nginx-rtmp-module 是一个 Nginx 模块，用于支持 RTMP、HLS 和 MPEG-DASH 直播流媒体，提供录制、转码和HTTP回调等功能。项目地址: https://gitcode.com/gh_mirrors/ng/nginx-rtmp-module