WVP + ZLMediaKit

搭建一套可用的 GB28181 平台

用 WVP-PRO 处理国标信令和设备业务,用 ZLMediaKit 处理 RTP 媒体与多协议分发,快速建立从设备注册到网页播放的完整链路。

信令与媒体分离支持 IPC / NVR便于联调与扩展
系统架构

WVP 管业务,ZLM 管媒体

WVP 负责 GB28181 信令、设备、目录、点播和录像业务;ZLMediaKit 负责 RTP 收流、媒体解析、协议转换与分发,两者通过 HTTP API 和 Web Hook 协同。

国标设备IPC / NVRREGISTER · RTP
信令管理WVP-PROSIP · 设备 · 业务
流媒体服务ZLMediaKit收流 · 转封装 · 分发
使用端Web / API预览 · 回放 · 管理
WVP-PRO

信令与业务控制面

  • 处理设备注册、认证和心跳
  • 管理设备目录、状态与报警
  • 发起实时点播、回放和控制
  • 维护上下级平台级联关系
  • 通过 API 与 Hook 协调媒体服务
ZLMediaKit

媒体处理与分发面

  • 接收 GB28181 PS-RTP 推流
  • 完成 RTP 排序、解复用和解析
  • 输出 RTSP、RTMP、HLS、HTTP-FLV 等
  • 按策略处理无人观看和录像
  • 向 WVP 回报流注册与播放事件
搭建流程

从基础环境到设备播放

先确认组件间网络互通,再接入真实设备。每一步都应有明确、可观测的验证结果。

01

准备基础服务

准备 Linux 服务器、数据库与缓存服务,并按所选 WVP 版本说明配置运行环境。先规划域编码、设备编码、SIP 端口和媒体端口范围。

02

启动 ZLMediaKit

部署 ZLM,设置 HTTP API 端口与 api.secret,开放 RTP 接收端口或端口范围。确认 MediaServer 已能正常响应 API。

03

配置 WVP

填写数据库、Redis、SIP ID/域/IP/端口;在媒体服务器配置中填写 ZLM 地址、HTTP 端口、Secret、对外流地址和 RTP 端口范围。

04

建立 Hook 通信

WVP 通过 ZLM API 管理媒体,ZLM 通过 Web Hook 回报流注册、无人观看和播放鉴权等事件。两端地址与 Secret 必须一致且网络互通。

05

接入国标设备

在 IPC 或 NVR 中填写 WVP 的国标平台 ID、域、地址、端口和密码,启用后观察 REGISTER、Keepalive 与 Catalog 是否依次成功。

06

验证播放链路

在 WVP 页面发起点播,确认 INVITE/SDP、设备 RTP 推流、ZLM 收流与 Web 播放依次成功,再配置录像、级联和 HTTPS。

配置关系

四组参数必须对得上

很多“设备能注册但不能播放”的问题,根因并不在协议实现,而是信令地址、媒体地址、Hook 地址或端口映射不一致。

SIP 参数平台 ID、域、IP、端口、密码
ZLM API媒体服务器 IP、HTTP 端口、api.secret
媒体地址stream-ip、RTP 端口或端口范围
Hook 回调WVP 可达地址、回调鉴权与超时策略
先懂协议

搭建前先掌握完整通信链路

了解注册、目录、点播、RTP/PS 和级联后,配置与排障会更有依据。

查看完整协议