一台服务器统一管起海康大华宇视：用WVP-GB28181-Pro搭建国标视频监控平台的完整实战-育师

一台服务器统一管起海康大华宇视：用WVP-GB28181-Pro搭建国标视频监控平台的完整实战

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

监控中心负责人老张最近的处境，你一定不陌生：仓库装了16台海康、8台大华，停车场还有一批宇视，每套设备配一个客户端、一个密码本，上级部门要对接国标平台时，还得专门写程序做协议转换。直到他换上 WVP-GB28181-Pro 这套国标视频监控平台，所有设备才终于"说同一种语言"。这篇文章就用老张的真实经历，带你走一遍从零搭建到多级联动的完整路径。

一、痛点开场：多品牌摄像头为什么总在"各说各话"

传统监控系统的核心矛盾是协议封闭。海康有海康的 SDK，大华有大华的 SDK，接入方式、码流格式、控制命令互不兼容。想统一管理，只能买昂贵的平台软件；想对接上级监管平台，又得逐家厂商做私有协议转换。

GB/T 28181 国家标准的存在，就是为了打破这种壁垒——它定义了国标设备如何注册、如何取流、如何控制。而 WVP-GB28181-Pro 正是把这条标准"落地成产品"的开源实现。

它解决的核心问题一句话说清：用一套开源平台，把不同品牌的 IPC、NVR 按国标协议统一接入，浏览器免插件直接看，还能向上级国标平台级联共享。

二、开局 30 分钟：数据库、配置、启动的三步闪电战

老张的服务器是台 4 核 8G 的 Linux 主机。WVP-GB28181-Pro 采用 Java（Spring Boot）开发，前端基于 Vue，整体架构是"信令 + 媒体"分离：WVP 负责国标信令和设备管理，ZLMediaKit 负责流媒体收发与分发，两者通过 RESTful 接口和 Web Hook 双向通信。

第一步：准备依赖与数据库

项目需要 JDK（文档要求 21+）、MySQL/PostgreSQL/金仓任一数据库，以及 Redis。数据库脚本按版本放在项目数据库/目录下，例如数据库/2.7.4/初始化-mysql-2.7.4.sql，建库导入即可。老张选了 MySQL：

CREATE DATABASE wvp CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; SOURCE 数据库/2.7.4/初始化-mysql-2.7.4.sql;

第二步：修改核心配置

配置文件在src/main/resources/application.yml，核心就三块：

# 数据库（按你选定的数据库类型调整） spring: datasource: url: jdbc:mysql://127.0.0.1:3306/wvp?useUnicode=true&characterEncoding=UTF8 username: root password: your_password # SIP 国标信令配置 sip: port: 5060 # 国标信令端口 domain: 3402000000 # 平台域编码（前8位为中心编码，后2位为行业编码） id: 34020000002000000001 password: 12345678 # 设备默认认证密码 # ZLMediaKit 媒体服务连接信息 media: ip: 172.19.128.50 # zlm 内网 IP（必须修改） http-port: 9092 secret: TWSYFgYJOQWB4ftgeYut8DW4wbs7pQnj

配置里最容易被忽略的是hook-ip：当 WVP 和 ZLM 不部署在同一台机器时，必须把它改成 ZLM 能访问到 WVP 的地址。端口方面，WVP 的server.port（Web 界面）和sip.port（信令）必开；ZLM 的 HTTP、RTMP、RTSP 及收流端口范围按需开放。

第三步：编译启动

# 编译前端页面 cd wvp-GB28181-pro/web/ npm --registry=https://registry.npmmirror.com install npm run build:prod # 生成可执行 jar 并启动 cd wvp-GB28181-pro mvn package nohup java -jar target/wvp-pro-*.jar &

看到日志里出现"zlm 已连接"的提示，就说明通了。浏览器访问http://服务器IP:8080，用默认账号admin/admin登录——第一次登录后务必改密码。

三、设备接入实战：海康、大华、宇视怎么"进门"

登录后进"国标设备"页，你会看到一个类似老张当初的困惑：设备编号 31 位、域编码、传输模式……一堆陌生概念。其实只要抓住三点：

在设备端把国标服务打开，填上 WVP 的 SIP 服务器地址、端口和认证密码；
在平台端点击"添加设备"，填入设备国标编号，也可"手动添加设备并设置单独密码"；
看状态列：显示"在线"即注册成功。

老张 24 台设备两小时内全部上线。他特别提到两个省心细节：

支持 UDP/TCP 双模式：跨网段、跨防火墙时，切换信令和流传输模式往往比改网络更快；
主码流/子码流切换：预览用子码流省带宽，回放切主码流保清晰，无需重启设备。

四、无插件看视频：从"装客户端"到"开浏览器"的跨越

以前看监控要装专用客户端，换台电脑就得重装。WVP-GB28181-Pro 基于 ZLMediaKit 支持输出 RTSP、RTMP、HTTP-FLV、WebSocket-FLV、HLS 多种流协议，前端用 jessibuca、h265web 播放器，H.264/H.265 都能在浏览器直接播放。

老张最常用的是分屏监控：1/4/9/16 路自由切换，左侧按"业务分组""行政区划"树点选设备，双击即出画面。还有个贴心机制——无人观看自动断流，有人在看才拉流，没人看就释放，省下了可观的带宽和服务器负载。

如果不想登录系统，还可以直接用固定流地址播放摄像头画面，配合"自动点播"开关，只要有人访问地址就自动拉起点播，适合做对外分享和集成。

五、国标级联：把本地平台"挂"到上级监管平台

这是 WVP-GB28181-Pro 区别于普通 NVR 软件的分水岭。国标 28181 支持平级和上下级互联，平台支持向上级平台级联，并且能同时级联到多个上级平台——对老张这种"要对接市局、区局两套平台"的场景刚刚好。

操作路径很短：

进入"国标级联"→ 添加上级平台，填名称、编号、IP、端口；
在级联平台下添加目录，把需要共享的通道挂进目录（支持每个平台使用不同的通道编号）；
开启目录订阅、报警订阅、位置订阅，上级平台就能实时拿到目录和状态变化。

级联的价值在于"资源共享"：下级平台接入的普通摄像机、直播推流、拉流代理，都可以一键转成国标通道推给上级。跨区域联网监控、临时应急接入、第三方平台对接这三个场景，用它都能快速落地。

六、进阶配置：媒体节点集群与云录像

当设备规模上来，单机扛不住时，WVP 支持信令与媒体分离部署，甚至媒体节点集群。配置里加多组media.servers节点即可，WVP 会自动做负载均衡，把视频流分发到不同媒体节点。老张的园区二期扩容，就是在原有 WVP 上新增了两个 ZLM 节点，无需迁移数据。

录像方面，"云录像"把国标视频、推流、代理流统一录制到服务器本地，支持按时间查询、预览和下载；"录制计划"则按设定的时间周期对通道录像。

如果只是快速体验，项目docker/目录已备好 docker-compose 配置，docker compose up -d一条命令即可拉起 WVP、ZLM、MySQL、Redis 全套服务，适合先跑通再细化。

七、避坑清单：老张踩过的 4 个坑

坑 1：设备反复注册失败。先 ping 通网络，再核对 31 位国标编号和认证密码，最后确认 5060 端口在防火墙放行——顺序别反，八成问题出在前两步。

坑 2：能注册但看不到画面。多数是流传输模式不匹配。先试多端口收流模式（media.rtp.enable: true，配置port-range），兼容性最好；单端口模式点播超时时优先切多端口测试。

坑 3：ZLM 连不上。WVP 与 ZLM 分开部署时，hook-ip必须配置为 ZLM 可达的 WVP 地址，默认 127.0.0.1 只在同机部署时有效。

坑 4：公网部署被扫描攻击。生产环境务必修改默认端口，尤其是 5060；关闭无关端口，配置接口鉴权和播放鉴权，防止拿到播放地址就能裸播。

八、结尾：从"能用"到"好用"的下一步

老张这套系统的最终形态：一套开源国标视频监控平台，管着 300+ 路摄像头，同时级联两套上级平台，浏览器看实时画面，云录像兜底回放，手机端通过流地址随时抽查——总成本几乎只是服务器费用。

你现在就可以行动：

克隆源码：git clone https://gitcode.com/GitHub_Trending/wv/wvp-GB28181-pro，本地跑通测试环境；
读文档：项目doc/目录下有完整的使用说明，从编译、配置到部署都有对应章节；
看源码：核心逻辑在src/main/java/，前端在web/src/，二次开发可以基于web/src/views/扩展页面、通过 RESTful API 对接业务系统。

最后的小贴士：正式上线前，先在局域网把一台真实设备完整跑通"注册→预览→云台→回放→级联"全流程再谈规模；测试时记得先关防火墙，能排除掉一大半"莫名奇妙"的故障，等验证通过后再按需开放端口。

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考