boinx/nginx-rtmp

nginx-rtmp 镜像说明

镜像概述

本镜像基于NGINX构建，提供RTMP流媒体直播服务，支持Flash、iOS和Android平台的视频播放，可用于搭建个人或小型直播平台，实现流转发、多码率适配等功能。

核心功能

1. 支持RTMP协议的直播发布与播放
2. 提供HLS协议的流媒体播放能力
3. 通过环境变量配置流参数（分辨率、码率等）
4. 支持将直播流转发至第三方服务器（如下游平台）
5. 允许配置CORS规则以支持跨域请求
6. 实验性支持etcd动态重载配置
7. 提供受保护的统计信息查询接口

使用场景

• 个人或团队搭建小型直播平台
• 将直播流转发至第三方平台（如***）
• 为移动应用或网页提供直播服务
• 需要多码率适配的直播场景

配置说明

环境变量配置

• 必填项
  LIVE_SECRET: 用于发布流和访问统计信息的密钥令牌。

• 可选项（实验性）

  • LIVE_VARIANTS_{name}: 视频转码参数，格式为{分辨率}:{视频码率(kbps)}:{音频码率(kbps)}:{带宽(bps)}，例如640x480:512:128:640000。
  • LIVE_DOWNSTREAMS_{name}: 下游RTMP服务器URL，用于转发直播流（使用时建议仅接收单个流）。
  • LIVE_CORS: 允许跨域请求的HTTP origin正则表达式。

端口暴露

• 80端口：HTTP服务（HLS播放、统计信息）
• 1935端口：RTMP服务（流发布、播放）

Docker部署示例

bash
docker run -e LIVE_SECRET=你的密钥 \
           -e LIVE_VARIANTS_LOW=640x480:128:64:192000 \
           -e LIVE_VARIANTS_MED=640x480:512:128:640000 \
           -p 80:80 -p 1935:1935 docker.xuanyuan.run/boinx/nginx-rtmp

动态配置重载（实验性）

设置ETCD_URL后，配置将从etcd服务读取（对应键如/live/cors、/live/secret），容器每10秒轮询配置变化，若更新则重载NGINX。

发布与播放地址

• 发布URL: rtmp://你的服务器地址/pub_你的密钥/你的流名称
• RTMP播放URL: rtmp://你的服务器地址/player/你的流名称
• HLS播放URL: http://你的服务器地址/hls/你的流名称.m3u8

统计信息访问

统计资源（info/stats）受保护，访问路径为/p/{token}/{资源名}，其中token生成命令：

bash
echo -n '{资源名}{你的密钥}' | openssl md5 -hex

许可证

本镜像基于MIT许可证，详见LICENSE文件。