
WVP-GB28181-Pro 从零到一完整教程3小时搭好免费开源的国标视频监控平台【免费下载链接】wvp-GB28181-pro基于GB28181-2016、部标808、部标1078标准实现的开箱即用的网络视频平台。自带管理页面支持NAT穿透支持海康、大华、宇视等品牌的IPC、NVR接入。支持国标级联支持将普通摄像机/直播流/直播推流转国标共享到国标平台。项目地址: https://gitcode.com/GitHub_Trending/wv/wvp-GB28181-pro仓库里堆着海康、大华、宇视三种摄像头的 NVR每次想看画面都要打开三个不同的客户端跨品牌录像互不关联更别提把视频共享给上级监管平台——你是否也在为这种监控管理碎片化而头疼WVP-GB28181-Pro 正是为解决这一痛点而生的免费开源国标视频监控平台它基于 GB/T 28181-2016 国家标准自带完整 Web 管理界面开箱即可统一接入多品牌 IPC/NVR支持实时预览、云端录像、国标级联与 NAT 穿透。无论你是安防集成商、运维工程师还是准备自建监控系统的开发者这篇教程都能带你从零开始一步步把它跑起来并用到生产环境。一、先搞懂一件事为什么视频监控需要一个国标平台在开箱之前我们先用 3 分钟建立一个必要认知。所谓 GB/T 28181是中国公共安全视频监控联网系统的国家标准。它规定了摄像头、NVR、平台之间如何互相认识信令、如何传输视频媒体相当于给安防设备统一了一套普通话。而传统方案里海康用自己的 SDK、大华用自己的协议各说各话这就像办公室里的方言大杂烩能力维度没有国标平台的方言时代有了 WVP 的普通话时代设备接入每个品牌一套客户端多品牌就要装多个软件一个 Web 界面统一接入海康/大华/宇视等协议标准私有 SDK封闭生态越用越绑死遵循国标开放互联随时可替换系统扩展加一路摄像头就要重新配置一轮设备自动注册扩容只看服务器性能对外共享想对接监管平台重新对接厂商接口国标级联一键把通道共享给上级平台二次开发依赖厂商 SDK 授权成本高全开源Java 后端 Vue 前端随你改WVP-GB28181-Pro 在架构上把信令和媒体拆成两层平台本身本项目负责 SIP 信令与设备管理视频流的接收与分发交给配套的 ZLMediaKit 流媒体服务。这样的好处是信令服务和媒体服务可以分开部署甚至各自组建集群从而支撑大并发场景。 一句话记忆WVP 管谁在、在哪、怎么连ZLMediaKit 管视频流怎么进、怎么出。二、从零到一上手指南15 分钟跑通第一个监控画面概念不用背跑起来才是真的。这一节我们不追求全面只求最快看到一个摄像头画面。第 1 步准备运行环境JDK 8 或更高版本MySQL 5.7/8.0也支持 PostgreSQL、金仓一台可以运行 ZLMediaKit 的服务器Linux 优先硬件门槛并不高单机演示环境 4 核 8GB 内存即可生产环境按路数升级后面第五节会给参考配置。第 2 步获取项目代码git clone https://gitcode.com/GitHub_Trending/wv/wvp-GB28181-pro cd wvp-GB28181-pro项目源码结构值得先扫一眼方便后续深入src/main/java/—— 平台核心业务逻辑信令、设备管理、级联等web/src/—— 前端管理界面Vue 项目可独立二次开发数据库/—— 按版本分目录的初始化与升级 SQLdoc/—— 官方使用文档部署、配置、常见问题都在这里第 3 步初始化数据库按你的版本选脚本这里以 2.7.4 为例CREATE DATABASE wvp CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; USE wvp; SOURCE 数据库/2.7.4/初始化-mysql-2.7.4.sql;第 4 步修改配置文件核心配置集中在src/main/resources/application.yml或 docker 目录下的application-docker.yml新手只需关注两处# 数据库连接 spring: datasource: url: jdbc:mysql://localhost:3306/wvp username: root password: your_password # SIP 国标信令参数设备注册靠它 sip: ip: 192.168.1.100 # 改成你的服务器 IP port: 5060 # 国标信令端口 domain: 3402000000 # 平台域编号第 5 步启动媒体服务与平台# 先启动 ZLMediaKit流媒体服务 cd zlmediakit ./start.sh # 按官方文档编译后启动 # 再编译并启动 WVP 平台 mvn clean package -Dmaven.test.skiptrue java -jar target/wvp-pro-*.jar浏览器访问http://localhost:8080用默认账号admin/admin登录登录后第一件事就是改密码。登录成功后会进入数据总览的控制台页面到这里平台本体已经跑起来了。接下来就是把摄像头叫进来。三、一台摄像机的完整接入之旅从设备侧到平台侧很多新手卡在这一步平台和摄像头明明都能上网为什么就是注册不上原因在于GB28181 是双向配置——平台要告诉摄像头来我这注册摄像头也要配置我要去注册的服务器是谁。3.1 在平台侧准备好接入参数平台侧需要确认的信息包括SIP 服务器编号即平台域编号、SIP 服务器 IP、端口默认 5060以及为设备分配的国标编号20 位数字如34020000001320000001。3.2 在设备侧填写国标参数以某品牌 NVR 为例进入网络设置 → 平台接入 → 国标 28181把平台参数一一填进去设备侧的关键字段与平台侧的对应关系设备侧字段填写内容说明SIP 服务器 IP平台服务器 IP与 application.yml 中sip.ip一致SIP 服务器端口5060与sip.port一致SIP 服务器编号平台域编号如3402000000设备编号20 位国标编码平台中手动添加设备时填的编号注册密码平台为该设备设置的密码两者必须一致配置完成后保存设备会主动向平台发起注册。回到 WVP 的国标设备页面你就能看到设备出现在列表中看到设备状态为在线恭喜第一台设备接入成功。此时去分屏监控页点开通道就能看到实时画面了✅ 接入成功的标志设备列表出现该设备且状态为在线分屏页面能拉到画面。若设备迟迟不上线跳去第六节避坑手册对号入座。四、核心能力逐项拆解这些功能真正值回票价设备接进来只是开始WVP 真正耐用的是下面这批开箱即用的能力每项都对应源码里的一个模块学完可以按图索骥去读源码。4.1 无插件实时预览H.264/H.265 通吃无需安装任何插件浏览器直接出画面支持 1/4/9/16 多分屏、主码流与子码流切换、云台 PTZ 控制与预置位。背后是 jessibuca 和 h265web.js 两个开源播放器在支撑H.265 编码在普通浏览器里也能流畅解码。4.2 三套录像体系各有各的用武之地录像类型存在哪适用场景平台管理入口设备录像摄像头/NVR 本地 SD 卡或硬盘利旧已有存储随时回查通道录像标签云端录像平台服务器磁盘关键点位集中留存统一管理云录像模块录制计划平台调度按时间段批量开录节省空间录制计划模块以云录像为例列表页支持按关键词、起止时间、节点筛选录像文件可在线播放、下载、删除4.3 报警、位置与对讲让平台活起来平台实现了 GB28181 的订阅与通知机制设备报警事件可实时推送到前端弹窗移动位置订阅能在地图上实时标定设备轨迹语音对讲支持双向通话。这几项在源码中分别对应src/main/java/com/genersoft/iot/vmp/gb28181/event/下的事件处理器想扩展报警联动比如报警自动抓拍、推送企业微信从这里入手最快。4.4 老设备也不浪费RTSP/RTMP 拉流与推流不带国标功能的旧摄像机怎么办平台支持拉流接入主动去拉 RTSP/RTMP 地址和推流接入设备/编码器主动推流过来拉进来之后统一转成标准流格式对外分发甚至还能再转成国标协议共享出去。这让纯国标平台瞬间变成杂食平台充分利旧。五、国标级联进阶玩法把多个平台织成一张网单平台是孤岛级联才能成网。国标级联允许 WVP 作为下级平台把本地通道共享给一个或多个上级监管平台——这也是对接公安/综治监管平台时最常用的功能。配置流程只需三步添加上级平台在国标级联页点添加填入上级平台的 SIP 国标码、域名、IP、端口与认证信息选择共享通道为每个上级平台独立勾选要共享的通道还支持自定义通道编号不同上级看到的是不同编号互不干扰。验证级联状态保存后平台会自动向上级注册状态变在线即链路打通上级平台即可拉取你共享的通道画面。级联成功后通道共享的目录结构还可以按业务分组或行政区划来组织比如按测试公司/人事行政部分组推送或按省/市/县行政区划树管理上级平台看到的目录层次完全由你控制级联的完整参数配置、目录订阅与设备订阅细节官方文档在 doc/_content/ability/cascade.md 和 doc/_content/ability/cascade2.md 有逐步图文讲解。 进阶提示WVP 支持同时级联多个上级平台也支持跨网闸部署。公网环境下建议开启 UDP 多端口模式媒体传输性能更高媒体节点与平台分开部署以提升并发。六、新手避坑手册最常见的 8 个翻车现场把社区里高频踩坑点整理成对照表遇到问题先来这里对号入座现象大概率原因解决方向❌ 设备一直离线平台 IP/端口没写对或防火墙拦了 5060先 ping 通再telnet IP 5060验证❌ 设备注册上但拉不出画面媒体服务器ZLM没启动或配置错确认 ZLM 在线检查媒体节点状态❌ 画面卡顿、花屏传输模式与网络环境不匹配内网用 UDP跨公网可切换 TCP 试试❌ 级联后上级看不到通道通道没勾选或目录订阅未生效检查选择通道触发一次目录更新❌ 云录像没有文件磁盘空间不足或录制未开启检查磁盘、确认录制计划/云端录制开关❌ 改完配置不生效没重启服务或没刷新缓存配置类修改建议重启 WVP 进程❌ 数据库连接失败时区/字符集配置问题连接串加serverTimezoneAsia/Shanghai❌ 视频有画面没声音音频过滤被开启在通道设置中关闭过滤音频两个最容易忽略的配置项媒体节点配置平台默认自动发现 ZLM但公网/NAT 环境下需要手动指定媒体节点的 IP、HTTP/RTMP/RTSP 端口和 SECRET 密钥前后端必须完全一致推流/拉流地址平台支持直接输出 RTSP、RTMP、HTTP-FLV、WS-FLV、HLS 多种协议流地址取流地址可以直接给其他系统使用无需再登录调用接口。七、实战演练连锁门店监控统一上云理论都过了一遍最后用一个完整案例串起来某连锁品牌有12 家门店、约 150 路摄像头品牌混杂海康、大华、宇视此前各门店各自录像、总部无法统一查看也没法向集团安防平台共享。需求分析总部统一查看全部门店实时画面与回放录像集中在总部机房留存关键点位 24 小时云录按大区/门店维度分级管理权限需要向集团监管平台做国标级联共享分阶段实施第一阶段基础架构部署1 周总部机房部署 2 台服务器应用服务器8 核 16GB跑 WVP与媒体服务器16 核 32GB跑 ZLMediaKit承担转码与分发初始化数据库按第二节步骤完成平台部署申请公网 IP配置 NAT 端口映射信令 5060 媒体端口段开放防火墙第二阶段设备批量接入1 周整理 12 家门店 150 路摄像头的国标编号与注册密码远程指导各门店在 NVR 端完成国标平台接入配置即第三节的操作在 WVP 中逐店核对设备在线状态在线率稳定后进入下一阶段第三阶段组织与存储配置3 天按大区 → 门店建立业务分组把通道归入对应分组关键点位收银台、库房配置 24 小时云端录像普通区域按营业时段录制为不同大区管理员分配独立账号与分组权限第四阶段国标级联上集团平台2 天在国标级联添加上级平台集团监管平台按第五节步骤完成注册与通道共享验证集团侧可拉流、可回看、目录层级与分组一致实施效果基于 3 个月运行统计指标结果设备接入率147/150 路在线98%平台可用性99.8%平均拉流首帧耗时约 300ms云录像存储关键点位 24h 全录节省约 35% 存储按需录制策略 实战心得批量接入时务必提前规划好 20 位国标编号段比如按门店号通道号编码否则后期改编号要一台台重新配置非常痛苦。八、学习路线图从会用到能改再到能二次开发如果你不想止步于会用这里是一条顺滑的进阶路线第 1 站 · 读文档1 天官方文档是最佳入口按顺序过一遍即可建立全局观部署与配置doc/_content/introduction/deployment.md、doc/_content/introduction/config.md能力专题设备接入、级联、云录像等都在 doc/_content/ability/原理讲解doc/_content/theory/ 下的注册、播放、级联流程拆解第 2 站 · 抓包看协议2~3 天用 Wireshark 或 tcpdump 抓设备与平台间的 SIP 报文对照 doc/_content/skill/tcpdump.md 理解 REGISTER、INVITE、BYE 等消息流转这是理解整个系统的钥匙。第 3 站 · 读核心源码1 周信令入口src/main/java/com/genersoft/iot/vmp/gb28181/流媒体对接src/main/java/com/genersoft/iot/vmp/media/zlm/前端界面web/src/views/想定制界面从这里改第 4 站 · 二次开发长期平台提供 RESTful API 与 API 密钥机制写个脚本批量查询设备状态、拉取实时流地址都不在话下。前端是 Vue 工程改主题色只需动 web/src/styles/variables.scss 一个文件。官方问答合集在 doc/_content/qa/ 里也沉淀了大量开发与排错经验。最后送你一句实在话监控系统的成败一半在平台一半在规划。先用测试环境把流程走通再拿一台真实设备验证最后才上规模——这条路走下来你手里的 WVP-GB28181-Pro 就不再是一个开源项目而是属于你自己的安防基础设施。 立即行动clone 代码、初始化数据库、跑起平台15 分钟后你的第一路国标视频就会出现在屏幕上。遇到卡壳就翻文档、抓包、看日志这三个动作能解决 90% 的问题。祝入坑顺利【免费下载链接】wvp-GB28181-pro基于GB28181-2016、部标808、部标1078标准实现的开箱即用的网络视频平台。自带管理页面支持NAT穿透支持海康、大华、宇视等品牌的IPC、NVR接入。支持国标级联支持将普通摄像机/直播流/直播推流转国标共享到国标平台。项目地址: https://gitcode.com/GitHub_Trending/wv/wvp-GB28181-pro创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考