
5 分钟跑通 MediaMTX你的第一条低延迟 RTSP 流媒体别再踩坑【免费下载链接】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、SRT、WebRTC、LL-HLS 等协议转发出去全程不转码、延迟极低。读完这篇教程你会在本地启动它用一条钩子命令推起第一条流并用播放器亲眼确认画面出现。一条命令启动 MediaMTX 容器为什么先装容器MediaMTX 是单文件可执行程序Linux、Windows、macOS 都能直接跑但 Docker 方式最干净不装任何依赖端口映射清楚随时docker run就能复现。如果你在其他发行版上用包管理器或下载对应平台的独立二进制也是一句话的事原理完全相同。docker run --rm -it --networkhost bluenviron/mediamtx:1启动后终端会刷出几行日志出现[RTSP] listener opened on [::]:8554这样的提示就说明 RTSP 端口已经就绪。注意这里用了--networkhostRTSP 依赖 UDP 传输host 网络能绕过 Docker 网络栈对真实源地址的改写。如果你用的不是 Linux把--networkhost去掉改为逐项映射-p 8554:8554 -p 1935:1935 -p 8888:8888等端口即可见 安装文档。在 mediamtx.yml 里写最小配置默认的 mediamtx.yml 其实不用改就能用但我们想让服务器自己开播。打开它滚到文件末尾的paths:段加两条键值paths: mystream: runOnInit: ffmpeg -re -stream_loop -1 -i file.mp4 -c copy -f rtsp rtsp://127.0.0.1:8554/mystream这段配置的逻辑是当服务器初始化名为mystream的路径时自动执行runOnInit里的外部命令。这里借 FFmpeg 把本地file.mp4以恒定速率无限循环推送到 RTSP 端点——相当于给服务器配了一个永远在线的虚拟摄像头。完整的环境变量如MTX_PATH语义可以查 hooks 配置说明但第一条流只需上面两行。改完不用重启MediaMTX 支持配置热加载保存文件后日志会提示重载完成已连接的客户端不会被断开。把第一条流验证出来现在流应该已经在播了。打开 VLC菜单栏选择打开网络串流输入rtsp://localhost:8554/mystream你该看到file.mp4的画面在 VLC 里循环播放。命令行党可以直接用vlc --network-caching50 rtsp://localhost:8554/mystream更完整的播放器/推流器组合示例见 基本用法文档。验证失败时的三个高频坑画面出不来九成是下面三个原因之一路径不一致。推流 URL 的路径必须和配置里的路径名一字不差mystream写成mystream2就是一条不存在的流RTSP 端会直接返回 404 类错误。Docker 里 UDP 不通。RTSP 默认走 UDP容器环境下常被网络栈坑掉。把环境变量MTX_RTSPTRANSPORTStcp传给容器强制 TCP基本能解。命令依赖找不到。runOnInit执行的环境和服务器同一个容器基础镜像里没有 FFmpeg。换成官方bluenviron/mediamtx:1-ffmpeg变体自带 FFmpeg即可。各协议监听端点RTSP 8554、RTMP 1935、HLS 8888 等都能在 mediamtx.yml 的全局段里查到并修改排障时先确认端口没被占用。接下来往哪走跑通第一条流只是起点往paths:里加source可以直接代理上游摄像头加record能把流落盘成 fMP4 或 MPEG-TS 供回放浏览器里直接访问http://localhost:8888/mystream就能拿到 HLS 页面播放。深入阅读可以从 功能总览 开始再看 internal/servers/ 目录了解各协议服务端的实现。【免费下载链接】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),仅供参考