Docker部署MediaMTX:把RTSP视频流接到浏览器

简介: 本文详解如何用MediaMTX(v1.21.2)将RTSP摄像头流转为浏览器可播的HLS:Docker一键部署、两份完整配置、明确播放地址与三段式排查法(RTSP输入→HLS输出→浏览器解码),专注解决“页面打开但黑屏”核心痛点,不涉录像、AI或平台搭建。(239字)

摄像头的RTSP地址能在播放器里打开,浏览器却不能直接播放,是接入视频页面时常见的断点。把同一个 rtsp:// 地址填进网页的 <video>,并不会自动得到画面。要补的是一条浏览器能接收的播放链路。

我把MediaMTX官方资料整理成一个具体场景:用Docker拉取已有RTSP视频源,再通过HLS播放。本篇固定1.21.2,给出两份完整配置、播放地址和排查顺序;不涉及录像、识别模型或直播平台搭建。

1. 先把输入和输出分清

本例的链路是:RTSP视频源 → MediaMTX → HLS → 浏览器。源可以是摄像头,也可以是已经提供RTSP的媒体服务;需要事先知道实际地址、账号、密码和码流路径。

如果把容器放在ECS,先确认它能访问视频源。办公室的私网摄像头不会因为部署了ECS就自动可达,需要已有的VPN、专线路由或其他可信网络连接。播放端的SSH转发只连接浏览器与ECS,不能替ECS打通摄像头网络。

MediaMTX在这里做协议转换和转封装,不会自动把H.265改成H.264,也不会自动降低码率。首次接入可优先选择H.264视频与AAC音频;摄像头没有合适音轨时,先用无音频码流确认画面。编码支持还要结合目标浏览器验证。

2. 保存两份配置,只发布HLS端口

前提是已有Docker Engine与Compose V2。在独立目录先创建 mediamtx.yml,将占位值替换为自己的视频源:

logLevel: info
api: false
rtsp: false
rtmp: false
webrtc: false
srt: false
moq: false
hls: true
hlsAddress: :8888
hlsVariant: mpegts
paths:
  cam:
    source: "rtsp://CAMERA_USER:CAMERA_PASSWORD@CAMERA_HOST:554/STREAM_PATH"
    rtspTransport: tcp
    sourceOnDemand: true

cam 是本服务的播放路径名,和摄像头原来的 STREAM_PATH 不必相同。密码含 @、:、? 等特殊字符时,要对用户名、密码分别做URL编码;真实凭据只留在受控配置中,不贴进文章、截图或公开仓库。

rtspTransport: tcp 是拉取源的传输选项,不是RTSP服务端的 rtspTransports。本例关闭RTSP监听,仍由RTSP客户端向远端视频源发起连接;无需对外开放服务器的8554端口。

sourceOnDemand: true 表示有读者时才拉取源。hlsVariant: mpegts 使用常规HLS分片,本篇先处理播放与兼容,不追求最低延迟。

在同一目录保存 compose.yaml:

services:
  mediamtx:
    image: docker.1ms.run/bluenviron/mediamtx:1.21.2
    restart: unless-stopped
    command: ["/mediamtx.yml"]
    ports:
      - "127.0.0.1:8888:8888"
    volumes:
      - type: bind
        source: ./mediamtx.yml
        target: /mediamtx.yml
        read_only: true
        bind:
          create_host_path: false

配置文件以只读方式挂到容器的 /mediamtx.yml,启动参数明确指向它;缺文件时不自动创建同名目录。镜像固定具体版本,后续更新要连同配置字段一起复核。这里通过毫秒镜像获取官方项目镜像,它只作用于镜像获取环节;视频源认证、网络和编码仍要分别检查。

3. 启动后,用正确的播放地址

在保存配置的目录执行:

docker compose config --quiet
docker compose pull
docker compose up -d
docker compose logs --tail=50 mediamtx

第一条只检查Compose结构,不替代MediaMTX对自身配置的解析。后续看真实启动日志,检查配置是否加载、拉源是否认证失败、是否能连到源地址;不要把容器Running当作已经有视频。

同机浏览器打开 http://127.0.0.1:8888/cam,这是内置播放页。远程ECS部署则在自己的电脑建立转发,替换示例账号和服务器:

ssh -N -L 8888:127.0.0.1:8888 YOUR_USER@YOUR_ECS

保持连接,再在本地浏览器打开同一地址。默认不把8888映射到公网;本例也没有启用管理API,因此不要把播放页当管理控制台。

HLS清单是 http://127.0.0.1:8888/cam/index.m3u8。它给支持HLS的播放器使用,不能把“浏览器下载了m3u8”当作网页播放成功。首次打开可能要等待源接入及分片生成,随后检查画面是否持续更新,而非只显示播放器边框。

按需拉取时,尚未有人播放,日志暂时没有源连接不一定是故障。先发起播放请求,再观察源认证和分片请求;所有读者退出后,源连接可以按配置关闭。这也意味着首次观看和持续观看的等待情况可能不同,不要把启动后的静默当成没有加载配置。

aliyun-mediamtx-flow.png

4. 页面能打开但没画面,按三段排查

检查位置 先确认什么 不应混为一谈
RTSP输入 容器到源的网络、源账号、准确码流路径 本机播放器能看不代表ECS能连到源
HLS输出 使用cam路径,清单及分片请求是否成功 页面200不等于源已提供可播放媒体
浏览器 视频与音频编码、播放错误、页面协议 HLS转封装不等于已完成转码

如果源是H.265或音频为G.711,即使RTSP能读取,也要检查目标HLS格式和浏览器是否支持。先切换摄像头的兼容码流;确需改变编码时,另接FFmpeg或GStreamer。本例的标准MediaMTX镜像不包含FFmpeg,不要直接在里面套用转码命令。

将画面嵌入业务网站前,先独立打开播放页确认链路。HTTPS网站应配套使用HTTPS播放入口,避免混合内容被浏览器拦截;还需按网站方式处理访问认证和跨域。本篇的本地HTTP示例用于初次接入,不能直接当成公开媒体服务的配置。

WebRTC通常延迟更低,但需要处理额外的媒体连通性、地址与编码条件。本篇关闭它,不要把HLS的8888访问方法套到WebRTC,也不通过增加一堆端口解决HLS黑屏。

5. 留下能复用的接入记录

记录固定版本、源的码流设置、播放路径、目标浏览器和实际播放结果。至少确认画面能持续更新、源断开时表现明确、重新连接后的播放能恢复;同时核对宿主端口仍只绑定本地地址。敏感源地址与密码不进入公开记录。

这条链路接通后,再决定是否接入网站或改用其他输出协议。把输入可达、HLS输出和浏览器解码分开看,才能知道下一步该调整网络、路径还是编码。

相关文章
|
16天前
|
缓存 网络安全 Docker
eMudhra证书事件:核对Compose挂载的CA文件与应用配置
eMudhra证书事件揭示容器中CA信任链风险:镜像更新CA后,若Compose只读挂载宿主机旧证书目录,应用仍会使用过期文件。本文详解挂载路径、环境变量(SSL_CERT_FILE/DIR、REQUESTS_CA_BUNDLE)与实际读取差异,提供只读检查、单文件挂载及摘要核验方法,强调“镜像CA、挂载CA、运行时CA”三者需明确区分。(239字)
|
26天前
|
弹性计算 Linux Docker
2026年10月Docker镜像源清单:ECS旧入口与公共候选
本文梳理2023年10月主流容器镜像加速入口现状:阿里云、百度旧加速器已停更或终止服务;腾讯、华为云内网地址限特定环境;毫秒镜像(docker.1ms.run)与DaoCloud为可用公共候选。强调需按“环境适配→显式拉取→摘要校验”三步验证,不可盲目替换配置。(239字)
2026年10月Docker镜像源清单:ECS旧入口与公共候选
|
3月前
|
弹性计算 运维 Kubernetes
2026年8月ECS与containerd可用镜像源清单
本文整理了2026年8月适用于ECS、Kubernetes及containerd节点的9个国内镜像源清单,涵盖Docker Hub、GHCR、K8s、Quay、MCR等主流Registry,并完成端点与manifest级验证。强调需在真实worker节点实测,而非运维机模拟;提供containerd配置、逐源验证及ImagePullBackOff排查方法。(239字)
|
6月前
|
Kubernetes 网络协议 异构计算
云上 K8s GPU 节点 ImagePullBackOff 排查记录
本文记录云上K8s(v1.36)GPU节点模型评测Job因`ImagePullBackOff`卡在Pending的排查过程,聚焦containerd镜像拉取失败根因,涵盖crictl验证、日志分析、DNS/镜像源配置检查,并强调分层排障:先运行时,再资源调度与设备挂载。
|
5月前
|
存储 弹性计算 数据库
ECS 上 Immich 相册服务升级与恢复排查记录
本次在ECS复现Immich升级后恢复检查:执行`docker compose pull && up -d`后,容器虽运行、Web可访问,但相册索引与缩略图任务未及时恢复。重点排查镜像拉取、DB迁移、挂载路径及权限,强调升级前务必固定版本、备份配置与存储状态。(239字)
|
6月前
|
Kubernetes Perl 容器
K8s Ingress 502 排查:先看 Service、Endpoints 和 readinessProbe
本文详解K8s中Ingress返回502的系统化排查思路:不盲目修改Ingress,而是按Pod→Service→Endpoints→readinessProbe→Ingress逐层验证。重点检查Pod就绪状态、Service selector与targetPort匹配性、Endpoints是否为空、健康探针配置合理性等核心环节,直击502根本原因——上游服务未就绪。(239字)
|
6月前
|
应用服务中间件 文件存储 nginx
测试 NAS 容器服务恢复时的 Docker Compose 排查记录
节后恢复NAS测试环境,Jellyfin、PhotoPrism、Home Assistant容器页面异常。本文记录分层排查过程:从磁盘空间、镜像拉取、Compose状态,到挂载路径、端口连通性及Nginx反向代理配置,精准定位三处问题并修复。(239字)
|
7月前
|
Prometheus 并行计算 异构计算
containerd 节点 GPU 镜像预热记录
本次在GPU节点复现推理环境时,首遇镜像拉取失败(ImagePullBackOff),Pod卡在ContainerCreating状态。通过`crictl pull`逐源验证并预热vLLM、CUDA、Prometheus及pause镜像,明确分离镜像问题与模型问题,提升排障效率。(239字)
|
7月前
|
缓存 Prometheus Kubernetes
MCP 工具服务容器化前,我先做了镜像预检
本文分享MCP Agent部署避坑实践:聚焦镜像拉取环节,通过统一使用毫秒镜像源(如`ghcr.1ms.run`/`docker.1ms.run`等)预检多源镜像、修改compose配置、分步验证,有效规避`context deadline exceeded`等启动失败问题,提升环境复现成功率。(239字)