eyevinntechnology/toolbox-loopts

eyevinntechnology/toolbox-loopts 镜像说明

镜像概述

eyevinntechnology/toolbox-loopts是一个轻量视频流生成工具镜像，通过循环播放指定MP4文件输出MPEG-TS流至多播地址或SRT端点，主要用于视频流服务的测试、协议兼容性验证及本地模拟场景。

核心功能

• 循环MP4文件生成标准MPEG-TS流
• 支持多播（UDP）和SRT协议输出
• 可自定义帧率、关键帧间隔、视频比特率
• 可选添加本地时间码到视频画面
• 可选插入测试音频轨道
• 支持FLV格式适配RTMP输出场景

使用场景

• 视频流服务的功能测试与性能压测
• 多播/SRT协议的互联互通验证
• IPTV或直播系统的本地模拟环境搭建
• 视频编码参数调整后的效果验证

配置说明

位置参数

• inputfile：输入MP4文件路径（需挂载到容器内可访问目录，如/mnt）
• multicast：目标输出地址（多播地址格式：udp://[ip]:[port]；SRT地址格式：srt://[ip]:[port]）

可选参数

• --workdir WORKDIR：工作目录，默认值为/mnt
• --framerate FRAMERATE：输出帧率，默认25fps
• --kfinterval KFINTERVAL：关键帧间隔，默认2秒
• --bitrate BITRATE：视频比特率（单位：kbps），如2500
• --withtc：在视频画面叠加本地时间码
• --withaudio：添加正弦波测试音频
• --useflv：切换为FLV格式输出（用于RTMP场景）

部署示例

基础多播输出

bash
docker run --rm -v $PWD:/mnt eyevinntechnology/toolbox-loopts input.mp4 udp://239.0.0.1:1234

自定义参数配置

bash
docker run --rm -v $PWD:/mnt eyevinntechnology/toolbox-loopts input.mp4 udp://239.0.0.1:1234 --framerate 30 --bitrate 3000 --kfinterval 3

添加时间码与测试音频

bash
docker run --rm -v $PWD:/mnt eyevinntechnology/toolbox-loopts input.mp4 srt://localhost:5000 --withtc --withaudio

FLV格式RTMP输出

bash
docker run --rm -v $PWD:/mnt eyevinntechnology/toolbox-loopts input.mp4 rtmp://localhost/live/stream --useflv