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 是一个零依赖的实时媒体服务器也是媒体代理客户端把音视频流转进来它负责存储、转换、转发、录制和回放。整个服务编译为单个 Go 可执行文件不需要数据库、不需要运行时环境覆盖 RTSP、RTMP、WebRTC、SRT、LL-HLS、MPEG-TS、RTP 和 Media-over-QUICMoQ等主流协议。核心价值在于一进多出同一路流可以用任意协议推入再让其他协议同时读取比如用 RTSP 推入、用 HLS 在浏览器里播放。谁适合用它需要把摄像头或推流端统一收进来、再分发给多类客户端的工程师要搭建轻量直播/监控中台、不想维护一堆中间件的开发者需要录制、回放历史视频流或把流转发到其他平台的运维人员核心能力速览能力说明多协议接入RTSP / RTMP / WebRTC / SRT / MoQ / HLS / MPEG-TS / RTP 互相转换一路流多路消费按路径path管理流每个路径可同时被多个客户端读取录制与回放落盘为 fMP4 或 MPEG-TS 分段回放服务可按时间轴下载按需拉流通过source反向拉取外部 RTSP/RTMP/HLS 等源热更新配置修改 mediamtx.yml 后不中断已有客户端控制面Control API、Prometheus 指标、hooks 外部命令回调各协议实现位于 internal/servers/想深入某个协议可以按目录找。安装前检查系统Linux、Windows、macOS 均可单文件部署无运行时依赖。端口确认以下端口未被占用RTSP 8554、RTMP 1935、HLS 8888、WebRTC 8889TCP与 8189UDP、SRT 8890UDP、MoQ 8892/8893UDP。网络若客户端跨 NAT 或跨网段访问 WebRTC需要服务器有一个可达的 IP后面会讲怎么配置。最短安装路径生产环境推荐 Docker隔离且版本可控。以下命令映射了全部常用端口适合 Linux 服务器docker run --rm -it \ -p 8554:8554 \ -p 1935:1935 \ -p 8888:8888 \ -p 8889:8889 \ -p 8892:8892 \ -p 8890:8890/udp \ -p 8189:8189/udp \ -p 8892:8892/udp \ -p 8893:8893/udp \ bluenviron/mediamtx:1如果端口映射太繁琐也可以直接用主机网络Linux 上可用docker run --rm -it --networkhost bluenviron/mediamtx:1不用 Docker 时从项目 Releases 页下载对应系统的独立二进制解压后直接运行即可./mediamtx启动后若看到类似levelINFO msgRTSP server listening on :8554的日志说明服务已就绪。最小可运行配置首次启动时程序会在当前目录生成默认配置文件 mediamtx.yml。绝大多数场景只需动两个地方下面是最小示例logLevel: info # 日志级别error / warn / info / debug paths: # 流按路径管理路径名就是 URL 的最后一段 mystream: source: publisher # 由推流端RTSP/RTMP 等客户端提供逐行说明logLevel: info控制日志详细度排障时临时改成debug。paths.mystream声明一条流。推流地址即rtsp://服务器IP:8554/mystream路径名与配置键一致。source: publisher表示等别人推给你。若改成source: rtsp://192.168.1.50:554/cam服务器就会反向从该摄像头拉流你无需自己写推流程序。默认认证策略允许匿名用户发布和读取仅限内网测试合适对外部署前建议先在authInternalUsers里收紧权限。启动与验证3 条命令跑通目的推一路流进去再从另一协议读出来确认转码链路正常。推流——用 FFmpeg 把一个 MP4 循环推入 RTSP 端口ffmpeg -re -stream_loop -1 -i file.mp4 -c copy -f rtsp rtsp://localhost:8554/mystream拉流——另开终端用 VLC 播放同一 RTSP 地址vlc rtsp://localhost:8554/mystream换协议验证——浏览器直接打开http://localhost:8888/mystream页面会内嵌 HLS 播放器。能看到画面即代表 RTSP 进、HLS 出整条链路打通。常见问题1. Docker 里 RTSP 的 UDP 传输失败容器网络栈会重写 UDP 源地址导致 RTP 包回不来。两种解法改用主机网络--networkhost或设置环境变量-e MTX_RTSPTRANSPORTStcp让 RTSP 只走 TCP。2. WebRTC 客户端连不上服务器WebRTC 客户端需要知道服务器的可达地址。在容器里通过-e MTX_WEBRTCADDITIONALHOSTS服务器IP注入内网和公网 IP 不同时应把两个都配进去。3. 端口被占用或想换端口修改 mediamtx.yml 中对应监听项例如rtspAddress: :8554改成:9054保存后配置热加载生效已有连接不会断开。完整端口清单和含义以官方文档 docs/5-references/1-configuration-file.md 为准。下一步快速上手与安装细节docs/1-kickoff/录制、回放、转发、认证等特性说明docs/2-features/用 FFmpeg / GStreamer / OBS 推流的具体示例docs/3-publish/各协议客户端读取方式docs/4-read/把 mediamtx.yml 通读一遍是最快的进阶方式每个配置项都有中文注释级别的详细说明。【免费下载链接】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），仅供参考