thiagoeolima/nginx-rtmps

nginx-rtmps

Docker镜像，基于Nginx，集成https://github.com/arut/nginx-rtmp-module%E6%A8%A1%E5%9D%97%E7%94%A8%E4%BA%8E%E6%B5%81%E4%BC%A0%E8%BE%93%EF%BC%8C%E4%BB%A5%E5%8F%8AStunnel%E6%8F%90%E4%BE%9BTLS%E5%8A%A0%E5%AF%86%E5%8A%9F%E8%83%BD%E3%80%82

镜像概述

该Docker镜像可用于创建RTMP服务器，实现多媒体/视频流传输，基于Nginx、nginx-rtmp-module和Stunnel构建，使用当前最新源码（Nginx 1.18.0、nginx-rtmp-module 1.2.1和Stunnel 4）。

此镜像的开发受到其他类似镜像（如tiangolo、dvdgiessen、jasonrivers、aevumdecessus的镜像）以及OBS Studio帖子的启发。其主要用途（和测试场景）是允许从OBS Studio同时流式传输到不同客户端。

GitHub仓库：https://github.com/thiagoeolima/nginx-rtmps

Docker Hub镜像：https://hub.docker.com/r/thiagoeolima/nginx-rtmps/

核心功能与特性

• 基于Nginx构建的RTMP服务器，支持实时视频流传输
• 集成nginx-rtmp-module模块，提供专业流处理能力
• 包含Stunnel组件，支持TLS加密，增强传输安全性
• 支持多平台推流（、、***、Kick、Instagram等）
• 可通过环境变量灵活配置推流参数
• 支持IPv6网络，监听IPv6地址

使用场景

• 搭建私有RTMP服务器，实现视频流的接收与分发
• 从OBS Studio等推流软件同时向多个平台（如***、***）推流
• 需要TLS加密的安全视频流传输场景
• 开发和测试视频流应用

使用方法

基本使用

最简单的情况，直接运行容器：

bash
docker run -it -p 1935:1935 --name nginx-rtmps thiagoeolima/nginx-rtmps

推流到特定平台

和

bash
docker run -it -p 1935:1935 -e FACEBOOK_KEY="<key>" -e YOUTUBE_KEY=<key> thiagoeolima/nginx-rtmps

Cloudflare

bash
docker run -it -p 1935:1935 -e CLOUDFLARE_KEY="<key>" thiagoeolima/nginx-rtmps

***

bash
docker run -it -p 1935:1935 -e TWITCH_URL="rtmp://<url>" -e TWITCH_KEY="<key>" thiagoeolima/nginx-rtmps

Kick

bash
docker run -it -p 1935:1935 -e KICK_KEY="<key>" thiagoeolima/nginx-rtmps

OBS推流配置

OBS中设置推流URL为：

bash
rtmp://localhost:1935/live

Instagram

bash
docker run -it -p 1935:1935 -e INSTAGRAM_KEY=<key> thiagoeolima/nginx-rtmps

OBS中设置推流URL为：

bash
rtmp://localhost:1935/instagram

使用OBS Studio测试

1. 使用上述命令运行容器
2. 打开OBS Studio
3. 点击"设置"按钮
4. 进入"流"部分
5. "流类型"选择"自定义流媒体服务器"
6. "URL"中输入rtmp://<主机IP>/live，将<主机IP>替换为容器运行所在主机的IP，例如：rtmp://192.168.0.30/live
7. "流密钥"使用后续客户端URL中用于显示特定流的密钥，例如：test
8. 点击"确定"按钮
9. 在"来源"部分点击"+"按钮添加来源（如"屏幕捕获"）并配置
10. 点击"开始推流"按钮

调试

若出现问题，可通过以下命令查看容器日志：

bash
docker logs nginx-rtmps

扩展配置

如需修改配置，可创建自定义nginx.conf文件，并通过基于此镜像的Dockerfile替换原有配置，例如：

Dockerfile
FROM thiagoeolima/nginx-rtmps

COPY nginx.conf /etc/nginx/nginx.conf

当前默认的nginx.conf内容如下：

Nginx
worker_processes auto;
rtmp_auto_push on;
rtmp_auto_push_reconnect 1s;
events {}
rtmp {
    server {
        listen 1935;
        listen [::]:1935 ipv6only=on;
        chunk_size 4096;

        application live {
            live on;
            record off;

        #-***
        #push rtmp://a.rtmp.***.com/live2/<key>;
        #-***;
        #push rtmp://127.0.0.1:***/rtmp/<key>;
        #-Instagram;
        #push rtmp://127.0.0.1:***/rtmp/<key>;
        #-Cloudflare
        #push rtmp://127.0.0.1:***/live/<key>;
        #-Kick
        #push rtmp://127.0.0.1:***/kick/<key>;
        }
        
        application instagram {
            live on;
            record off;
            
            #-Instagram;
            #push rtmp://127.0.0.1:***/rtmp/<key>;
        }

    }

}