一、WVP-GB28181 是什么？

WVP-GB28181（常见实现为 wvp-GB28181-pro）是面向国标视频平台接入的开源方案，常用于对接海康、大华等前端设备，实现设备注册、目录查询、实时预览、回放、云台控制等能力。对于安防平台、园区管理、视频汇聚项目来说，它是一条成熟且可扩展的技术路线。

二、部署前准备

建议先明确三类资源：服务资源（CPU/内存/磁盘）、网络资源（公网IP、NAT、端口策略）、中间件资源（MySQL、Redis、ZLMediaKit）。在中小规模场景，推荐先用单机部署跑通，再根据设备量和并发量做拆分。

  • JDK 8/11（按项目版本要求）
  • MySQL 5.7+/8.0（存设备与平台配置）
  • Redis（缓存会话、目录状态等）
  • ZLMediaKit（流媒体分发与播放）
  • 可控的 SIP/HTTP/RTSP/RTC 相关端口

三、核心配置思路

1）SIP 参数：确保本地 SIP 监听端口、域 ID、平台 ID、密码与上级/设备端一致；若存在 NAT，需要准确设置公网 IP 与映射端口。2）媒体服务：WVP 与 ZLMediaKit 的 HTTP Hook、密钥、API 端口要一一对应。3）数据库与缓存：先保证连接稳定，再考虑连接池、慢查询和持久化策略。

四、最常见的联调问题

实践中最常见的问题通常不是代码，而是网络与参数错位：

  • 设备能注册但无法播放：通常是媒体端口未放行或公网地址配置错误。
  • 目录能查到但预览失败：检查 INVITE 流程与 SDP 中地址是否可达。
  • 偶发掉线：排查心跳周期、设备时钟漂移、Redis/MySQL 抖动。
  • 回放异常：检查设备录像检索协议支持差异与时间区间格式。

五、上线建议

建议配置统一日志检索（按设备 ID、通道 ID、SIP Call-ID 聚合），并建立基础监控：注册设备数、在线通道数、拉流成功率、失败码分布、媒体服务负载。对于生产环境，务必做端口最小暴露、鉴权加固与配置备份，避免平台升级导致参数丢失。

六、结语

WVP-GB28181 的价值在于“标准化接入 + 可持续扩展”。先把注册、目录、实时预览这三条主链路打通，再逐步完善回放、云台、告警联动与权限体系，项目落地会更稳。