MediaMTX快速上手：一个零依赖服务器，三步接入六路流媒体协议

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/mediamtxMediaMTX 是一个开箱即用的零依赖直播媒体服务器与媒体代理用单个可执行文件就能发布、读取、录制和回放 RTSP、RTMP、WebRTC、HLS、SRT、MoQ 协议的音视频流并自动完成协议之间的转换。想接一路摄像头给多个播放器同时看它是目前最短的实现路径。 一分钟看懂MediaMTX 是什么、适合谁MediaMTX 的定位是媒体路由器一路流从某个协议进来它负责分发给所有协议、所有读者。角色用它做什么安防/监控工程师把 RTSP 摄像头转成 WebRTC/HLS网页和手机直接看不用转码直播开发者一路推流RTMP/RTSP/SRT同时供多协议拉流省掉自建多套服务器新手不用装依赖、不用写代码改一个 YAML 就能跑它的核心行为只有四条每路流对应一个路径path路径名即流名所有协议共用同一个名字输入和输出协议可以不同比如 RTSP 推入、HLS 读出支持把流录制为 fMP4 或 MPEG-TS 文件存盘事后可通过回放接口下载修改配置文件时热加载生效不断开已有连接。适合谁需要在一个进程里解决多协议分发、录播、鉴权问题的团队不适合需要复杂转码、AI 分析的场景——它只做封装层remuxing不改码流。 安装、启动并验证 MediaMTX整个流程分三步拿到二进制、启动、打开内置网页验证。第一步获取可执行文件。MediaMTX 不依赖任何运行时产物就是一个mediamtxWindows 为mediamtx.exe。可以先克隆项目仓库查看默认配置模板和文档git clone https://gitcode.com/GitHub_Trending/me/mediamtx cd mediamtx仓库根目录的mediamtx.yml就是默认配置。要运行还需从项目的发布包Releases 页下载与你的系统匹配的独立二进制各安装方式的详细步骤见 安装文档。第二步启动。默认配置零修改即可运行./mediamtx启动后它按mediamtx.yml的默认值监听各协议端口协议端口RTSPTCP8554RTMPTCP1935HLSHTTP8888WebRTCHTTP8889SRTUDP8890MoQHTTP/QUIC8892 / 8893WebRTC ICEUDP8189第三步验证。打开浏览器访问http://localhost:8889会看到 MediaMTX 内置的 WebRTC 网页播放器访问http://localhost:8892则是内置的 MoQ 网页客户端。页面能打开说明服务器已正常工作。此时还没有流可播这是正常的——下一步才推流。⚙️ 看懂最小可用配置mediamtx.yml 里只需理解两块mediamtx.yml很长但新手阶段只需要理解全局开关和路径两块其余参数保持默认即可。第一块全局开关。每个协议都是协议名: true/false的形式配一个xxAddress指定端口。例如想关掉 RTMP把rtmp: true改成false即可。日志用logLevelerror/warn/info/debug和logDestinationsstdout/file/syslog控制。第二块路径。这是配置的核心分两层paths: demo: # 路径名即流名 source: publisher # 流由客户端推入 record: true # 开启录制pathDefaults段是全路径的默认值默认source: publisher即等待客户端推流paths段按路径名覆盖。source还能直接写成外部地址如rtsp://摄像头IP/stream此时 MediaMTX 变成主动拉流支持 RTSP、RTMP、SRT、HLS、MoQ、UDPMPEG-TS 等多种来源写法完整清单见 配置参数参考。两个省事的特性值得记住热加载保存配置文件即生效不用重启已有连接不受影响环境变量覆盖任意参数可用MTX_参数大写名覆盖如MTX_RTSPADDRESS127.0.0.1:8554 ./mediamtxDocker 部署时特别方便。另外注意默认鉴权允许任何用户推流和拉流只在本地回环 IP 开放 API。要暴露到内网或公网前请配置authInternalUsers或用外部 HTTP / JWT 鉴权。 跟练实战推入第一路流用三种方式读出来这个案例走一遍完整链路FFmpeg 推 RTSP → 服务器转换 → RTSP/HLS/文件三种方式消费同时验证录制功能。1. 配置路径并开启录制。编辑mediamtx.yml保存后热加载自动生效paths: demo: source: publisher record: true recordPath: ./recordings/%path/%Y-%m-%d_%H-%M-%S recordSegmentDuration: 5m2. 用 FFmpeg 把一个 MP4 循环推成直播流。这条命令以原始码率-c copy通过 RTSP 推到本机 8554 端口的demo路径ffmpeg -re -stream_loop -1 -i demo.mp4 -c copy -f rtsp rtsp://localhost:8554/demo推流端也可以在推流软件里换成 RTMP地址填rtmp://服务器IP:1935/demo流名demo。3. 多协议读出同一路流。路径名不变换协议换端口即可这就是自动协议转换的实际效果VLC 播放 RTSPvlc --network-caching50 rtsp://localhost:8554/demoFFmpeg 拉 RTSP 存文件ffmpeg -i rtsp://localhost:8554/demo -c copy out.mp4HLS用浏览器或 FFplay 访问 8888 端口下demo路径对应的 m3u8 地址具体地址格式见 HLS 读取文档4. 检查录制。流在播期间./recordings/demo/目录下会按recordSegmentDuration切出 fMP4 分片文件。全部读者断开后分片收尾成完整段。做完这一步你已经掌握了 MediaMTX 的完整闭环推入、转换、读取、录制。️ 避坑启动、跨网、配置三类高频问题按症状 → 原因 → 修法看这四个最常见的问题。问题 1启动报端口被占用。原因8554RTSP、1935RTMP与常见服务冲突。 修法改mediamtx.yml中对应xxAddress或临时用MTX_RTSPADDRESS:9554 ./mediamtx覆盖。问题 2Docker 里 RTSP 推流偶发失败。原因Docker 网络栈会替换入站 UDP 包的来源 IP/端口RTSP 的 UDP 传输依赖它。 修法按官方安装文档设置MTX_RTSPTRANSPORTStcp禁用 UDP 传输或改用--networkhost运行容器。问题 3同一内网能播跨网段/跨 NAT 的 WebRTC 连不上。原因客户端收不到可达的服务器地址ICE 握手中缺少公网信息。 修法在配置里给webrtcAdditionalHosts填上客户端实际访问的公网 IP若本地端口不通再配webrtcICEServers2引入 STUN/TURN。问题 4改了配置不生效或录制文件越积越多。原因热加载在尽可能的前提下生效个别结构性改动需要重启录制默认只保留 1 天长期运行后磁盘行为由recordDeleteAfter控制。 修法关键改动后重启一次最稳妥按存储预算调整recordSegmentDuration与recordDeleteAfter设为0s则不自动删除。更多疑难可以开着logLevel: debug复现问题日志里带连接 ID方便对照行为。 往下走监控、回放与更多扩展跑通第一路流之后建议按这个顺序扩展全量参数配置参数参考 列出了每个参数的默认值与说明遇到不认识的配置名直接查这里Control API 与 metrics把api: true端口 9997和metrics: true端口 9998打开就能用 HTTP 管理路径、用 Prometheus 抓取mediamtx_前缀指标做告警回放把playback: true端口 9996打开即可通过/list和/get接口按时间段下载已录制的流fMP4 格式可直接放进浏览器video标签协议进阶架构文档 解释了路径管理器、路径、录制器三大组件的关系是理解流到底怎么被路由的入口。MediaMTX 的设计哲学是把复杂留在服务端你只需要记住路径名即流名这一条规则剩下的协议、端口、格式转换都由它兜底。从今天的demo路径出发换一行source配置就能接入真实摄像头这套上手路径可以直接照搬到生产环境。【免费下载链接】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），仅供参考