GB28181视频监控平台实战：wvp-GB28181-pro从0到1部署与避坑指南

GB28181视频监控平台实战：wvp-GB28181-pro从0到1部署与避坑指南

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

从一个头疼的场景说起：多品牌摄像头各用一套客户端

园区、楼宇里的监控设备往往来自不同厂家：摄像头是海康、NVR是大华、平台是宇视，每家设备说一套自己的"方言"，想在一块大屏上看齐所有画面，往往要装好几套厂家客户端。wvp-GB28181-pro 是一个开源的 GB28181视频监控平台，它用 GB28181-2016 国标协议把各品牌设备统一接入，让视频在同一个网页里观看、录制、云台控制和向上级平台共享。

这个平台能解决谁的问题

让混合品牌设备的管理员不再折腾私有协议。海康、大华、宇视等品牌的 IPC、NVR，只要支持国标 28181，配置好平台地址和密码就能注册上来，不需要再为每个品牌单独维护一套对接方案，也不依赖厂商的私有客户端。

让非国标的旧设备也能被利用起来。项目里还有不少 RTSP、RTMP 源头的摄像头和直播流，平台支持把这类流拉进来转成国标格式，再共享给其他 GB28181 平台，旧设备不用换也能纳入统一管理。

让多套系统之间的视频流通起来。平台支持国标级联，可以把自己下面的通道注册、推送给一个或多个上级平台，上级平台能点播你的视频、控制你的云台；反过来也可以接入上级体系。跨网闸场景下也有对应的互联方式。

让没有专职运维的人也能部署。整套系统用 Docker Compose 编排，一条命令拉起 MySQL、Redis、ZLMediaKit 流媒体服务、wvp 核心服务和 Nginx 五个容器，不用逐套安装配置。

🚀 快速上手：最短路径把平台跑起来

先确认环境：一台 Linux 服务器（CentOS 7 以上或 Ubuntu 20.04 以上均可），装好 Docker，内存 4GB 起步，磁盘预留 50GB 以上可用空间。

然后获取代码：

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

部署前只需要在 docker 目录下的.env里改几个关键项：SIP_Id填本平台 20 位国标编号，SIP_Domain填该编号的前 10 位，SIP_Password填设备注册认证密码，Stream_IP填用户观看视频流时能访问到的地址，SDP_IP填信令里携带、摄像头能访问到的 IP。这五项的含义在配置注释里都有说明，改完即可启动：

docker-compose up -d

等待各容器起来后，浏览器访问http://服务器IP:8080，用默认账号 admin / admin 登录，就能看到管理后台。

WVP 平台登录页，浏览器访问 8080 端口后进入，登录后默认以 admin 身份进入控制台

三个核心能力深讲

国标级联：把本级通道共享给上级平台

级联解决的是"平台之间的视频互通"：在"国标级联"页面向上级平台列表中添加对方平台编号、地址和认证信息后，wvp 会自动完成注册、心跳保活；随后点击"选择通道"，把要共享的通道推送给对方，上级平台即可点播这些通道并进行云台控制。一个平台可以同时对上级平台做不同通道编号推送，适合一套设备要同时挂到多个上级体系的场景。

国标级联页面：添加上级平台后可看到注册状态，并对已推送通道做管理和选择

摄像头接入：设备与通道的统一台账

摄像头接入后的日常都在这张表里完成：设备注册上来后自动建档，列表展示设备编号、厂家、在线状态、通道数、最近心跳和注册时间，还能按分屏监控、行政区划、设备列表三种视图切换。设备掉线、通道数不对时，先在这里核对最近心跳时间，再决定是查网络还是查设备侧配置。

国标设备页面：海康、大华、宇视、Mercury 等多品牌设备统一展示，状态、信令传输模式、通道数一目了然

实时播放、云台与录像

播放侧支持分屏监看、主子码流切换，H264 和 H265 都能在浏览器里直接播，不需要装插件；云台控制覆盖方向、变焦，也支持预置位和巡航。录像侧提供两种方式：按录制计划让通道定时录制到云端，或直接做云端录像，录像文件在"云端录像"页面按通道和时间检索，支持在线播放、下载和删除，默认保留 7 天（可在配置中调整）。

分屏监控页面：多路摄像头视频同屏播放，可直接发起云台操作和码流切换

云端录像页面：按通道、时间范围检索录像文件，支持在线播放和下载，用于事后回看

按规模选部署方案

小规模单机容器化就够了，重点是先把网络和端口理顺；中规模开始要注意媒体服务与 wvp 分机部署，把信令和流处理拆开；大规模则建议 wvp 与 ZLMediaKit 节点分离、媒体节点做集群和负载均衡，存储走对象存储控制成本。

🚧 避坑指南：首次部署最容易踩的 6 个坑

1. 设备注册不上来。现象是添加设备后一直离线。多数情况是编号或密码填错，少数品牌设备要勾选"鉴权"后才能填密码；其次是网络不通，注册报文根本没到达 wvp。处理办法：逐项核对 SIP 编号、域和密码，再从设备侧验证到服务器 5060/信令端口的连通性。

2. 设备上线了但视频播不出来。通常是 RTP 媒体端口没放行：默认收流端口是 10000（UDP），如果开启了多端口模式则是 30000–30500 这个范围。在防火墙上放行对应端口段后重试，UDP 点播超时的问题也可以先试开启多端口模式。

3. 播放地址拿到的是内网 IP。原因是Stream_IP没按实际网络填，或 ZLM 与 wvp 分机部署时SDP_IP缺失。Stream_IP要填观看端能访问到的地址，SDP_IP要填摄像头能访问到的地址，两者都不留空给默认内网地址。

4. SIP 域与设备侧配置对不上。注册反复失败且日志里是 401/403 一类错误时，重点核对三处：20 位编号、前 10 位域、认证密码，设备侧和平台侧必须一致；另外监听 IP 不能配 127.0.0.1 或 localhost，不确定就用 0.0.0.0 监听全部网卡。

5. UDP 点播偶发超时。单端口模式用 SSRC 区分流，个别网络环境下容易冲突，表现为时好时坏。开启 rtp 多端口模式（每路流独立端口）通常能明显改善，代价是要放行更大的端口范围。

6. 用默认账号跑了很久。admin/admin 是默认口令，接口鉴权默认也是开启状态。部署完成后第一时间改管理员密码，并保留接口与推流鉴权，公网暴露的部署还要确认只开放 8080、信令和 RTP 这几类必要端口。

wvp-GB28181-pro 把国标对接、多品牌摄像头接入、播放云台录像和级联共享做在了同一个开源平台里，部署门槛主要在网络配置而不在软件本身。建议先拿一台摄像头走通"注册—播放—级联"这条链路，验证无误后再逐步扩大接入规模，具体功能与参数细节可参考项目自带的官方文档。

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