保姆级教程：手把手教你用WVP-Pro + ZLMediaKit搭建GB28181视频监控平台（含海康摄像头配置）-编程实验室

GB28181视频监控平台实战：从零搭建WVP-Pro与ZLMediaKit全栈方案

在智能安防与视频监控领域，GB28181协议已经成为行业标准协议之一。这套国标协议定义了视频监控设备之间的通信规范，使得不同厂商的设备能够互联互通。对于开发者而言，如何快速搭建一个符合GB28181标准的视频管理平台是常见的需求场景。本文将带你从零开始，基于WVP-Pro和ZLMediaKit两大开源组件，构建完整的视频监控平台解决方案。

1. 环境准备与基础架构

搭建GB28181平台前，需要明确整体技术架构。WVP-Pro作为SIP信令服务器，负责处理设备注册、目录订阅等GB28181标准信令交互；ZLMediaKit则作为媒体服务器，承担视频流的接收、转码与分发工作。两者协同构成完整的视频监控平台基础。

基础环境要求：

Linux服务器（推荐Ubuntu 20.04 LTS）
JDK 11+（WVP-Pro依赖）
MySQL 5.7+（存储设备信息与配置）
Redis（用于缓存与状态管理）
至少4GB内存（视频处理较耗资源）

安装基础依赖：

# Ubuntu示例 sudo apt update sudo apt install -y openjdk-11-jdk mysql-server redis-server

提示：生产环境建议将MySQL和Redis部署在独立服务器，避免资源竞争。

2. WVP-Pro部署与配置

WVP-Pro是GB28181协议栈的核心实现，负责SIP信令处理。我们从源码编译开始：

git clone https://github.com/648540858/wvp-GB28181-pro.git cd wvp-GB28181-pro mvn clean package

编译完成后，需要重点配置几个关键文件：

application.yml核心配置项：

server: sip: id: 34020000002000000001 # SIP服务器ID domain: 3402000000 # SIP域 ip: 192.168.1.100 # 服务器IP port: 5060 # SIP端口 media: zlm: ip: 192.168.1.100 # ZLM服务器IP http-port: 80 # ZLM HTTP端口 secret: 035c73f7-bb6b-4889-a715-d9b2d39c2b11 # Hook密钥

数据库初始化脚本位于doc/database.sql，执行后还需配置数据源：

spring: datasource: url: jdbc:mysql://localhost:3306/wvp?useSSL=false username: root password: yourpassword

启动WVP-Pro：

java -jar target/wvp-pro-*.jar

注意：首次启动后需检查日志是否有数据库连接错误，常见问题是字符集不匹配。

3. ZLMediaKit部署与调优

ZLMediaKit是高性能流媒体服务器，负责处理视频流的接收与转发。推荐使用docker快速部署：

docker run -d -p 1935:1935 -p 8080:80 -p 8443:443 \ -p 554:554 -p 10000:10000 -p 10000:10000/udp \ -e TZ=Asia/Shanghai \ --name zlm zlmediakit/zlmediakit:latest

关键配置项位于config.ini：

[api] secret=035c73f7-bb6b-4889-a715-d9b2d39c2b11 # 需与WVP-Pro一致 [hook] enable=1 admin_params=secret=035c73f7-bb6b-4889-a715-d9b2d39c2b11

性能调优参数：

[rtp]节配置timeoutSec=3600防止流过早断开
[hls]节设置segNum=5减少HLS延迟
[general]节调整threadNum根据CPU核心数设置

验证ZLM运行状态：

curl http://localhost:8080/index/api/getServerConfig

4. 海康摄像头接入实战

以海康DS-2CD3系列摄像头为例，演示GB28181设备接入：

摄像头网络配置：
- 通过设备IP访问Web管理界面
- 进入"网络→高级配置→平台接入"
- 启用GB28181协议，填写SIP服务器信息
关键参数配置：
- SIP服务器ID：34020000002000000001
- SIP域：3402000000
- 注册密码：需与WVP-Pro中配置一致
- 本地SIP端口：默认5060
- 传输协议：UDP
WVP-Pro设备管理：
- 登录WVP-Pro管理界面(默认admin/123456)
- 在"设备管理"中应能看到自动注册的摄像头
- 点击"播放"测试视频流

常见问题排查：

设备未上线：检查SIP注册状态和网络连通性
视频无法播放：确认ZLM的hook配置正确
延迟过高：调整ZLM的jitterBuffer参数

5. 平台功能扩展与高级特性

基础平台搭建完成后，可以考虑以下增强功能：

设备状态监控：

// 示例：设备离线监听实现 @EventListener public void handleDeviceOffline(DeviceOfflineEvent event) { Device device = event.getDevice(); log.warn("设备[{}]离线，最后在线时间：{}", device.getDeviceId(), device.getKeepaliveTime()); // 发送告警通知... }

视频流处理：

通过ZLM的hook实现按需拉流
使用FFmpeg滤镜进行实时分析
集成AI分析框架实现智能识别

API开发： WVP-Pro提供RESTful API支持二次开发：

GET /api/v1/device/list # 获取设备列表 POST /api/v1/play/start # 发起实时播放

6. 生产环境部署建议

对于正式运营环境，需要考虑以下方面：

高可用架构：

+-----------------+ | 负载均衡(Nginx) | +--------+--------+ | +----------------+----------------+ | | +----------+---------+ +----------+---------+ | WVP-Pro实例1 | | WVP-Pro实例2 | | +----------------+ | | +----------------+ | | | ZLMediaKit集群 | | | | ZLMediaKit集群 | | | +----------------+ | | +----------------+ | +--------------------+ +--------------------+

安全加固措施：