从设备孤岛到统一指挥WVP-GB28181-Pro开源视频平台从零落地的完整指南【免费下载链接】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 的开源视频监控平台它把多品牌设备统一接入这件事做成了开箱即用的产品自带管理后台、支持 NAT 穿透、支持与海康/大华/宇视的 IPC 和 NVR 对接还能通过国标级联把画面共享给上级平台。接下来我们从一台空服务器出发一步步把它跑起来并讲清楚每个环节能解决什么问题。一、先看懂它两个组件各管一半的活在动手之前你需要先理解这套系统的分工这决定了后面所有排错的思路。WVP-GB28181-Pro 不是单打独斗的程序它由两个服务协作完成组件职责通俗理解WVP-PROJava 服务国标信令、设备管理、数据库、业务接口相当于大脑负责设备和平台之间的注册、心跳、命令ZLMediaKit流媒体服务视频流的接收、转码、分发、录制相当于血管负责把画面从设备端搬到观看端两个服务通过 RESTful 接口和 Web Hook 互相通信WVP 指挥 ZLM 拉流、分发ZLM 把流状态变化实时回报给 WVP。这套信令与媒体分离的设计让它们可以部署在同一台机器上也可以分开部署、甚至组成媒体集群并发能力取决于你的服务器性能而不是平台的代码上限。你只需要记住一句话WVP 管谁在说话ZLM 管画面怎么流动。遇到画面黑屏先查 ZLM遇到设备注册不上先查 WVP。二、一小时跑通最小系统零基础部署四步走对于首次尝试我的建议是一台 Linux 服务器或虚拟机关掉防火墙所有服务装在同一台机器上先把通做到再谈优。第 1 步准备四样基础件除了 Java 环境JDK 21 及以上之外系统还依赖两个存储件MySQL也可以用 PostgreSQL 或金仓——保存设备、通道、用户等业务数据Redis——保存在线状态、会话、节点负载等实时数据如果你不想手工装项目根目录下的docker/文件夹提供了完整的 docker-compose 编排一条docker compose up -d就能把 MySQL、Redis、WVP、ZLM 全部拉起来最适合快速体验。第 2 步建库并导入初始化脚本在 MySQL 中创建一个数据库建议字符集 utf8mb4然后导入初始化脚本。脚本按版本分目录存放在项目根目录的数据库/文件夹下例如数据库/2.7.4/初始化-mysql-2.7.4.sql。从旧版本升级时对应的更新脚本也在同目录里按升级路径执行即可。第 3 步修改配置文件里的三处关键项配置文件位于src/main/resources/application.yml打包后则放在 jar 包同级的application.yml。你不需要改满所有参数只需关注三处数据源把spring.datasource下的 URL、用户名、密码改成你自己的数据库信息SIP 服务sip.port默认 5060sip.domain默认 3402000000这是国标规定的平台域编号前 10 位sip.id是平台自己的 20 位国标编号sip.password是设备注册时的默认认证密码ZLM 连接信息media.ip填 ZLM 所在机器的内网 IPhttp-port默认 9092secret要与 ZLM 配置里的密钥一致。完整参数说明在src/main/resources/配置详情.yml需要哪一项就复制哪一项到你的配置里不必全量照抄。第 4 步启动两个服务# 启动 WVP nohup java -jar wvp-pro-*.jar # 启动 ZLM在 ZLMediaKit 目录下 nohup ./MediaServer -d -m 3 看到 WVP 日志里出现ZLM 已连接的提示就说明两个服务握手成功。此时打开浏览器访问http://服务器IP:端口用默认账号admin/admin登录后台——首次登录后请立即修改默认密码。端口速记WVP 的 HTTP 端口用于网页和接口SIP 的 5060 端口用于国标信令UDP/TCPZLM 的 9092 是媒体服务 HTTP 端口收流端口范围默认 30000-35000。生产环境建议改掉 5060 这类默认端口它是公网扫描的重点目标。三、三种姿势接入设备总有一种适合你的现场这是 WVP-GB28181-Pro 最核心的价值所在。根据现场设备的类型接入方式可以归为三类你可以按需组合。姿势一国标设备主动注册IPC / NVR如果你的摄像头、录像机原生支持国标 28181 协议海康、大华、宇视等主流品牌基本都支持这是最省事的接入方式让设备自己来找平台。在设备端的国标配置页面里填入平台的 IP、端口5060、国标编号sip.id和认证密码sip.password保存后设备就会主动向平台注册。注册成功后回到后台国标设备页面你就能看到新设备上线点一下刷新即可同步出通道列表。这套设备主动注册的模式天然适合跨网段、公网部署的场景——只要设备能访问到平台 IP就能完成注册配合 NAT 穿透能力设备躲在路由器后面也能正常接入。姿势二拉流代理接入非国标老设备如果现场还有一批不支持国标的老摄像头只有 RTSP 或 RTMP 地址别急着淘汰。在拉流代理里添加一个代理填上源流地址和流 IDZLM 会像播放器一样主动去拉取这条流缓存起来再分发给所有观看者。这一招解决的是利旧和抗并发两个问题老设备不用换且源设备只需要承受 ZLM 一个连接的压力多少人同时看都不怕。姿势三直播推流接入无人机、手机、OBS反过来如果你想把无人机图传、手机直播、OBS 推流这些非国标信号源纳入平台可以先在节点管理里查看推流地址拼接出rtmp://流IP:端口/app/流ID这样的推流地址再配合推流鉴权信息推送。推流成功后平台会把它当作一路通道来播放如果给它配置一个国标编号它还能成为永久通道甚至参与国标级联对外共享。四、让画面真正用起来预览、控制、回放三板斧设备接进来只是第一步真正打动用户的是用起来顺不顺。这一节我们过一遍高频操作每项都讲清楚解决什么问题。分屏监控一个浏览器页面装下整个园区平台自带无插件播放器支持 H.264 / H.265 编码无需安装任何客户端。在分屏监控页面你可以按行政区划或业务分组浏览设备树用 1/4/9/16 宫格同时观看多路画面主码流、子码流随时切换——子码流用于大画面快速预览主码流用于单路精细查看这是省带宽的关键习惯。云台与预置位远程转动现场有云台的球机可以在播放页直接进行上下左右转动、拉近拉远预置位可以预先设置、一键调用适合巡检路径固定的场景。对讲功能也能直接发起海康、大华等设备在收流时机的处理上略有差异配置里已给出针对性的开关选项遇到对讲不出声可以检查这一项。录像回放既看得到也留得下平台支持两种录像一种是查询设备自身IPC/NVR的录像并直接回放、下载适合已有存储的老现场另一种是云端录像——让 ZLM 把经过平台的每一路流录制到服务器磁盘上无论是国标设备、拉流代理还是推流直播都能录。配合录制计划你可以让重点区域 7×24 小时录制普通区域按时间表录制避免磁盘被无意义地填满。还有一个省流量的细节值得留意默认开启了按需拉流即有人观看才拉流无人观看自动断流。这对于几百路设备的现场能省下可观的带宽和存储开销。五、国标级联把资源共享出去也把上级接进来如果说前面的功能是向内管理国标级联则是向外开放。它解决的是跨平台互通的问题你的平台可以作为一个下级平台把部分通道共享给上级监管平台也可以同时级联多个上级实现分级监管、资源共享。在平台接入中添加上级平台填写对方平台的名称、编号、IP、端口和认证密码保存后平台会自动发起注册、心跳保活。接着为级联关系添加目录结构、挂载需要共享的通道即可完成一次级联对接。级联的价值在跨区域场景里体现得最明显总部平台不需要直连各分部的每一台设备只需级联接入各分部的 WVP就能统一查看、控制、回放且通道编号可以按每个平台单独定制互不冲突。六、进阶玩法从单机到集群的两步跃迁当接入路数多了之后单台 ZLM 的带宽和性能会成为瓶颈。WVP 的解法是媒体节点集群一个 WVP 可以挂多台 ZLM平台把节点信息登记在 Redis 里新请求到来时自动挑选负载最低的节点实现负载均衡某台 ZLM 宕机也不会拖垮整个平台。实操上你在媒体节点里添加节点 IP、HTTP 端口和密钥测试连通后即可完成接入。如果 ZLM 是用 Docker 启动的注意容器端口与宿主机端口可能不一致需要在节点配置里一一对应填好。需要提醒的是WVP 与 ZLM 不要跨网络部署。比如 WVP 在内网、ZLM 却在公网两者高频的通信交互会因为网络延迟和中间设备变得极不稳定这属于最常见的部署误伤。七、避坑清单踩过的坑帮你提前绕开以下是社区里出现频率最高的几个问题先给你打上预防针设备注册不上先查三处一致性设备端的 SIP 端口、国标编号、密码必须与平台配置完全一致编号是 20 位数字一个字符都不能差。视频黑屏不播放优先检查 ZLM 是否在线、收流端口范围是否在防火墙里放行UDP 多端口模式下30000-35000 这个范围要完整开放。通道数为 0注册成功但没同步到通道多数是对方设备尚未推送目录回到通道页点刷新重新拉取。中文名称乱码设备数据默认按 GB2312 读取部分生僻字会乱码在设备编辑里把字符集改成 UTF-8 即可。Docker 部署 ZLM 连不上务必使用 host 网络模式或保证端口映射一致——特别是 5060外部端口也必须映射为 5060。生产环境安全修改 5060 等默认端口、为 WVP 接口开启鉴权、给推流地址加上鉴权参数这三件事请在公网部署前做完。八、下一步行动清单到这里一条完整的落地路径已经清晰了。如果你想在真实项目里使用它可以按下面的顺序推进体验克隆项目代码git clone https://gitcode.com/GitHub_Trending/wv/wvp-GB28181-pro用 Docker 编排在 30 分钟内跑起一个测试环境验证接入 2-3 台不同品牌的真实设备确认注册、预览、云台、回放全部正常规划梳理现场设备清单按国标注册 / 拉流代理 / 直播推流三种姿势分类制定分批接入计划调优根据并发路数评估是否需要多 ZLM 节点集群配置录制计划与按需拉流策略上线修改默认端口与密码、开放最小化防火墙规则、配置数据库定期备份扩展阅读doc/目录下的官方文档或基于web/src/下的 Vue 前端源码做界面定制从监控室墙上挂着五套系统到一个页面管住全园画面差距往往不在于设备本身而在于有没有一座连接它们的桥。WVP-GB28181-Pro 用一套国家标准协议把这座桥搭好了而且免费、开源、可定制。今天这篇文章帮你走通了从部署到级联的完整闭环剩下的就是把第一台设备接上去——你会发现最难的部分其实在动手之前就已经结束了。最后的小贴士正式接入现场设备之前务必在测试环境里完整验证一遍注册—预览—回放—级联四条链路。平台本身跑通只需要一小时但现场网络千奇百怪提前踩过一遍坑上线时才不会手忙脚乱。遇到疑难问题先去doc/_content/qa/目录下的故障排查文档里翻一翻很多问题的答案其实已经写在里面了。【免费下载链接】wvp-GB28181-pro基于GB28181-2016、部标808、部标1078标准实现的开箱即用的网络视频平台。自带管理页面支持NAT穿透支持海康、大华、宇视等品牌的IPC、NVR接入。支持国标级联支持将普通摄像机/直播流/直播推流转国标共享到国标平台。项目地址: https://gitcode.com/GitHub_Trending/wv/wvp-GB28181-pro创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考