andrewc248/docker-nginx-rtmp-fork

docker-nginx-rtmp

镜像概述

docker-nginx-rtmp是一个基于Alpine Linux的Docker镜像，从源码编译安装NGINX、nginx-rtmp-module和FFmpeg，默认配置用于HLS（HTTP Live Streaming）直播流服务。该镜像提供了开箱即用的直播流解决方案，适合快速部署直播服务器。

核心组件版本

• Nginx 1.16.1（稳定版，从源码编译）
• nginx-rtmp-module 1.2.1（从源码编译）
• FFmpeg 4.2.1（从源码编译）

核心功能和特性

• 支持RTMP协议直播流接收与分发
• 内置HLS协议转换，支持主流HLS播放器
• 集成FFmpeg，支持视频转码和格式处理
• 基于Alpine Linux，镜像体积小，资源占用低
• 默认配置优化，可直接用于直播场景

使用场景

• 个人或小型团队搭建直播服务器
• 视频监控流实时分发
• 在线教育、游戏直播等实时内容传输
• 视频流转码与多平台分发

使用方法

服务器部署

方法1：拉取镜像并运行

bash
docker pull alfg/nginx-rtmp
docker run -it -p 1935:1935 -p 8080:80 --rm alfg/nginx-rtmp

方法2：从源码构建并运行

bash
# 克隆源码仓库（假设已获取源码）
git clone https://github.com/alfg/docker-nginx-rtmp.git
cd docker-nginx-rtmp

# 构建镜像
docker build -t nginx-rtmp .

# 运行容器
docker run -it -p 1935:1935 -p 8080:80 --rm nginx-rtmp

推流地址

向服务器推送直播流的地址格式：

rtmp://<服务器IP>:1935/stream/$STREAM_NAME

其中$STREAM_NAME为自定义流名称（如"live123"）。

SSL配置

默认配置未启用SSL，如需启用HTTPS，需修改nginx.conf并取消以下行的注释：

nginx
listen 443 ssl;
ssl_certificate     /opt/certs/example.com.crt;
ssl_certificate_key /opt/certs/example.com.key;

镜像中提供了位于/certs目录的自签名证书，仅供测试使用。生产环境强烈建议使用正式证书，推荐通过Let's Encrypt的Certbot工具获取免费SSL证书，并更新ssl_certificate和ssl_certificate_key的路径。

OBS配置

使用OBS Studio推流时，配置如下：

• 流类型：自定义流媒体服务器
• URL：rtmp://localhost:1935/stream（将localhost替换为实际服务器IP）
• 流密钥：hello（可自定义，需与观看地址中的流名称一致）

观看直播流

HLS播放器

在Safari、VLC或其他支持HLS的播放器中，打开以下地址：

http://<服务器IP>:8080/live/$STREAM_NAME.m3u8

示例：http://localhost:8080/live/hello.m3u8（假设流名称为"hello"）

VideoJS播放器

可使用https://video-dev.github.io/hls.js/stable/demo/?src=http%3A%2F%2Flocalhost%3A8080%2Flive%2Fhello.m3u8%E7%9B%B4%E6%8E%A5%E6%92%AD%E6%94%BEHLS%E6%B5%81%E3%80%82

FFplay

通过FFmpeg的ffplay工具播放RTMP流：

bash
ffplay -fflags nobuffer rtmp://localhost:1935/stream/hello

FFmpeg构建信息

镜像中的FFmpeg编译配置如下：

ffmpeg version 4.2.1 Copyright (c) 2000-2019 the FFmpeg developers
  built with gcc 6.4.0 (Alpine 6.4.0)
  configuration: --prefix=/usr/local --enable-version3 --enable-gpl --enable-nonfree --enable-small --enable-libmp3lame --enable-libx264 --enable-libx265 --enable-libvpx --enable-libtheora --enable-libvorbis --enable-libopus --enable-libfdk-aac --enable-libass --enable-libwebp --enable-librtmp --enable-postproc --enable-avresample --enable-libfreetype --enable-openssl --disable-debug --disable-doc --disable-ffplay --extra-libs='-lpthread -lm'
  libavutil      56. 31.100 / 56. 31.100
  libavcodec     58. 54.100 / 58. 54.100
  libavformat    58. 29.100 / 58. 29.100
  libavdevice    58.  8.100 / 58.  8.100
  libavfilter     7. 57.100 /  7. 57.100
  libavresample   4.  0.  0 /  4.  0.  0
  libswscale      5.  5.100 /  5.  5.100
  libswresample   3.  5.100 /  3.  5.100
  libpostproc    55.  5.100 / 55.  5.100

资源链接

• Alpine Linux
• NGINX官方网站
• https://github.com/arut/nginx-rtmp-module
• FFmpeg官方网站
• OBS Studio