hidesugihara/srt

SRT媒体流传输Docker镜像

镜像概述

本镜像基于Ubuntu系统，集成SRT（Secure Reliable Transport）协议栈，提供便捷的媒体流发送与接收功能。支持SRT协议的caller和listener模式，可实现UDP与SRT流之间的转换，并提供传输统计功能，适用于需要低延迟、高可靠性的媒体流传输场景。

版本信息

核心功能与特性

• 多模式支持：支持SRT协议的caller（主动连接）和listener（被动监听）模式
• 协议转换：实现UDP流与SRT流之间的双向转换
• 传输统计：生成CSV格式的传输统计数据，保存至/tmp目录
• 灵活配置：通过环境变量自定义传输参数（如比特率、缓冲区大小等）
• 多场景适配：提供针对组播和单播的发送/接收函数

使用场景

• 视频直播流的远距离传输
• 低延迟媒体内容分发
• 跨网络环境的媒体流中继
• 媒体传输性能测试与监控

使用方法

1. 配置环境

将以下函数添加到.bashrc中，以便快速调用镜像功能：

bash
cat<<'EoF' >> ~/.bashrc
#- srt-sender-caller -> srt-receiver-listener -#

tsplay()  { if [[ $# -eq 2 || $# -eq 3 ]] ; then
      docker run ${3:--it} -v /media:/media -e "TS=/media/${1}" -e "DST=${2}  " -e 'OPT=-v -hd' hidesugihara/tsplay
      else echo "tsplay <content-name(must be /media)> <output-destination-address:port> [[-it]|-d]" ; fi }

srt-sender-caller() { if [[ $# -eq 2 || $# -eq 3 ]] ; then
   docker run ${3:--it} --rm --name=srt-sender-caller  -v /tmp:/tmp -e "OPT= -v -r:10000 -f -statsout /tmp/srt-stats-sender-caller-$(date +'%Y-%m-%d-%H%M%S').csv -pf csv -s 2000" -p  ${1#*:}:5001/udp --rm -e "SRC=udp://${1}" -e "DST=srt://${2}?mode=caller&passphrase=secretP@ssw0rd" hidesugihara/srt
   else echo "srt-sender-caller <source-multicast-address:port>  <srt-destination-address:port> [[-it]|-d]" ; fi }
srt-sender-caller-unicast() { if [[ $# -eq 2 || $# -eq 3 ]] ; then
   docker run ${3:--it} --rm --name=srt-sender-caller  -v /tmp:/tmp -e "OPT= -v -r:10000 -f -statsout /tmp/srt-stats-sender-caller-$(date +'%Y-%m-%d-%H%M%S').csv -pf csv -s 2000" -p ${1}:5001/udp --rm -e "SRC=udp://0.0.0.0:5001" -e "DST=srt://${2}?mode=caller&passphrase=secretP@ssw0rd" hidesugihara/srt
   else echo "srt-sender-caller-unicast <source-waiting-port> <srt-destination-address:port> [[-it]|-d]" ; fi }

srt-receiver-listener() { if [[ $# -eq 2 || $# -eq 3 ]] ; then
   docker run ${3:--it} --rm --name=srt-receiver-listener.${1} -v /tmp:/tmp -e "OPT= -v -r:10000 -f -statsout /tmp/srt-stats-receiver-listener-$(date +'%Y-%m-%d-%H%M%S').csv -pf csv -s 2000" -p ${1}:5001/udp -e 'SRC=srt://0.0.0.0:5001?mode=listener&passphrase=secretP@ssw0rd' -e "DST=udp://${2}" hidesugihara/srt
   else echo "srt-receiver-listener <srt-listen-port> <output-multicast-address:port> [[-it]|-d]  (需在安全组或防火墙开放端口)" ; fi }


#- srt-sender-caller <- srt-receiver-listener -#

srt-sender-listener() { if [[ $# -eq 2 || $# -eq 3 ]] ; then
   docker run ${3:--it} --rm --name=srt-sender-listener.${2} -v /tmp:/tmp -e "OPT= -v -r:10000 -f -statsout /tmp/srt-stats-sender-listener-$(date +'%Y-%m-%d-%H%M%S').csv -pf csv -s 2000" -e "SRC=udp://${1}" -p ${2}:6001/udp -e 'DST=srt://0.0.0.0:6001?mode=listener&passphrase=secretP@ssw0rd' hidesugihara/srt
   else echo "srt-sender-listener <source-multicast-address:port> <srt-listen-port> [[-it]|-d]  (需在安全组或防火墙开放端口)" ; fi }

srt-sender-listener-unicast() { if [[ $# -eq 2 || $# -eq 3 ]] ; then
   docker run ${3:--it} --rm --name=srt-sender-listener.${1} -v /tmp:/tmp -e "OPT= -v -r:10000 -f -statsout /tmp/srt-stats-sender-listener-$(date +'%Y-%m-%d-%H%M%S').csv -pf csv -s 2000" -p ${1}:6001/udp -e "SRC=udp://0.0.0.0:6001" -p ${1}:6001/udp -e 'DST=srt://0.0.0.0:6001?mode=listener&passphrase=secretP@ssw0rd' hidesugihara/srt
   else echo "srt-sender-listener-unicast <source-waiting-port> <srt-listen-port> [[-it]|-d]  (需在安全组或防火墙开放端口)" ; fi }

srt-receiver-caller() { if [[ $# -eq 2 || $# -eq 3 ]] ; then
   docker run ${3:--it} --rm --name=srt-receiver-caller -v /tmp:/tmp -e "OPT= -v -r:10000 -f -statsout /tmp/srt-stats-receiver-caller-$(date +'%Y-%m-%d-%H%M%S').csv -pf csv -s 2000" -e "SRC=srt://${1}?mode=caller&passphrase=secretP@ssw0rd" -e "DST=udp://${2}" hidesugihara/srt
   else echo "srt-receiver-caller  <srt-sender-address:port>  <destination-address:port> [[-it]|-d]" ; fi }
EoF

. ~/.bashrc

2. 主要函数说明

3. 环境变量说明

连接示例

示例1：srt-sender-caller -> srt-receiver-listener

1. 播放媒体文件并通过UDP发送：

   bash
   tsplay bbb1080p30.ts 239.255.1.1:5001
   # 从 /media/bbb1080p30.ts 读取（循环播放）
   # 通过UDP连接到 239.255.1.1:5001（组播接口 172.17.0.5）
   # 向 239.255.1.1 写入UDP流
   

2. 发送SRT流（caller模式）：

   bash
   srt-sender-caller 239.255.1.1:5001 Hostname:15001
   # 媒体路径: 'udp://239.255.1.1:5001' --> 'srt://<Hostname>:15001?mode=caller&passphrase=secretP@ssw0rd'
   # 组播: 本地地址: INADDR_ANY:5001
   # 组播(POSIX): 将绑定到IGMP地址: 239.255.1.1
   # 指定的SRT参数:
   #         mode = 'caller'
   #        passphrase = 'secretP@ssw0rd'
   # 正在Hostname:15001上打开SRT目标caller
   # 连接到Hostname:15001
   # SRT目标已连接
   

3. 接收SRT流（listener模式）：

   bash
   srt-receiver-listener 15001 239.255.1.1:5001
   # 媒体路径: 'srt://0.0.0.0:5001?mode=listener&passphrase=secretP@ssw0rd' --> 'udp://239.255.1.1:5001'
   # 指定的SRT参数:
   #         mode = 'listener'
   #        passphrase = 'secretP@ssw0rd'
   # 正在0.0.0.0:5001上打开SRT源listener
   # 在0.0.0.0:5001上绑定服务器...
   # 监听中...
   # 组播: 本地地址: INADDR_ANY:5001
   # 组播(POSIX): 将绑定到IGMP地址: 239.255.1.1
   # 接受连接...
   # 已连接
   # 已接受SRT源连接
   

示例2：srt-sender-listener <- srt-receiver-caller

1. 播放媒体文件并通过UDP发送（同上）：

   bash
   tsplay bbb1080p30.ts 239.255.1.1:5001
   

2. 发送SRT流（listener模式）：

   bash
   srt-sender-listener 239.255.1.1:5001 15001
   # 媒体路径: 'udp://239.255.0.1:5001' --> 'srt://0.0.0.0:5002?mode=listener&passphrase=secretP@ssw0rd'
   # 组播: 本地地址: INADDR_ANY:5001
   # 组播(POSIX): 将绑定到IGMP地址: 239.255.0.1
   # 指定的SRT参数:
   #         mode = 'listener'
   #         passphrase = 'secretP@ssw0rd'
   # 正在0.0.0.0:5002上打开SRT目标listener
   # 在0.0.0.0:5002上绑定服务器...
   # 监听中...
   # 接受连接...
   # 已连接
   

3. 接收SRT流（caller模式）：

   bash
   srt-receiver-caller Hostname:15001 <PC IP地址>:5001
   # 媒体路径: 'srt://Hostname:15001?mode=caller&passphrase=secretP@ssw0rd' --> 'udp://239.255.1.2:5001'
   # 指定的SRT参数:
   #        mode = 'caller'
   #        passphrase = 'secretP@ssw0rd'
   # 正在Hostname:15001上打开SRT源caller
   # 连接到Hostname:15001
   # 组播: 本地地址: INADDR_ANY:5001
   # 组播(POSIX): 将绑定到IGMP地址: 239.255.1.2
   # SRT目标已连接
   

4. 使用VLC播放接收的流：

   VLC
   udp://@:5001