alfg/nginx-rtmp

docker-nginx-rtmp

镜像概述

基于Alpine Linux构建的Docker镜像，从源码安装NGINX、nginx-rtmp-module和FFmpeg，默认配置支持HLS直播流。

组件版本

• Nginx 1.23.1（主线版，源码编译）
• nginx-rtmp-module 1.2.2（源码编译）
• ffmpeg 5.1（源码编译）
• 默认HLS配置（详见：nginx.conf）

!Docker Stars !Docker Pulls !Docker Automated build !Build Status

核心功能和特性

• 支持RTMP协议直播推流
• 内置HLS（HTTP Live Streaming）转码和分发
• 集成FFmpeg用于视频处理和转码
• 基于Alpine Linux，镜像体积小
• 支持环境变量配置
• 可自定义NGINX配置
• 可选CUDA硬件加速版本

使用场景

• 个人或小型直播服务器搭建
• 视频流实时转码和分发
• 在线教育、游戏直播等场景的媒体服务
• 开发和测试环境的直播流服务

使用方法

服务器部署

拉取镜像并运行

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

从源码构建并运行

bash
docker build -t nginx-rtmp .
docker run -it -p 1935:1935 -p 8080:80 --rm nginx-rtmp

推流地址

rtmp://localhost:1935/stream/$STREAM_NAME

（将$STREAM_NAME替换为自定义流名称）

SSL配置

要启用SSL，编辑nginx.conf并取消以下行的注释：

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

镜像提供了位于/certs目录的自签名证书用于测试。若在生产环境使用HTTPS，强烈建议获取自己的证书并更新ssl_certificate和ssl_certificate_key路径。推荐使用Let's Encrypt的Certbot工具。

环境变量

该Docker镜像使用envsubst进行环境变量替换。可在nginx.conf中以${var}形式定义变量，并通过docker-compose文件或docker命令传递。

自定义nginx.conf

如需使用自定义配置文件，可通过卷挂载方式将本地nginx.conf作为nginx.conf.template挂载：

yaml
volumes:
  - ./nginx.conf:/etc/nginx/nginx.conf.template

OBS配置

• 流类型：自定义流媒体服务器
• URL：rtmp://localhost:1935/stream
• 流密钥：hello（可替换为自定义名称）

观看直播流

通过浏览器

打开示例hls.js播放器：

http://localhost:8080/player.html?url=http://localhost:8080/live/hello.m3u8

通过HLS播放器

在Safari、VLC或其他HLS播放器中打开：

http://localhost:8080/live/$STREAM_NAME.m3u8

示例播放列表：http://localhost:8080/live/hello.m3u8

其他方式

• HLS.js Player
• FFplay命令：ffplay -fflags nobuffer rtmp://localhost:1935/stream/hello

FFmpeg构建信息

bash
$ ffmpeg -buildconf

ffmpeg version 4.4 Copyright (c) 2000-2021 the FFmpeg developers
  built with gcc 10.2.1 (Alpine 10.2.1_pre1) 20201203
  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-postproc --enable-avresample --enable-libfreetype --enable-openssl --disable-debug --disable-doc --disable-ffplay --extra-libs='-lpthread -lm'
  libavutil      56. 70.100 / 56. 70.100
  libavcodec     58.134.100 / 58.134.100
  libavformat    58. 76.100 / 58. 76.100
  libavdevice    58. 13.100 / 58. 13.100
  libavfilter     7.110.100 /  7.110.100
  libavresample   4.  0.  0 /  4.  0.  0
  libswscale      5.  9.100 /  5.  9.100
  libswresample   3.  9.100 /  3.  9.100
  libpostproc    55.  9.100 / 55.  9.100

  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-postproc
    --enable-avresample
    --enable-libfreetype
    --enable-openssl
    --disable-debug
    --disable-doc
    --disable-ffplay
    --extra-libs='-lpthread -lm'

FFmpeg硬件加速

提供Dockerfile.cuda镜像，支持通过NVIDIA CUDA实现FFmpeg硬件加速。使用标签alfg/nginx-rtmp:cuda：

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

运行此镜像需具备支持的平台和驱动：

• https://github.com/NVIDIA/nvidia-docker
• [***]
• [***]
• [***]

此镜像为实验性版本！

参考资源

• [***] Linux）
• [***]
• https://github.com/arut/nginx-rtmp-module%EF%BC%88nginx-rtmp-module%EF%BC%89
• [***]
• [***] Studio）