5个实战步骤：wvp-GB28181-pro国标视频平台完全指南

wvp-GB28181-pro是一款基于GB/T 28181标准的开源视频平台，提供设备接入、视频监控、级联部署和云镜控制等核心功能。通过容器化部署方案，可快速构建生产级视频监控系统，实现设备统一管理与媒体流高效转发，满足安防监控、智慧园区等场景需求。

🚀 项目核心价值

wvp-GB28181-pro作为国标视频平台的佼佼者，其核心价值体现在三个维度：

标准化接入能力

全面支持GB/T 28181-2016标准，可无缝对接主流品牌摄像头、NVR设备，解决多厂商设备兼容问题。系统内置完善的设备注册、认证机制，确保设备接入安全可控。

灵活的级联架构

采用分布式架构设计，支持多级平台级联部署，可构建省-市-县多级监控网络，满足大型监控系统的层级化管理需求。

完整的媒体处理能力

集成ZLMediaKit媒体服务器，提供RTSP/RTMP/HTTP等多协议流转发，支持实时视频播放、录像存储、云镜控制等功能，满足多样化媒体应用场景。

🏗️ 架构解析

wvp-GB28181-pro采用微服务架构设计，通过Docker容器实现服务解耦与编排，整体架构如下：

用户请求 → Nginx → WVP应用服务 → 数据层(MySQL/Redis) → ZLMediaKit媒体服务

核心组件说明

服务组件	功能描述	端口映射	技术栈
WVP应用服务	国标信令处理、业务逻辑实现	18978(API)/8116(SIP)	Spring Boot
ZLMediaKit	媒体流转发、录像存储	5540(RTSP)/6080(HTTP)	C++
MySQL数据库	存储设备信息、用户数据	3306	MySQL 5.7+
Redis缓存	会话管理、状态缓存	6379	Redis 5.0+
Nginx代理	前端资源、API反向代理	8080	Nginx

级联平台列表界面展示了已配置的上级平台信息，包括平台编号、状态、地址等关键参数

🔧 部署流程：准备-配置-部署-验证-拓展

阶段1：环境准备

1. 安装依赖软件

   # 更新系统包
   sudo apt update && sudo apt upgrade -y
   
   # 安装Docker和Docker Compose
   sudo apt install -y docker.io docker-compose
   
   # 启动Docker服务并设置开机自启
   sudo systemctl enable --now docker
   

2. 获取项目代码

   git clone https://gitcode.com/GitHub_Trending/wv/wvp-GB28181-pro.git
   cd wvp-GB28181-pro
   

阶段2：配置调整

1. 进入配置目录

   cd docker
   

2. 修改核心配置 编辑.env文件，设置关键参数：

   # SIP服务器IP地址，必须修改为实际服务器IP
   SIP_HOST=192.168.1.100
   
   # 媒体流服务器IP地址
   STREAM_HOST=192.168.1.100
   
   # 数据库密码，生产环境需设置强密码
   MYSQL_ROOT_PASSWORD=StrongPassword123
   

级联平台配置界面展示了SIP服务器编码、地址、端口等关键参数设置项

阶段3：部署实施

1. 构建Docker镜像

   # 构建所有服务镜像，首次运行需下载依赖，耗时较长
   docker-compose build
   

2. 启动服务集群

   # 后台启动所有服务
   docker-compose up -d
   
   # 查看服务状态
   docker-compose ps
   

3. 初始化数据库

   # 等待MySQL服务启动完成后执行初始化脚本
   docker-compose exec mysql mysql -uroot -pStrongPassword123 < /docker-entrypoint-initdb.d/wvp.sql
   

阶段4：验证测试

1. 检查服务状态

   # 查看WVP应用日志
   docker-compose logs -f polaris-wvp
   
   # 验证API接口
   curl http://localhost:18978/api/version
   

2. 访问Web管理界面

   • 打开浏览器访问：http://服务器IP:8080
   • 默认账号：admin，默认密码：admin

3. 验证级联功能

   # 查看级联状态
   curl http://localhost:18978/api/gb28181/cascade
   

级联部署状态验证界面显示了上下级平台的连接状态和设备在线情况

阶段5：功能拓展

1. 添加媒体节点 通过管理界面"节点管理"添加额外的ZLMediaKit媒体节点，实现负载均衡。

2. 配置存储策略 修改docker-compose.yml文件，配置NFS存储卷实现录像文件的持久化存储。

3. 集成第三方系统 通过API接口将视频流集成到第三方平台，实现数据互通。

⚙️ 功能配置详解

设备管理配置

1. 添加国标设备
   • 进入"设备管理" → "国标设备" → "添加设备"
   • 填写设备编号、IP地址、端口、密码等信息
   • 选择传输协议（UDP/TCP）并启用设备

设备列表管理界面展示了已接入设备的状态、连接信息和操作选项

2. 通道管理
   • 设备添加成功后，系统自动获取通道信息
   • 可对通道进行分组管理、名称修改、状态监控

级联部署配置

1. 上级平台配置

   • 进入"国标级联" → "上级平台" → "添加"
   • 配置上级平台SIP ID、地址、端口等参数
   • 设置心跳周期和注册有效期

2. 下级平台接入

   • 在下级平台配置当前平台为上级
   • 配置信令传输模式和媒体流转发策略
   • 验证级联状态和设备共享情况

录像管理配置

1. 云录像设置
   • 进入"云录像" → "录像计划" → "添加"
   • 选择设备通道和录像时间策略
   • 配置存储路径和保留天数

云镜录像管理界面展示了录像文件列表、存储状态和操作选项

2. 录像回放
   • 选择设备通道和时间范围
   • 支持按时间轴拖动定位
   • 提供下载、分享等操作功能

🚨 问题排查

设备注册失败

排查步骤：

1. 检查设备网络连接和防火墙设置

   # 测试设备网络连通性
   ping 设备IP地址
   
   # 检查端口开放情况
   telnet 设备IP地址 5060
   

2. 验证SIP参数配置

   • 确认设备SIP ID与平台配置一致
   • 检查认证密码是否正确
   • 尝试切换传输协议（UDP/TCP）

视频流无法播放

解决方案：

1. 检查媒体服务状态

   # 查看ZLMediaKit日志
   docker-compose logs -f polaris-media
   

2. 验证流地址有效性

   # 使用ffplay测试流播放
   ffplay rtsp://服务器IP:5540/stream/通道ID
   

3. 检查WVP与ZLMediaKit密钥是否一致

   • 对比application.yml中的media.zlm.secret配置
   • 确保媒体服务器与应用服务密钥匹配

录像文件无法生成

排查要点：

1. 检查存储目录权限

   # 进入媒体容器检查存储目录
   docker-compose exec polaris-media ls -ld /opt/media
   

2. 验证磁盘空间

   # 查看磁盘使用情况
   df -h
   

3. 检查录像计划配置

   • 确认录像计划已启用
   • 验证时间范围和重复策略设置

媒体节点管理界面显示了ZLMediaKit节点状态和连接信息

💡 最佳实践

系统优化建议

1. 性能调优

   • 根据设备数量调整数据库连接池大小

   # application.yml
   spring:
     datasource:
       hikari:
         maximum-pool-size: 20  # 设备数量超过100路时建议调整为20-30
   

   • 配置媒体服务器缓存策略

   # ZLMediaKit配置
   [hls]
   hls_max_ts_dur=5
   hls_list_size=3
   

2. 安全加固

   • 修改默认管理员密码
   • 配置HTTPS加密

   # 生成SSL证书
   openssl req -new -newkey rsa:2048 -nodes -keyout server.key -out server.csr
   openssl x509 -req -days 365 -in server.csr -signkey server.key -out server.crt
   

   • 限制API访问IP

3. 高可用部署

   • 配置MySQL主从复制
   • 实现WVP服务多实例部署
   • 使用负载均衡分发请求

进阶使用建议

1. 二次开发

   • 基于提供的API接口开发自定义业务功能
   • 扩展设备接入协议支持
   • 开发专用客户端应用

2. 集成第三方系统

   • 与GIS系统集成实现地图监控
   • 对接AI分析平台实现智能识别
   • 集成告警系统实现事件联动

3. 监控与运维

   • 部署Prometheus+Grafana监控系统指标
   • 配置日志收集与分析
   • 设置关键指标告警机制

📝 总结

wvp-GB28181-pro通过容器化部署方案，实现了国标视频平台的快速搭建与灵活扩展。其核心优势包括：

• 标准化兼容：全面支持GB/T 28181标准，兼容主流厂商设备
• 快速部署：5步完成生产级环境搭建，降低部署门槛
• 灵活扩展：支持级联部署和媒体节点扩展，满足不同规模需求
• 完整功能：提供设备管理、视频监控、录像存储等全方位功能

通过本文档的指导，您已掌握wvp-GB28181-pro的部署与配置方法。建议继续深入学习以下内容：

1. 研究API文档，开发自定义业务功能
2. 探索级联部署高级特性，构建大规模监控网络
3. 优化媒体服务配置，提升系统性能与稳定性

wvp-GB28181-pro作为成熟的开源国标视频平台，为安防监控、智慧园区等场景提供了可靠的技术解决方案，值得在实际项目中推广应用。