🎥 泉视 NVR 系统：RTSP 设备接入指南

适用项目：ruoyi-qs-nvr

核心依赖：ZLMediaKit 流媒体服务器

本指南将详细介绍如何通过 RTSP 协议 将 IPC（网络摄像机）、DVR 或其他视频源接入泉视视频监控系统。

---

▶️视频教程

哔哩哔哩地址：ruoyi-qs-nvr 设备接入-rtsp设备

📋 接入前准备

在开始接入之前，请确保您已获取以下信息：

1. 设备 IP 地址：摄像头或录像机的局域网 IP（如 192.168.1.108）。
2. 端口号：RTSP 服务端口（通常为 554）。
3. RTSP 流地址：标准的 RTSP URL 格式。
4. ZLMediaKit 服务正常运行。
5. ruoyi-zlm 运行成功，连接ZLMediaKit没有问题

---

🧩 RTSP 流地址标准格式

泉视系统支持自动拼接和手动填写两种模式。为了确保兼容性，建议先了解主流厂商的 RTSP 地址格式：

1. 海康风格 (Hikvision)

rtsp://用户名:密码@IP:端口/Streaming/Channels/通道号

示例：
rtsp://admin:123456@192.168.1.109:554/Streaming/Channels/1

2. 大华风格 (Dahua)

rtsp://用户名:密码@IP:端口/cam/realmonitor?channel=通道号&subtype=码流类型

示例：
rtsp://admin:123456@192.168.1.109:554/cam/realmonitor?channel=1&subtype=0

🚀 接入步骤

泉视系统支持RTSP方式。

手动添加设备 (推荐)

1. 登录系统：进入泉视 NVR 后台管理界面。
2. 进入设备管理：点击菜单栏的 【设备管理】。
3. 点击新增：点击左上角 【新增】 按钮。
4. 填写设备信息：
   • 设备名称：自定义（如 大厅摄像头）。
   • 直播流类型：选择 RTSP。
5. 填写流地址 (关键步骤)：
   • 直播地址填rtsp地址。
6. 点击【确定】，列表查看设备，点击播放设备，即可完成播放。
7. 注意：ruoyi-zlm 运行成功，连接ZLMediaKit没有问题

🛠️ 常见问题与排查

1. URL 错误：复制 RTSP 地址到 VLC 播放器 中测试。如果 VLC 也无法播放，说明地址或密码错误。
2. 防火墙：检查服务器防火墙是否阻止了 554 端口
3. 网络连通性：确保 ruoyi-qs-nvr 服务器（运行 Java 后端和 ZLM 的机器）能 Ping 通摄像头 IP。
4. 码率过高：尝试在摄像头设置中降低码率，或在接入时选择“子码流”（Sub Stream）。
5. 网络拥塞：检查交换机带宽或尝试更换网线。
6. 检查配置：确保 application.yml 中配置的 media.ip 是 ZLM 服务器所在的 IP，且 media.secret 与 ZLM 配置文件中的 api.secret 一致。

📝 补充说明

1. 流媒体节点：如果设备数量庞大，建议配置多个 ZLMediaKit 节点，负载均衡。

💡 提示

• 如果您的设备是海康或大华品牌，建议优先使用项目中集成的 海康SDK 或 大华SDK 模块进行接入，这样可以获得更好的兼容性（如云台控制）。
• 本指南中的 RTSP 方式主要适用于标准协议设备或非品牌设备。