如何安全地构建和测试 RTSP 摄像头 URL

RTSP URL 由几个部分组成：协议、摄像头地址、可选端口、凭据以及厂商特定的路径。只要有一个字符错误，就可能出现与网络被阻止时相同的空白预览，因此请逐项验证你的假设，同时不要分享包含凭据的完整 URL。

本指南适用于外部 IP 摄像头。打印机的原生摄像头应继续通过受支持的打印机集成连接。

Printer Tools

在一个面板中管理您的所有 3D 打印机

通过一个应用监控 Bambu Lab、Klipper、OctoPrint、Creality、Snapmaker、Anycubic、Flashforge、Elegoo 和 Prusa 打印机

支持 Android、iPhone、iPad 和 Mac，并提供 Apple Watch 与 Wear OS 配套应用，以及通过 VPN、OctoEverywhere 或 Obico 实现的可选远程访问

从摄像头文档开始

找到对应摄像头确切型号和固件的 RTSP 章节。外观相似的型号可能使用不同的路径，或者需要先启用 RTSP。

记录本地 IP 地址、RTSP 端口、视频流路径，以及摄像头是否需要本地用户。不要把包含默认凭据的公开示例复制到正式使用的网络中。

了解 URL 结构

典型结构是 rtsp://user:password@camera-address:port/path，但协议之后的每个部分都取决于设备。有些应用会在单独的字段中接收凭据，并在内部生成经过认证的 URL。

如果 Printer Tools 提供单独的凭据字段，请优先使用。这样可以避免在长字符串中编辑机密信息，并减少与保留字符相关的错误。

正确编码特殊字符

@, :, /, ? 和 # 等字符在 URL 中具有特殊含义。包含这些字符的密码嵌入 URL 时，可能需要进行百分号编码。

不要为了避免编码而降低密码强度。请使用摄像头的本地账号功能，以及 Printer Tools 要求的输入格式。

在同一网络中测试

首先确认设备能够访问摄像头地址。然后在 Printer Tools 中添加视频流，并等待初始协商完成。超时通常意味着路由问题或端口被阻止；认证错误指向用户名、密码或账号权限；“未找到”响应则指向视频流路径。

在排查访客网络或 VPN 之前，先在主局域网中测试。连接成功后，在 DHCP 中保留摄像头地址。

选择主码流或子码流

主码流细节更多，但可能会让 Wi-Fi 或移动设备解码器负担过重。分辨率和帧率适中的子码流通常足以确认首层附着和打印进度。

先从较低设置开始，确认稳定后，只有在监控设备和网络都有余量时才提高画质。

绝不要公开完整 URL

经过认证的 RTSP URL 可能在一行中同时暴露摄像头地址、用户名和密码。在截图、日志和支持消息中请隐去凭据和私有地址。

如果 URL 已经泄露，请更改摄像头密码。仅删除消息是不够的，因为可能仍有副本。

远程访问请使用 VPN

RTSP 并不是为直接从家庭路由器对外暴露而设计的。不要进行端口转发。请通过可信的 VPN 连接，让 Printer Tools 访问与在家时相同的私有地址。

如需自动发现配置文件，请使用 ONVIF 摄像头指南。

常见问题

554 端口总是正确的吗？

它很常见，但摄像头也可能使用其他端口。请遵循设备的确切配置。

为什么我的密码会导致 URL 出错？

保留字符可能会被解析为 URL 分隔符。请使用单独的字段或正确的百分号编码。

主码流总是更好吗？

不是。子码流能以少得多的带宽提供更可靠的仪表板预览。

我可以把 URL 发给支持人员吗？

不要发送未隐去信息的认证 URL。请改为提供错误信息和去除敏感信息后的结构。

官方资料: RFC 7826 — RTSP 2.0 · RFC 3986 — URI percent-encoding · ONVIF — Profile S