从一台裸机到多品牌摄像头统一管理：WVP-PRO 国标视频监控平台落地指南

从一台裸机到多品牌摄像头统一管理：WVP-PRO 国标视频监控平台落地指南

【免费下载链接】wvp-GB28181-pro基于GB28181-2016、部标808、部标1078标准实现的开箱即用的网络视频平台。自带管理页面，支持NAT穿透，支持海康、大华、宇视等品牌的IPC、NVR接入。支持国标级联，支持将普通摄像机/直播流/直播推流转国标共享到国标平台。项目地址: https://gitcode.com/GitHub_Trending/wv/wvp-GB28181-pro

当你同时面对海康、大华、宇视三种摄像头的管理后台，需要在三个网页之间来回切换时，你就会明白什么叫"监控越多，反而越看不见"——数据孤岛让每一次故障排查都变成猜谜游戏。WVP-PRO 正是为解决这个问题而生的开源视频监控平台：它基于 GB28181-2016 国标、部标 808/1078 标准实现，自带管理页面，能让海康、大华、宇视等品牌的 IPC、NVR 通过一个平台统一接入、预览、录像和级联共享。本文不打算罗列功能清单，而是带你以"从零跑通一个监控项目"的方式，亲手把 WVP-PRO 从部署、接设备、共享给上级平台这一整条链路走完，顺便回答选型时最关心的几个问题。

先解决一个认知问题：为什么不能直接连摄像头

很多第一次接触视频平台的人会问：摄像头本身就能看，为什么还要多一个平台？

关键在于"多"字。单台 IPC 可以通过厂商 APP 或浏览器直接访问，但当设备数量超过几十台、品牌超过两家、又需要把画面共享给上级部门时，你会立刻撞上三堵墙：

WVP-PRO 的思路是把所有设备"翻译"成同一种语言——国标 28181，再由它统一对外提供 RTSP、RTMP、HTTP-FLV、HLS 等多种播放协议。你在浏览器里点开就能看，上级平台按国标就能调，不用关心底层是什么牌子。

一句话理解 WVP-PRO 的定位：它像一个"视频翻译中枢"，把各家厂商的私有语言翻译成国标普通话，再转播给所有想看的终端。

动手前先搞清楚的两个零件：WVP 与 ZLMediaKit

在克隆代码之前，有必要先认识这个平台的"双引擎"结构，否则后面排查问题会一头雾水：

• WVP-PRO（信令大脑）：负责 SIP 信令、设备管理、国标级联、权限控制等"指挥"类工作，也就是本仓库的核心代码；
• ZLMediaKit（媒体躯干）：负责真正的流媒体收发、转码分发，它通过 RESTful 接口被 WVP 调用，同时通过 Web Hook 把流的状态回传给 WVP。

两者可以部署在同一台服务器，也可以分开部署以提升并发能力。项目文档 doc/_content/introduction/config.md 中明确提到：最简单的配置下，你甚至不需要修改 ZLMediaKit 的任何默认配置，只要在 WVP 的配置文件里填对 ZLM 的 IP 和端口即可。

如果你是想快速验证流程，仓库的 docker/ 目录提供了完整的 Docker Compose 编排（含 MySQL、Redis、Nginx、ZLMediaKit 和 WVP 本体），一条命令就能拉起整个环境：

git clone https://gitcode.com/GitHub_Trending/wv/wvp-GB28181-pro.git cd wvp-GB28181-pro/docker docker-compose up -d

这是平台自带的 Web 管理界面登录页。装好后通过服务器 IP 加端口访问，默认账号密码均为 admin，适合先登录进来熟悉菜单结构。

接入第一台国标摄像头：三步走完，别再翻厂商文档

假设你手头有一台海康 IPC（大华、宇视、水星、艾科威视的操作逻辑完全一致），接进来的关键就一句话：让摄像头的"国标上级"参数指向 WVP。

先登录 WVP 管理页面，在"国标设备"里找到平台自身的国标服务信息，这些值对应 doc/_content/introduction/config.md 中 sip 段的配置：

sip: port: 5060 # 28181 服务监听端口 domain: 3402000000 # 国标域编码（取 ID 前十位） id: 34020000002000000001 # 28181 服务 ID password: 12345678 # 设备注册密码

然后在摄像头的 Web 后台，把"平台接入 / SIP 配置"里的服务器地址、端口、域、设备编号、密码改成与 WVP 一致。文档 doc/_content/ability/device.md 里附带了海康、大华 NVR、宇视等多家设备的界面截图，照着填即可。

在国标设备页面查看本平台的国标服务信息，将其填入摄像头的 28181 上级配置中。这张图解决新手最常见的疑问："这些参数到底从哪里抄？"

填完保存，几秒后回到 WVP 的"国标设备"列表，如果看到设备上线、状态变为在线，恭喜你，第一台摄像头已经完成国标接入。此时点击"播放"就能在浏览器里直接看画面，支持主码流/子码流切换、云台控制、预置位设置，还能直接拿到一路 RTSP/HTTP-FLV 流地址供其他系统调用。

设备注册成功后出现在国标设备列表中，可查看名称、编号、厂商、通道数、在线状态。它是你整个监控平台的"设备台账"，所有接入的设备都在这里管理。

老设备怎么办：拉流代理让"非国标"相机也能上车

现实很骨感：很多现场还有一批不支持国标的老摄像头，但它们至少能吐出一路 RTSP 地址。为了这些设备再采购一套国标设备，预算上不划算。

WVP-PRO 的拉流代理功能就是为此设计的：由 ZLMediaKit 主动像播放器一样去拉取这路 RTSP 流，缓存在平台里，其他人再从平台取流观看。这样做还有个附带好处——源设备不再需要直面大量并发请求，弱鸡的旧 IPC 也能扛住多人同时观看。

以大华为例，只要它的取流地址形如rtsp://用户名:密码@设备IP:554/cam/realmonitor?channel=1&subtype=0，在"拉流代理 → 添加代理"里粘贴这个地址并保存，就能在平台里播放了。如果需要把这路流再共享给国标上级，编辑该代理、补上"国标通道配置"里的国标编码即可。完整的处理流程可参考文档 doc/_content/ability/proxy.md。

同样的逻辑也适用于直播流：无人机、OBS 推流这类不带国标的直播源，走"推流"功能接入（WVP 默认开启推流鉴权，地址上需要携带签名），推流成功后同样可以作为永久通道存在。由此形成了三条"进料"通道——国标设备、拉流代理、直播推流，无论来源如何，最终都能统一对外分发。

把画面交出去：国标级联，让上级平台"点名即看"

如果说前面几步解决了"自己看"，那国标级联解决的就是"别人调"——这是政务、园区、雪亮工程等场景的刚需：你的下级平台要能把视频目录共享给市级平台，上级随时点播。

WVP-PRO 对级联的支持相当完整：支持同时级联到多个上级平台、每个平台可自定义通道编号、支持目录订阅/报警订阅/位置订阅，以及录像查看与播放。操作路径在管理页面的"国标级联"菜单里：

1. 点击"添加平台"，填入上级平台的 SIP 国标编码、域、IP、端口和认证信息；
2. 在级联平台下添加目录节点（相当于给上级一个"文件夹"）；
3. 把要共享的通道拖入目录，保存后等待注册与目录推送完成。

添加上级平台的配置弹窗，核心是填写上级平台的国标编码、域名、IP、端口与认证信息。字段含义在配置界面和文档 doc/_content/ability/cascade.md 中都有逐项说明。

级联建立后，上级平台就能在你的设备列表里看到共享出去的通道并直接点播。这里有一个容易被忽略的细节：每个级联平台可以使用不同的通道编号，这意味着你可以针对不同上级定制目录结构，一个下级平台同时服务多个上级而互不干扰。

省钱的隐藏技能：按需拉流与断流

接入容易，养起来贵。一个常见误区是：只要设备在线，就让它持续推流，带宽和存储成本每月都在悄悄上涨。

WVP-PRO 的stream-on-demand策略（按需拉流）就是针对这个痛点：有人观看才拉流，无人观看自动释放，配合无人观看自动断流机制，实测场景下带宽占用可以大幅下降。在 doc/_content/introduction/config.md 中对应的配置是：

user-settings: stream-on-demand: true # 国标点播按需拉流 record-sip: true # 国标点播是否同时录像

如果你同时开启录像，需要留意录像文件的保留策略（record-day按天配置），避免磁盘被历史录像慢慢填满。录像功能本身支持对国标、推流、拉流代理三类来源统一录制，管理入口在"云端录像"，支持预览与下载，路径默认在 ZLM 的www/record下。

并发不够怎么办：加节点，而不是换服务器

当设备量上到几百上千路，单台 ZLMediaKit 会因为带宽和性能瓶颈达到上限。此时不需要动 WVP 本体，它的"节点管理"功能支持单 WVP 挂多 ZLM：新请求到来时，WVP 会从 Redis 中读取各节点负载，自动把流调度到负载最低的那台 ZLM 上，实现负载均衡与高可用。

配置也很轻量：启动新的 ZLM 节点后，在"节点管理"里点击添加节点，填 IP、HTTP 端口和 SECRET，通过测试后即可生效。文档 doc/_content/ability/node_manager.md 还提醒了一个 Docker 场景的坑：如果 ZLM 用容器部署且做了端口映射，务必在节点设置里把内外端口一一对应清楚，否则媒体流会找不到回家的路。

选型前的最后一页清单：用 5 个问题快速判断是否适合你

看完上面的落地路径，你可能已经有判断了。最后用一组决策问题帮你对号入座：

如果你的需求命中前四行中的任意一条，那么 WVP-PRO 值得作为首选项去跑一轮 PoC。项目代码遵循宽松的 MIT 协议，二次开发空间充足，前端页面在 web/、后端核心在 src/main/java/com/genersoft/iot/vmp/，文档集中在 doc/，从入门到故障排查都有对应说明。

最后给你一条行动建议：不要一次性追求大而全，按"部署 → 接入一台国标相机 → 加一路拉流代理 → 配一个级联上级"的顺序推进，每完成一步你都会获得一个可验证的阶段性成果。这套最小闭环跑通之后，再逐步扩展到集群与录像策略，一个多品牌、可级联、省带宽的企业级视频监控平台，就真正从你手里落地了。

【免费下载链接】wvp-GB28181-pro基于GB28181-2016、部标808、部标1078标准实现的开箱即用的网络视频平台。自带管理页面，支持NAT穿透，支持海康、大华、宇视等品牌的IPC、NVR接入。支持国标级联，支持将普通摄像机/直播流/直播推流转国标共享到国标平台。项目地址: https://gitcode.com/GitHub_Trending/wv/wvp-GB28181-pro