如何用WVP-GB28181-Pro免费搭建国标视频监控平台:3个常见难题与完整实战指南
【免费下载链接】wvp-GB28181-pro基于GB28181-2016、部标808、部标1078标准实现的开箱即用的网络视频平台。自带管理页面,支持NAT穿透,支持海康、大华、宇视等品牌的IPC、NVR接入。支持国标级联,支持将普通摄像机/直播流/直播推流转国标共享到国标平台。项目地址: https://gitcode.com/GitHub_Trending/wv/wvp-GB28181-pro
在动手部署前,先交代清楚:WVP-GB28181-Pro是一个基于GB/T 28181-2016国标协议、同时兼容部标808与部标1078标准的开源网络视频平台,自带完整Web管理界面,用于统一接入和管理海康、大华、宇视等品牌的IPC、NVR设备,支持NAT穿透与国标级联。它把"信令控制"和"媒体分发"拆成两个独立服务,前者由本项目负责,后者交给流媒体服务ZLMediaKit完成。
如果你正在为监控系统选型,下面的内容来自大量生产环境的真实经验,可以直接对照使用。
一、三个最常见的监控平台难题
难题1:设备品牌混杂,平台互不相认。海康的摄像头、大华的NVR、宇视的球机,各自用私有协议,想统一管起来就得买一堆SDK授权,还要签技术服务协议。
难题2:浏览器看不了视频。传统方案依赖IE插件或专用客户端,换台电脑、换个浏览器就黑屏,移动端更是无从谈起。
难题3:上级要数据,下级交不上来。监管平台要求按国标上报目录、推流、传位置,自己搭的平台没有级联能力,只能人工录屏截图交差。
二、逐个击破:这个开源平台凭什么能解
2.1 多品牌统一接入:标准协议就是翻译官
WVP-GB28181-Pro把国标协议当作"通用语言",只要设备支持28181(现在主流安防设备基本都支持),填好国标编号和密码就能注册接入。接入后在国标设备页面能实时看到设备名、厂家、通道数、在线状态,点"刷新"即可同步通道,点"播放"即可出流。
对于不带国标功能的旧摄像机,也不用报废——平台支持通过RTSP/RTMP拉流或推流接入,把普通摄像机、直播流"翻译"成国标资源再共享出去,实现了真正的"利旧"。
2.2 浏览器无插件播放:音视频不再设门槛
点播成功后,平台能同时输出RTSP、RTMP、HTTP-FLV、WebSocket-FLV、HLS多种协议地址,H.264/H.265编码都支持。前端播放器用纯Web方案(jessibuca、h265web.js),Chrome、Firefox直接看,手机浏览器也能看,分屏模式支持多画面同时预览,还能随时切换主码流、子码流。
2.3 国标级联:把本地平台挂到上级去
在"国标级联"里添加上级平台,填入平台名称、编号、IP,再选择要共享的通道目录,平台会自动完成注册、心跳保活、目录订阅和通道推送。一套资源可以同时级联到多个上级,每个上级还能用独立的通道编号,互不干扰。
三、从零到一:最快上手的3个关键步骤
第1步:准备好三样环境
项目用Java(Spring Boot)开发,需要JDK 21+、MySQL(也支持PostgreSQL/金仓)和Redis。此外还要准备一台运行ZLMediaKit的媒体服务器——它负责实际的拉流、转码与分发,可以与WVP分开部署。
第2步:建库导表并改配置
从仓库的数据库/2.7.4/目录导入初始化SQL,然后编辑src/main/resources/application-dev.yml,重点核对三处:
spring: datasource: url: jdbc:mysql://127.0.0.1:3306/wvp?useUnicode=true&characterEncoding=UTF8 username: root password: 你的密码 sip: port: 8116 # 国标信令端口 domain: 4101050000 # 平台域编号(前10位) password: 12345678 # 公共认证密码 media: ip: 192.168.1.10 # ZLMediaKit服务器内网IP http-port: 9092 secret: 你的密钥易错提醒:sip.domain建议取行政区划编码前8位加行业编码后2位,乱填会导致部分设备注册异常;media.secret必须与ZLMediaKit配置的admin_params=secret一致,否则媒体服务自动配置会失败。
第3步:编译启动并登录验证
mvn clean package -Dmaven.test.skip=true nohup java -jar target/wvp-pro-*.jar & nohup ./MediaServer -d -m 3 & # 启动ZLMediaKit浏览器访问http://服务器IP:18080,默认账号密码均为admin,登录后立刻改密码。仓库还提供了install.sh,会自动生成systemd服务,适合生产环境一键托管。
四、三个进阶配置,让平台更好用
① 按需拉流,省流量。user-settings.stream-on-demand: true表示有人观看才拉流,无人观看自动释放,摄像头不在线时还能自动重连。
② 多端口模式,兼容更多设备。在media.rtp下开启多端口模式并给出一段端口范围(如40000-45000),用端口区分每路流,比单端口模式兼容性更好,遇到点播超时优先试试它。
③ 媒体节点集群,撑起大并发。平台支持流媒体节点集群与负载均衡,压测环境里能轻松接入数万路设备;结合虚拟线程支持,Web端并发能力显著提升。核心实现可参考src/main/java/com/genersoft/iot/vmp/下的信令与业务代码。
五、最容易被忽略的3个坑
- 端口没开全。除了Web端口,
sip.port(UDP+TCP)和ZLM的RTMP/RTSP/收流端口都要放行;公网部署尤其要改掉默认的5060端口,否则很容易被扫描攻击。 - 防火墙干扰UDP收流。测试环境建议先关防火墙排除网络因素,生产环境再按最小权限开放。
- WVP与ZLM不要跨网段。两者通信频率极高,一个在内网一个在公网会导致流媒体通道频繁掉线。
六、现在就开始行动
这个平台真正解决了多品牌设备统一管理、浏览器无插件播放、国标级联上报三件难事,而且完全开源、自带管理界面。建议按这个路径走:
- 先体验:克隆仓库 https://gitcode.com/GitHub_Trending/wv/wvp-GB28181-pro ,半小时内跑起测试环境;
- 再学习:完整文档在
doc/目录,从introduction/deployment.md读起最省力; - 后定制:前端在
web/src/,接口用API Key鉴权后即可二次开发对接业务系统; - 最后贡献:源码开源,遇到问题提Issue,动手修一个Bug就是最好的入门。
💡小贴士:先用一台旧电脑 + 一个海康或大华测试机跑通全流程,再谈生产部署。实际环境中,九成的"设备注册不上"都出在国标编号位数、密码一致性、端口放行这三件事上——把这三项查完,问题基本就解决了一半。
【免费下载链接】wvp-GB28181-pro基于GB28181-2016、部标808、部标1078标准实现的开箱即用的网络视频平台。自带管理页面,支持NAT穿透,支持海康、大华、宇视等品牌的IPC、NVR接入。支持国标级联,支持将普通摄像机/直播流/直播推流转国标共享到国标平台。项目地址: https://gitcode.com/GitHub_Trending/wv/wvp-GB28181-pro
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考