vallahaye/nginx-rtmp

NGINX RTMP 镜像文档

镜像概述和主要用途

本镜像为包含NGINX RTMP模块的NGINX构建版本，专门用于提供基于RTMP协议的流媒体服务。支持直播流接收、转发、录制等功能，适用于构建直播服务器、多平台推流转发服务等场景。

核心功能和特性

• 集成NGINX RTMP模块，支持RTMP协议流媒体处理
• 提供多种版本变体：Mainline/Stable分支、Debian/Alpine基础镜像、有无Perl支持
• 支持多架构：amd64、arm32v5、arm32v6、arm32v7、arm64v8、i386、mips64le、ppc64le、s390x
• 可通过自定义配置实现直播、转发、录制等复杂流媒体功能

支持的标签及Dockerfile链接

• https://github.com/vallahaye/docker-nginx-rtmp/blob/master/mainline/debian/Dockerfile
• https://github.com/vallahaye/docker-nginx-rtmp/blob/master/mainline/debian-perl/Dockerfile
• https://github.com/vallahaye/docker-nginx-rtmp/blob/master/mainline/alpine/Dockerfile
• https://github.com/vallahaye/docker-nginx-rtmp/blob/master/mainline/alpine-perl/Dockerfile
• https://github.com/vallahaye/docker-nginx-rtmp/blob/master/stable/debian/Dockerfile
• https://github.com/vallahaye/docker-nginx-rtmp/blob/master/stable/debian-perl/Dockerfile
• https://github.com/vallahaye/docker-nginx-rtmp/blob/master/stable/alpine/Dockerfile
• https://github.com/vallahaye/docker-nginx-rtmp/blob/master/stable/alpine-perl/Dockerfile

使用方法和配置说明

运行简单的转发广播服务

创建NGINX配置文件nginx.conf：

nginx
load_module modules/ngx_rtmp_module.so;

user nginx;
worker_processes auto;

error_log /var/log/nginx/error.log warn;
pid /var/run/nginx.pid;

events {
  worker_connections 1024;
}

rtmp {
  access_log /var/log/nginx/access.log;
  server {
    listen 1935;
    listen [::]:1935 ipv6only=on;
    application live {
      live on;
      record off;
      push rtmp://live.twitch.tv/app/[streamkeyfromtwitch];  # Twitch推流地址
      push rtmp://a.rtmp.youtube.com/live2/[streamkeyfromyoutube];  # YouTube推流地址
    }
  }
}

使用以下命令运行容器（挂载配置文件）：

console
$ docker run --name some-nginx -v $(pwd)/nginx.conf:/etc/nginx/nginx.conf:ro -d vallahaye/nginx-rtmp

或者，通过Dockerfile构建包含配置的新镜像（推荐）：

dockerfile
FROM vallahaye/nginx-rtmp
COPY nginx.conf /etc/nginx/nginx.conf

构建并运行：

console
$ docker build -t nginx-rtmp-forward-broadcast .
$ docker run --name some-nginx -d nginx-rtmp-forward-broadcast

暴露外部端口

如需从外部访问RTMP服务，需映射1935端口：

console
$ docker run --name some-nginx -d -p 1935:1935 nginx-rtmp-forward-broadcast

此时可通过rtmp://host-ip/live在流媒体软件中访问服务。

使用OBS Studio和VLC测试默认配置

1. 启动容器：

console
$ docker run --name some-nginx --rm -d -p 1935:1935 vallahaye/nginx-rtmp

2. 配置OBS Studio：

   • 打开OBS Studio，进入"设置" > "流"
   • 服务选择"自定义..."
   • 服务器输入rtmp://host-ip/live（替换host-ip为容器所在主机IP）
   • 流密钥输入自定义值（如test）
   • 添加"显示捕获"源，点击"开始推流"

3. 配置VLC播放流：

   • 打开VLC，进入"媒体" > "打开网络流"
   • 输入rtmp://host-ip/live/stream-key（替换host-ip和stream-key为上述设置的值）
   • 点击"播放"，即可观看OBS推流内容

复杂配置

有关高级配置示例，请参考：

• https://github.com/arut/nginx-rtmp-module/wiki
• https://hub.docker.com/_/nginx

镜像变体

nginx-rtmp:<version>

默认镜像，基于Debian系统，适合大多数场景。可作为临时容器使用，也可作为基础镜像构建其他镜像。

nginx-rtmp:<version>-alpine

基于Alpine Linux的镜像，体积更小（约5MB基础镜像），适合对镜像大小有严格要求的场景。使用musl libc替代glibc，部分依赖glibc的软件可能存在兼容性问题。通常不包含额外工具（如git、bash），需在Dockerfile中自行安装所需依赖。

许可证信息

本镜像包含软件的许可证信息请查看https://github.com/arut/nginx-rtmp-module/blob/master/LICENSE%E3%80%82

与所有Docker镜像一样，本镜像可能包含其他软件，这些软件可能具有不同的许可证（如基础发行版中的Bash等）。使用本镜像时，用户有责任确保其使用符合所有包含软件的相关许可证要求。

快速参考

• 维护者：https://github.com/vallahaye/docker-nginx-rtmp
• 问题提交：https://github.com/vallahaye/docker-nginx-rtmp/issues
• 支持架构：amd64, arm32v5, arm32v6, arm32v7, arm64v8, i386, mips64le, ppc64le, s390x
• 描述来源：https://github.com/vallahaye/docker-nginx-rtmp/tree/master