Go2rtc 模块体系详解协议、格式与编解码能力矩阵【免费下载链接】go2rtcUltimate camera streaming application项目地址: https://gitcode.com/GitHub_Trending/go/go2rtc本篇基于 go2rtc 仓库中的 internal/README.md 文档展开系统讲解 go2rtc 的“模块module/ 格式format/ 协议protocol”三层概念模型、FFmpeg 对齐的命名规范以及覆盖全部 50 个模块的完整能力矩阵。读完后你将能够准确判断任意一个 go2rtc 模块能否作为流输入input、流输出output、流 ingest 或双向音频two-way并结合 pkg/core 中的核心接口理解这些能力的源码级实现。一、三层概念模型Modules、Formats、Protocolsgo2rtc 内部把“接入一路视频/音频流”这件事拆成了三个正交的层次这也是 internal/README.md 的核心主张Modules模块实现具体通信 API——授权方式authorization、加密encryption、命令集command set、媒体报文结构structure of media packets。比如 RTSP 模块实现了 RTSP 信令握手与鉴权ONVIF 模块实现了 SOAP 命令集Wyze 模块实现了 tutk 私有协议的登录与取流。Formats格式描述被传输数据本身的结构即容器与编码层。比如mpegts、mp4、flv、adts、mjpeg、srtp。Protocols协议负责数据传输的承载方式比如rtsp、http、tcp、udp、ws、webrtc、ioctl。一个典型的接入路径是模块按协议建连 → 按格式解析数据 → 交给内部核心按 RTP 化的节点树分发。三层解耦正是 go2rtc 能用同一套核心处理几十种设备私有协议的基础。命名规范对齐 FFmpeginternal/README.md 开篇就声明了命名原则go2rtc 尽量用 FFmpeg 中的命名方式来称呼格式、协议和编解码器。部分格式和协议是 go2rtc 独占支持的在 FFmpeg 中没有对应物。这意味着如果你熟悉 FFmpeg 的-f、-c参数体系可以直接把矩阵表中的 format如mpegts、yuv4mpegpipe、adts与 FFmpeg 的 muxer/demuxer 名称对上号无需二次学习。go2rtc 独有的部分如tutk、cs2这类设备私有协议或hap这类 HomeKit 协议则按其自身实现命名。二、四类特殊模块矩阵表之外的几段文字internal/README.md 对若干“不属于常规协议模块”的模块做了单独说明这里完整继承并逐条解释1. 接收流链接的模块echo、expr、hass、onvifecho、expr、hass、onvif四个模块接收的是一个流链接link to a stream而非固定协议的直连地址它们在解析前并不知道最终会用什么协议取流。以 echo 模块 为例它执行一段 shell/python 脚本把脚本打印出来的字符串当作真正的源地址streams: apple_hls: echo:python3 hls.py https://developer.apple.com/streaming/examples/basic-stream-osx-ios5.html脚本内部可以先请求 HTML 页面、正则提取出 m3u8 地址再打印ffmpeg:https://...#videocopy交给 ffmpeg 模块转接——也就是说 echo/expr 是“动态寻址层”最终协议由被解析出的链接前缀决定。expr模块同理用表达式语言做地址拼装与条件选择hass模块从 Home Assistant 实体中查出流地址onvif通过 SOAP 协议向设备动态查询 RTSP 取流 URL如ProfileToken换 URL因此矩阵中它们的 formats/protocols 一栏标注为*任意/取决于被解析链接。2. 多格式模块exec 与 ffmpegexec与ffmpeg模块支持多种格式能力上与http模块完全对等矩阵中 formats 列同样标*。ffmpeg 模块通过子进程调用本机 FFmpeg把其输出pipe 或回推 RTSP交给 go2rtcexec 模块则执行任意命令并把其 stdout 当作数据流。两者的 protocols 列标注为pipe、rtsp即数据要么走管道回传要么由 FFmpeg 以 RTSP 形式推回 go2rtc 的 ingest 端口。3. 支撑模块supporting modulesapi、app、debug、ngrok、pinggy、srtp、streams属于支撑性模块不直接出现在流地址前缀中但构成整个系统的运行骨架app 模块解析命令行参数-c/--config配置文件、-d/--daemon守护模式、-v/--version版本查询加载 YAML/JSON 配置并输出启动日志见 internal/app/app.gostreams 模块流命名空间管理负责解析streams:配置、创建 Stream 对象、调度 publish/preload见 internal/streams/streams.goapi 模块对外暴露 HTTP/WebSocket API 与 WebUIngrok/pinggy把本地流以隧道方式暴露到公网srtpSRTP 加密传输的底层支撑debug日志级别调整等运行时诊断。三、完整模块能力矩阵下表完整继承自 internal/README.md列含义formats模块内部解析/生成的数据格式-表示模块只做信令取流数据格式随设备而定protocols模块使用的传输协议*表示取决于被解析出的链接input可否作为流的输入源取流output可否作为流的输出端对外提供流ingest可否接收外部推流如 ffmpeg 推 RTSPtwo-way是否支持双向音频backchannel。moduleformatsprotocolsinputoutputingesttwo-wayalsapcmioctlyesbubble-httpyesdoorbirdmulawhttpyesyesdvrip-tcpyesyesecho**yeseseecloudrtphttpyesexec*pipe,rtspyesyesexpr**yesffmpeg*pipe,rtspyesflussonicmp4wsyesgoprompegtsudpyeshass**yeshlsmpegts,mp4httpyeshomekitsrtphapyesyesnohttpadtshttp,tcpyeshttpflvhttp,tcpyeshttph264http,tcpyeshttphevchttp,tcpyeshttphlshttp,tcpyeshttpmjpeghttp,tcpyeshttpmpjpeghttpyeshttpmpegtshttp,tcpyeshttpwavhttp,tcpyeshttpyuv4mpegpipehttp,tcpyesisapialaw,mulawhttpyesivideonmp4wsyeskasah264,mulawhttpyesmjpegasciihttpyesmjpegjpeghttpyesmjpegmpjpeghttpyesyesmjpegyuv4mpegpipehttpyesmp4mp4http,wsyesmpegadtshttpyesmpegmpegtshttpyesyesmultitransrtptcpyesnestsrtprtsp,webrtcyesnoonvifrtp*yesyesringsrtpwebrtcyesyesroborocksrtpwebrtcyesyesrtmpflvrtmpyesyesyesrtmpflvhttpyesyesrtsprtsprtspyesyesyesyestapompegtshttpyesyestuyasrtpwebrtcyesyesv4l2rawvideoioctlyeswebrtcsrtpwebrtcyesyesyesyeswebtorrentsrtpwebrtcyesyeswyomingpcmtcpyeswyze-tutkyesyesxiaomi-cs2,tutkyesyesyandexsrtpwebrtcyes注原文档中wyoming模块的引用链接误写为 wyze 目录此处已按仓库实际目录修正为 internal/wyoming/README.md。几个值得注意的规律能力最全的是rtsp和webrtc两者 input/output/ingest/two-way 四项全开。以 RTSP 模块 为例它同时提供 RTSP client取流、RTSP server对外rtsp://host:8554/{stream}提供流、ingestffmpeg -f rtsp rtsp://localhost:8554/camera1推流和双向音频配置示例见 internal/rtsp/README.mdstreams: sonoff_camera: rtsp://rtsp:12345678192.168.1.123/av_stream/ch0 unifi_camera: rtspx://192.168.1.123:7441/fD6ouM72bWoFijxK纯输出模块hls、mjpeg、mp4、mpeg没有 input 列标记——它们是“把已有流转换成某种格式对外吐出”的服务端模块如mjpeg输出mpjpegmp4输出 HTTP/WS 的 MP4 分片。双向音频模块doorbird、dvrip、exec、isapi、multitrans、ring、roborock、rtsp、tapo、tuya、webrtc、wyze、xiaomi。其中homekit与nest明确标no说明这两个私有协议栈在 go2rtc 中不支持 backchannel。设备私有协议集中在 webrtc 家族nest、ring、roborock、tuya、yandex全部走srtpwebrtc而 Wyze/小米走更底层的tutk/cs2私有传输formats 列为-数据格式随设备而定。四、能力矩阵背后的源码结构矩阵中 input/output 两列的差异在源码中对应 pkg/core/core.go 定义的两个核心接口Producer接口input 侧实现GetMedias()返回媒体描述视频/音频方向为recvonly、GetTrack(media, codec)获取 RTP 接收器、Start()/Stop()生命周期管理Consumer接口output 侧实现GetMedias()方向为sendonly与AddTrack(media, codec, track)接收 RTP 包。因此矩阵中 inputyes 的模块如 internal/rtsp、internal/wyze其pkg/层实现都实现了 Producer 接口outputyes 的模块如 internal/mjpeg、internal/mp4实现 Consumer 接口两侧都有的模块rtsp、webrtc、rtmp、homekit、onvif则在pkg/目录下同时存在 client 与 server 两个实现文件例如 pkg/rtsp/client.go 与 pkg/rtsp/server.go、pkg/rtmp/client.go 与 pkg/rtmp/server.go。internal/ 与 pkg/ 的分层从目录结构看internal/下每个模块是“面向用户的接入层”解析 URL 参数、读写配置、注册 API 路由pkg/下对应目录是“纯协议/格式实现层”编解码、报文解析、状态机。以 RTSP 为例internal/rtsp/rtsp.go 负责把rtsp://...#transportws这类带选项的 URL 交给 pkg/rtsp 完成建连再以 wyze 为例internal/wyze 负责设备发现与凭据处理pkg/wyze 实现 tutk 协议会话。流与模块的装配发生在 internal/streams/streams.goInit()读取streams:配置段为每个名字创建 Stream并在 1 秒后按配置执行publish把流发布到输出端与preload预取流。当 internal/streams/streams.go 的New()校验源地址时会调用HasProducer(source)判断该 URL 前缀是否有模块认领——这就是“矩阵 input 列”在运行时的体现只有注册了 Producer 的模块前缀才能作为源。媒体流的内部表示无论外层模块用什么协议/格式进入核心后都归一为 RTP 化的节点树pkg/core/node.go 中Node即 Receiver/Sender/Filter 三种角色之一通过AppendChild/RemoveChild组成树Close()时自下而上级联关闭。编解码器常量统一定义在 pkg/core/core.goCodecH264、CodecJPEG、CodecOpus、CodecPCMU等payload type 以注释标明如 JPEG26、PCMU0这与矩阵中 formats 列的取值srtp、pcm、mulaw…一一呼应。五、如何按矩阵选型结合 internal/README.md 的矩阵与实际配置常见决策路径已知设备/协议直接查矩阵对应行确认输入输出能力。例如 Tapo 摄像头用tapo:前缀mpegtsoverhttp支持双向音频小米设备用xiaomi:cs2/tutk私有协议支持双向音频。动态/脚本化地址用echo:或expr:先解析出真实链接被解析结果可以带ffmpeg:、rtsp:等任意已支持前缀。需要转换格式或转码用ffmpeg:源接入pipe/rtsp回传格式任意ffmpeg 模块文档 中有完整参数说明。对外提供流确认目标格式的 output 模块存在rtsp、rtmp、webrtc、hls、mjpeg、mp4、mpeg、hls等在publish:配置段声明即可见 internal/streams/README.md。推流给 go2rtc只挑 ingestyes 的端点实践中主要是 RTSP 服务rtsp://localhost:8554/{stream}、RTMP 与mjpeg:mpjpeg。六、小结internal/README.md 用一张能力矩阵把 go2rtc 的几十个模块收敛到统一的分析框架中模块负责“怎么连上设备”格式描述“数据长什么样”协议决定“数据走哪条路”而 input/output/ingest/two-way 四列则精确界定了每个模块在流媒体管道中的位置。配合 pkg/core 的 Producer/Consumer 接口与 Node 树实现这张矩阵不仅是文档更是对代码结构的直接映射——读懂它就拿到了 go2rtc 扩展与选型能力的总地图。【免费下载链接】go2rtcUltimate camera streaming application项目地址: https://gitcode.com/GitHub_Trending/go/go2rtc创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考