MediaMTX 快速上手指南如何 5 分钟搭好一个全协议实时流媒体服务器【免费下载链接】mediamtxReady-to-use Media-over-QUIC / SRT / WebRTC / RTSP / RTMP / LL-HLS / MPEG-TS / RTP live media server and media proxy that allows to read, publish, proxy, record and playback real-time video and audio streams.项目地址: https://gitcode.com/GitHub_Trending/me/mediamtxMediaMTX 是一个开箱即用的实时流媒体服务器与媒体代理支持通过 RTSP、RTMP、WebRTC、SRT、LL-HLS、MPEG-TS、RTP 等协议发布、读取、录制和回放音视频流。本文带你了解它的核心能力并走通从部署到看到画面的最短路径帮你在 5 分钟内把一路 RTSP 摄像头变成网页可播的实时画面。 这些流媒体痛点你可能都遇到过安防摄像头的画面走 RTSP 协议老板却要求在网页上实时看OBS 推流走 RTMP但移动端用户需要 WebRTC 级别的低延迟会议室的直播流又要同步存档、支持回看。传统做法是分别部署多台服务器中间再加协议转换和转码组件——部署复杂、链路变长、延迟叠加。问题的本质是每一对协议之间都需要一次翻译。 MediaMTX 是什么一台拿起来就能用的媒体路由器一句话定位MediaMTX 把不同协议的流汇聚到同一个路径上任意一端进、任意一端出自动完成协议转换。就像家庭路由器把不同设备连进同一个局域网它让摄像头、推流软件、网页播放器说同一种话。它对使用者的直接好处单文件零依赖用 Go 编写编译后就是一个可执行文件Linux、Windows、macOS 直接跑不需要装任何运行时协议覆盖全发布端支持 Media-over-QUIC、SRT、WebRTC、RTSP、RTMP、HLS、MPEG-TS、RTP读取端覆盖主流播放协议自动协议转换用 RTSP 发布就能用 WebRTC 读取全程不转码流可存可放内置录制fMP4/MPEG-TS与回放服务生产级配套内部/HTTP/JWT 三种认证、Control API、Prometheus 指标、配置热重载 能力拆解它到底能替你做什么多协议进出省掉一整排转换服务器解决什么问题上下游设备协议不一致以前要为每对协议搭转换链路。你实际得到一个路径名如mystream同时对应 RTSP、RTMP、WebRTC、HLS 等多个出口谁来读都能拿到画面且因为不转码没有额外画质损失和延迟。录制 回放一套配置两件事解决什么问题直播要留档但录制和回放常常是两套系统。你实际得到在mediamtx.yml里对路径设record: yes流就按小时切成 fMP4 或 MPEG-TS 分段落到./recordings/再开启playback: yes即可通过专用 HTTP 端口默认:9996列出时间区间、下载回放fMP4 格式还能直接塞进浏览器video标签。细节见 docs/2-features/09-record.md 和 docs/2-features/10-playback.md。配置热重载改配置不断流解决什么问题生产环境改配置总要挑凌晨低峰期重启。你实际得到运行中直接改写mediamtx.ymlMediaMTX 检测到变化后自动应用现有客户端连接不断开。三种改法都支持直接编辑文件、MTX_前缀的环境变量、Control API。钩子脚本 Control API把它嵌进你的系统解决什么问题流上下线、有人观看这类事件没法通知到业务系统。你实际得到每个路径可配置runOnRead、runOnOnline、runOnRecordSegmentComplete等钩子命令配合环境变量如MTX_PATH、MTX_QUERY触发外部脚本服务端状态则可通过:9997端口的 Control API 和:9998的 Prometheus 指标随时查询。️ 工作原理流在 MediaMTX 里怎么流动把 MediaMTX 想成一座立交桥每种协议各有一条进匝道汇入中间的统一媒体流再从任意出匝道分发出去。对应到源码目录各协议的收发实现都在 internal/protocols/如rtsp/、webrtc/、srt/、hls/、moq/各协议的服务端会话管理在 internal/servers/路径调度谁在推、谁在读、如何分发由 internal/core/path_manager.go 负责 快速上手三步看到第一路流第一步启动服务器生产环境推荐 Docker一条命令起服务端口来自 docs/1-kickoff/2-install.mddocker run --rm -it \ -e MTX_RTSPTRANSPORTStcp \ -p 8554:8554 -p 1935:1935 -p 8888:8888 -p 8889:8889 \ -p 8890:8890/udp -p 8189:8189/udp \ bluenviron/mediamtx:1如果你用二进制方式也可以先 clone 仓库git clone https://gitcode.com/GitHub_Trending/me/mediamtx了解全部配置项再下载对应平台的独立二进制终端执行./mediamtx即可。第二步推一路流用 FFmpeg 把本地视频以 RTSP 推到mystream路径ffmpeg -re -stream_loop -1 -i file.mp4 -c copy -f rtsp rtsp://localhost:8554/mystream第三步用任意协议读回来VLC 打开rtsp://localhost:8554/mystream浏览器播放 WebRTC 页面http://localhost:8889/mystream/webrtc/index.html取 HLS 播放列表http://localhost:8888/mystream/index.m3u8同一路推流三种方式都能出画面——这就是协议自动转换的效果。 落地案例三个常见场景怎么用安防监控集中查看需求多个厂区 RTSP 摄像头中心机房集中管理并支持网页实时看。 用法每个厂区部署一个 MediaMTX 接摄像头中心实例用source: srt://...或 RTSP URL 拉取厂区流Web 端通过 WebRTC 路径低延迟查看历史时段用录制 回放服务调取。直播活动多端分发需求主播用 OBS 推 RTMP观众要覆盖网页、App、电视盒子。 用法OBS 推rtmp://服务器:1935/live网页观众走 WebRTC/HLS盒子走 RTSP需要落地的录像直接在路径上开record: yes。物联网视频回传需求边缘设备在网络不稳定的环境下把视频传回云端做分析。 用法边缘用 SRT 发布抗丢包云端 MediaMTX 接收后通过forward配置再转发到分析服务器或用runOnAvailable钩子在流上线时通知后端。 排坑与进阶常见问题与调优建议Docker 里 WebRTC 连不上客户端访问的 IP 不是容器 IP设置-e MTX_WEBRTCADDITIONALHOSTS你的服务器IP或改用--networkhost启动。RTSP over UDP 在 Docker 中异常Docker 网络栈会改写 UDP 包源地址按官方建议设MTX_RTSPTRANSPORTStcp或用 host 网络模式。低延迟 HLS 在 Apple 设备上不播LL-HLS 在苹果设备上要求 HTTPS把hlsEncryption设为true并配置证书。UDP 丢包多调大udpReadBufferSize增大读缓冲网络 MTU 较低时把udpMaxPayloadSize从默认 1452 调小以避免分片。内存占用偏高writeQueueSize默认 512是发包队列调低可省内存调高可提吞吐按需取舍。完整参数含义都在 mediamtx.yml 内逐行有注释可直接对照。 资源与下一步官方文档按入门 → 特性 → 推流 → 拉流组织建议按顺序浏览安装与快速开始docs/1-kickoff/全部特性说明认证、录制、转发、钩子等docs/2-features/各类设备/软件推流指南FFmpeg、OBS、摄像头、浏览器docs/3-publish/拉流播放指南VLC、FFmpeg、浏览器等docs/4-read/配置项参考docs/5-references/1-configuration-file.md给你的下一步建议先按快速上手三步跑通 RTSP 推流 WebRTC 播放建立体感再给一路流开启record: yes和playback: yes体验录制回放闭环最后用runOnRead钩子写个脚本打印观看事件把它接入你自己的业务收尾MediaMTX 的价值在于把多协议流媒体互通这件麻烦事收敛成一个配置文件单文件部署、协议自动转换、录制回放与运维接口一应俱全。如果你正被摄像头协议和播放器协议两头堵不妨现在就拉起一个容器用第一路流验证它——大概率你会发现之前部署的那几台转换服务器都可以撤了。【免费下载链接】mediamtxReady-to-use Media-over-QUIC / SRT / WebRTC / RTSP / RTMP / LL-HLS / MPEG-TS / RTP live media server and media proxy that allows to read, publish, proxy, record and playback real-time video and audio streams.项目地址: https://gitcode.com/GitHub_Trending/me/mediamtx创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 MediaMTX 快速上手指南：如何 5 分钟搭好一个全协议实时流媒体服务器
MediaMTX 快速上手指南如何 5 分钟搭好一个全协议实时流媒体服务器【免费下载链接】mediamtxReady-to-use Media-over-QUIC / SRT / WebRTC / RTSP / RTMP / LL-HLS / MPEG-TS / RTP live media server and media proxy that allows to read, publish, proxy, record and playback real-time video and audio streams.项目地址: https://gitcode.com/GitHub_Trending/me/mediamtxMediaMTX 是一个开箱即用的实时流媒体服务器与媒体代理支持通过 RTSP、RTMP、WebRTC、SRT、LL-HLS、MPEG-TS、RTP 等协议发布、读取、录制和回放音视频流。本文带你了解它的核心能力并走通从部署到看到画面的最短路径帮你在 5 分钟内把一路 RTSP 摄像头变成网页可播的实时画面。 这些流媒体痛点你可能都遇到过安防摄像头的画面走 RTSP 协议老板却要求在网页上实时看OBS 推流走 RTMP但移动端用户需要 WebRTC 级别的低延迟会议室的直播流又要同步存档、支持回看。传统做法是分别部署多台服务器中间再加协议转换和转码组件——部署复杂、链路变长、延迟叠加。问题的本质是每一对协议之间都需要一次翻译。 MediaMTX 是什么一台拿起来就能用的媒体路由器一句话定位MediaMTX 把不同协议的流汇聚到同一个路径上任意一端进、任意一端出自动完成协议转换。就像家庭路由器把不同设备连进同一个局域网它让摄像头、推流软件、网页播放器说同一种话。它对使用者的直接好处单文件零依赖用 Go 编写编译后就是一个可执行文件Linux、Windows、macOS 直接跑不需要装任何运行时协议覆盖全发布端支持 Media-over-QUIC、SRT、WebRTC、RTSP、RTMP、HLS、MPEG-TS、RTP读取端覆盖主流播放协议自动协议转换用 RTSP 发布就能用 WebRTC 读取全程不转码流可存可放内置录制fMP4/MPEG-TS与回放服务生产级配套内部/HTTP/JWT 三种认证、Control API、Prometheus 指标、配置热重载 能力拆解它到底能替你做什么多协议进出省掉一整排转换服务器解决什么问题上下游设备协议不一致以前要为每对协议搭转换链路。你实际得到一个路径名如mystream同时对应 RTSP、RTMP、WebRTC、HLS 等多个出口谁来读都能拿到画面且因为不转码没有额外画质损失和延迟。录制 回放一套配置两件事解决什么问题直播要留档但录制和回放常常是两套系统。你实际得到在mediamtx.yml里对路径设record: yes流就按小时切成 fMP4 或 MPEG-TS 分段落到./recordings/再开启playback: yes即可通过专用 HTTP 端口默认:9996列出时间区间、下载回放fMP4 格式还能直接塞进浏览器video标签。细节见 docs/2-features/09-record.md 和 docs/2-features/10-playback.md。配置热重载改配置不断流解决什么问题生产环境改配置总要挑凌晨低峰期重启。你实际得到运行中直接改写mediamtx.ymlMediaMTX 检测到变化后自动应用现有客户端连接不断开。三种改法都支持直接编辑文件、MTX_前缀的环境变量、Control API。钩子脚本 Control API把它嵌进你的系统解决什么问题流上下线、有人观看这类事件没法通知到业务系统。你实际得到每个路径可配置runOnRead、runOnOnline、runOnRecordSegmentComplete等钩子命令配合环境变量如MTX_PATH、MTX_QUERY触发外部脚本服务端状态则可通过:9997端口的 Control API 和:9998的 Prometheus 指标随时查询。️ 工作原理流在 MediaMTX 里怎么流动把 MediaMTX 想成一座立交桥每种协议各有一条进匝道汇入中间的统一媒体流再从任意出匝道分发出去。对应到源码目录各协议的收发实现都在 internal/protocols/如rtsp/、webrtc/、srt/、hls/、moq/各协议的服务端会话管理在 internal/servers/路径调度谁在推、谁在读、如何分发由 internal/core/path_manager.go 负责 快速上手三步看到第一路流第一步启动服务器生产环境推荐 Docker一条命令起服务端口来自 docs/1-kickoff/2-install.mddocker run --rm -it \ -e MTX_RTSPTRANSPORTStcp \ -p 8554:8554 -p 1935:1935 -p 8888:8888 -p 8889:8889 \ -p 8890:8890/udp -p 8189:8189/udp \ bluenviron/mediamtx:1如果你用二进制方式也可以先 clone 仓库git clone https://gitcode.com/GitHub_Trending/me/mediamtx了解全部配置项再下载对应平台的独立二进制终端执行./mediamtx即可。第二步推一路流用 FFmpeg 把本地视频以 RTSP 推到mystream路径ffmpeg -re -stream_loop -1 -i file.mp4 -c copy -f rtsp rtsp://localhost:8554/mystream第三步用任意协议读回来VLC 打开rtsp://localhost:8554/mystream浏览器播放 WebRTC 页面http://localhost:8889/mystream/webrtc/index.html取 HLS 播放列表http://localhost:8888/mystream/index.m3u8同一路推流三种方式都能出画面——这就是协议自动转换的效果。 落地案例三个常见场景怎么用安防监控集中查看需求多个厂区 RTSP 摄像头中心机房集中管理并支持网页实时看。 用法每个厂区部署一个 MediaMTX 接摄像头中心实例用source: srt://...或 RTSP URL 拉取厂区流Web 端通过 WebRTC 路径低延迟查看历史时段用录制 回放服务调取。直播活动多端分发需求主播用 OBS 推 RTMP观众要覆盖网页、App、电视盒子。 用法OBS 推rtmp://服务器:1935/live网页观众走 WebRTC/HLS盒子走 RTSP需要落地的录像直接在路径上开record: yes。物联网视频回传需求边缘设备在网络不稳定的环境下把视频传回云端做分析。 用法边缘用 SRT 发布抗丢包云端 MediaMTX 接收后通过forward配置再转发到分析服务器或用runOnAvailable钩子在流上线时通知后端。 排坑与进阶常见问题与调优建议Docker 里 WebRTC 连不上客户端访问的 IP 不是容器 IP设置-e MTX_WEBRTCADDITIONALHOSTS你的服务器IP或改用--networkhost启动。RTSP over UDP 在 Docker 中异常Docker 网络栈会改写 UDP 包源地址按官方建议设MTX_RTSPTRANSPORTStcp或用 host 网络模式。低延迟 HLS 在 Apple 设备上不播LL-HLS 在苹果设备上要求 HTTPS把hlsEncryption设为true并配置证书。UDP 丢包多调大udpReadBufferSize增大读缓冲网络 MTU 较低时把udpMaxPayloadSize从默认 1452 调小以避免分片。内存占用偏高writeQueueSize默认 512是发包队列调低可省内存调高可提吞吐按需取舍。完整参数含义都在 mediamtx.yml 内逐行有注释可直接对照。 资源与下一步官方文档按入门 → 特性 → 推流 → 拉流组织建议按顺序浏览安装与快速开始docs/1-kickoff/全部特性说明认证、录制、转发、钩子等docs/2-features/各类设备/软件推流指南FFmpeg、OBS、摄像头、浏览器docs/3-publish/拉流播放指南VLC、FFmpeg、浏览器等docs/4-read/配置项参考docs/5-references/1-configuration-file.md给你的下一步建议先按快速上手三步跑通 RTSP 推流 WebRTC 播放建立体感再给一路流开启record: yes和playback: yes体验录制回放闭环最后用runOnRead钩子写个脚本打印观看事件把它接入你自己的业务收尾MediaMTX 的价值在于把多协议流媒体互通这件麻烦事收敛成一个配置文件单文件部署、协议自动转换、录制回放与运维接口一应俱全。如果你正被摄像头协议和播放器协议两头堵不妨现在就拉起一个容器用第一路流验证它——大概率你会发现之前部署的那几台转换服务器都可以撤了。【免费下载链接】mediamtxReady-to-use Media-over-QUIC / SRT / WebRTC / RTSP / RTMP / LL-HLS / MPEG-TS / RTP live media server and media proxy that allows to read, publish, proxy, record and playback real-time video and audio streams.项目地址: https://gitcode.com/GitHub_Trending/me/mediamtx创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考