aricodes/nginx-rtmp

aricodes/nginx-rtmp镜像说明

与tiangolo/nginx-rtmp-docker的差异

• 使用更新版本的Nginx构建
• 使用支持HLS时间戳的nginx-rtmp插件分支
• 支持32位和64位arm架构

支持的标签及对应Dockerfile链接

• https://github.com/aricodes-oss/nginx-rtmp-docker/blob/master/Dockerfile

注意：存在按构建日期命名的标签（如aricodes/nginx-rtmp:latest-2020-08-16），可用于固定镜像版本。

镜像概述

该Docker镜像基于Nginx和nginx-rtmp模块构建，用于实现直播多媒体（视频）流传输。使用最新源码构建（Nginx 1.21.4及nginx-rtmp-module 1.2.4），支持从OBS Studio推流并向多个客户端分发流。

核心功能

1. 接收RTMP直播流并向多客户端分发
2. 支持OBS Studio推流和VLC播放器接收
3. 兼容arm32/64位架构
4. 可自定义Nginx配置
5. 包含自动推送和动态工作进程数配置

使用场景

• 个人或小型团队搭建私有直播服务器（如游戏直播、教育课程直播、线下活动直播）
• 测试直播流传输方案
• 学习RTMP流媒体技术

配置说明

基础部署

运行容器的最简命令：

bash
docker run -d -p 1935:1935 --name nginx-rtmp aricodes/nginx-rtmp

OBS Studio推流测试

1. 运行上述容器
2. 打开OBS Studio，进入设置→流
3. 流类型选择自定义流媒体服务器
4. URL填写rtmp://<主机IP>/live（替换<主机IP>为容器所在主机IP）
5. 流密钥填写自定义密钥（如test）
6. 添加推流源（如屏幕捕获）并点击开始推流

VLC接收测试

1. 打开VLC播放器，进入媒体→打开网络串流
2. 输入URL rtmp://<主机IP>/live/<流密钥>（替换<主机IP>和<流密钥>）
3. 点击播放即可观看直播

日志查看

若出现问题，可查看容器日志：

bash
docker logs nginx-rtmp

自定义配置

如需修改Nginx配置，可创建nginx.conf并通过Dockerfile替换：

Dockerfile
FROM aricodes/nginx-rtmp
COPY nginx.conf /etc/nginx/nginx.conf

默认nginx.conf内容：

nginx
worker_processes auto;
rtmp_auto_push on;
events {}
rtmp {
    server {
        listen 1935;
        listen [::]:1935 ipv6only=on;

        application live {
            live on;
            record off;
        }
    }
}

技术细节

• 基于debian和buildpack-deps基础镜像，与多数官方镜像（如Python、Node）共享基础层
• 从Nginx和nginx-rtmp-module官方源码构建，无额外冗余组件
• 默认配置支持多流推送和多客户端接收

许可证

本项目采用MIT许可证，详情见项目仓库。