mediamtx RTSP SETUP 400/404报错完整指南3步解决路径问题【免费下载链接】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用 mediamtx 拉取摄像头流时客户端报 400 Bad Request、日志里写着 invalid path或者显示 no stream available 就是播不出来本文讲清 RTSP SETUP 的路径校验机制并给出 3 步定位方案帮你快速修复。 核心原理mediamtx 如何校验 RTSP 路径mediamtx 收到 SETUP 请求后的第一件事就是检查路径必须以/开头否则直接回 400 并记录 invalid path。校验逻辑在 internal/servers/rtsp/session.go 的 onSetup 中if len(ctx.Path) 0 || ctx.Path[0] ! / { return base.Response{StatusCode: base.StatusBadRequest}, // 直接返回 400 nil, fmt.Errorf(invalid path) } ctx.Path ctx.Path[1:] // 去掉开头斜杠后再查路径、验权限、建立传输校验通过后服务器会按路径名查找配置、匹配认证用户最后协商传输方式TCP/UDP/组播。所以路径必须和配置里的路径名一字不差权限也要放行两步缺一不可。 分步实操3步排查并修复 SETUP 报错第1步检查请求 URL 是否规范做什么客户端地址必须是rtsp://IP:8554/路径名路径部分不能为空也不能漏掉斜杠。怎么验证本地先用 ffplay 探一下排除客户端自身问题# 路径必须以 / 开头ffplay 是排查最轻量的客户端 ffplay rtsp://127.0.0.1:8554/cam1如果日志打出 invalid path问题就锁定在这一步基本是 URL 写错空路径rtsp://IP:8554、缺斜杠rtsp://IP:8554cam1都会触发。第2步确认路径存在且有流做什么路径格式正确却返回 404说明该路径既没有推流者也没配置 source。怎么配在 mediamtx.yml 中检查路径名拼写给只读路径配上拉流源paths: cam1: source: rtsp://192.168.1.100:554/stream # 客户端读取时自动向摄像头拉流怎么验证mediamtx 保存配置即热加载无需重启。执行curl -s localhost:9997/v3/paths能看到该路径的 track 与读者数即生效。第3步核对认证与权限做什么返回 401/403 时是认证环节的问题。默认配置允许任何用户读写如果你改过 authInternalUsers就要确认权限里包含 read。怎么配authInternalUsers: - user: viewer pass: 123 permissions: - action: read path: cam1 # 限制可读路径留空表示所有路径怎么验证ffplay -u viewer -p 123 rtsp://127.0.0.1:8554/cam1不再出现 401 且画面正常即通过。第4步可选用 on-demand 动态拉起流源做什么流源靠外部脚本启动时可以配置 runOnDemand客户端一读就自动执行命令省掉人工干预。怎么配paths: cam1: runOnDemand: exec: /bin/sh start_cam.sh # 客户端发起读取时执行该命令怎么验证日志出现 SETUP 请求后 runOnDemand 命令被执行流在 runOnDemandStartTimeout默认 10s内上线。⚙️ 关键配置项详解配置项默认值作用建议取值rtspAddress:8554RTSP 握手 TCP 端口保持默认端口冲突时才改rtspTransports[udp, multicast, tcp]媒体传输方式跨 NAT、防火墙时改为 [tcp]rtsptrue是否启用 RTSP 服务保持 truelogLevelinfo日志级别路径报错都记录在此排障时临时调 debug 排错速查常见报错 3 秒定位报错现象可能原因处理动作400 Bad Request日志 invalid pathURL 路径为空或没以/开头改写为rtsp://IP:8554/路径名别漏斜杠404 no stream available路径未发布且未配 source在 mediamtx.yml 给路径加 source或确认推流方仍在线401/403账号无 read 权限或密码错误检查 authInternalUsers确认权限覆盖该路径461 Unsupported Transport客户端请求了被禁用的 UDP/组播传输把对应项加回 rtspTransports或让客户端协商 tcp能连接但画面卡死UDP 丢包严重将 rtspTransports 改为 [tcp] 重试⚠️ 避坑与进阶路径名避免空格、中文等需要 URL 编码的字符用纯英文数字最省心。反向代理Nginx 等前置时把代理 IP 加入 rtspTrustedProxies否则日志和鉴权拿到的是代理 IP。怀疑网络前先在服务器本机 8554 端口 ffplay 验证本地能播再排查外网。收尾记住三个检查点URL 以/开头、路径存在且有流源、权限含 read能解决绝大多数 SETUP 报错。协议参数细节可看 docs/2-features/04-read.md更深入的定制配置参考 docs/2-features/05-configuration.md。【免费下载链接】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），仅供参考