ngucandy/rtmp-hls

RTMP-HLS Docker支持RTMP、HLS和DASH流的视频流媒体服务器Docker镜像。

## 镜像概述和主要用途

该Docker镜像可用于创建开箱即支持RTMP、HLS和DASH的视频流媒体服务器。它还支持自适应流和视频流的自定义转码。所有模块均基于Debian和Alpine Linux基础镜像从源代码构建。

核心功能和特性

• 后端采用Nginx与https://github.com/arut/nginx-rtmp-module
• 集成FFmpeg用于转码和自适应流
• 默认配置：
  • RTMP已启用
  • HLS已启用（自适应，5种变体）
  • DASH已启用
  • 提供其他Nginx配置文件，支持仅RTMP流或无FFmpeg转码模式
• RTMP流统计页面位于http://<服务器IP>:<服务器端口>/stats
• 内置Web视频播放器（基于video.js和https://github.com/video-dev/hls.js/%EF%BC%89%EF%BC%8C%E8%B7%AF%E5%BE%84%E4%B8%BA%60/usr/local/nginx/html/players%60

当前镜像构建信息：

• Nginx 1.17.5（从源代码编译）
• Nginx-rtmp-module 1.2.1（从源代码编译）
• FFmpeg 4.2.1（从源代码编译）

该镜像基于https://hub.docker.com/r/alqutami/rtmp-hls%E7%9A%84Docker%E9%95%9C%E5%83%8F%E6%9E%84%E5%BB%BA%EF%BC%8CNginx%E7%BC%96%E8%AF%91%E6%97%B6%E8%AE%BE%E7%BD%AENGX_HAVE_INET6=0%E3%80%82

使用场景和适用范围

适用于需要快速搭建视频流媒体服务的场景，包括但不限于：

• 直播流服务（如游戏直播、活动直播）
• 视频点播平台
• 自适应码率流媒体服务
• 教育或企业内部培训视频流

详细的使用方法和配置说明

运行服务器

bash
docker run -d -p 1935:1935 -p 8080:8080 alqutami/rtmp-hls

Alpine版本镜像：

bash
docker run -d -p 1935:1935 -p 8080:8080 alqutami/rtmp-hls:latest-alpine

使用自定义配置文件运行：

bash
docker run -d -p 1935:1935 -p 8080:8080 -v custom.conf:/etc/nginx/nginx.conf alqutami/rtmp-hls

其中custom.conf是自定义的Nginx配置文件。

推流到服务器

• 推流RTMP直播内容至：

  rtmp://<服务器IP>:1935/live/<stream_key>
  

  其中<stream_key>为自定义的流密钥。

• 配置OBS推流：
  进入设置 > 流，选择以下配置：

  • 服务：自定义流媒体服务器
  • 服务器：rtmp://<服务器IP>:1935/live
  • 流密钥：可自定义，默认提供的视频播放器假设流密钥为test

观看流

• 使用VLC：

  • 打开媒体 > 打开网络流
  • 输入流URL：rtmp://<服务器IP>:1935/live/<stream-key> 将<服务器IP>替换为服务器运行的IP，<stream-key>替换为推流时使用的流密钥
  • HLS和DASH流的URL格式分别为： http://<服务器IP>:8080/hls/<stream-key>.m3u8 和 http://<服务器IP>:8080/dash/<stream-key>_src.mpd
  • 点击播放

• 使用内置Web播放器：
  内置演示播放器假设流密钥为test且在本地主机打开：

  • 播放RTMP内容（需Flash支持）：http://localhost:8080/players/rtmp.html
  • 播放HLS内容：http://localhost:8080/players/hls.html
  • 使用hls.js库播放HLS内容：http://localhost:8080/players/hls_hlsjs.html
  • 播放DASH内容：http://localhost:8080/players/dash.html
  • 同时播放RTMP和HLS内容：http://localhost:8080/players/rtmp_hls.html

  注意：

  • 这些Web播放器硬编码为播放本地主机上的"test"流密钥
  • 如需修改播放器的流源，可下载HTML文件并修改视频标签中的src属性，然后通过以下方式挂载修改后的文件到容器：

    bash
    docker run -d -p 1935:1935 -p 8080:8080 -v custom_players:/usr/local/nginx/html/players alqutami/rtmp-hls
    

    其中custom_players是存放修改后HTML文件的目录。

版权

采用MIT许可证发布。

更多信息

• GitHub仓库：https://github.com/TareqAlqutami/rtmp-hls-server.git
• Docker Hub镜像：https://hub.docker.com/r/alqutami/rtmp-hls