wvp-GB28181-pro视频监控平台企业级部署指南

目录导航

• 战略选择层
• 战术实施层
• 运维保障层

战略选择层：部署模式决策指南

多维度部署决策矩阵

评估维度	轻量部署方案	标准部署方案	边缘节点部署方案	集群部署方案
适用场景	小型监控系统（<50路）	中型企业应用（50-200路）	分布式边缘场景	大型监控网络（>500路）
数据规模	低（<1TB/月）	中（1-5TB/月）	中高（2-8TB/月）	高（>10TB/月）
实时性要求	一般（<1s延迟）	较高（<500ms延迟）	高（<300ms延迟）	高（<300ms延迟）
硬件要求	2核4G/50GB SSD	4核8G/200GB SSD	4核8G/500GB SSD	8核16G×3+/1TB SSD×3+
部署复杂度	★☆☆☆☆	★★☆☆☆	★★★☆☆	★★★★★
配置优先级	快速可用	稳定性	低带宽消耗	高可用性

注意：实时性要求高的场景（如交通监控）建议选择边缘或集群部署方案，通过本地化处理减少网络延迟

部署模式技术对比

技术指标	轻量部署	标准部署	边缘节点部署	集群部署
设备接入能力	50路	200路	150路/节点	无上限（水平扩展）
冗余机制	无	基础冗余	本地自治	全链路冗余
网络依赖	高	中	低	中高
维护成本	低	中	中高	高
扩展方式	垂直扩展	垂直+有限水平扩展	地理分布式扩展	无限水平扩展

战术实施层：环境构建与配置流程

环境准备与依赖检查

基础设施要求

组件	版本要求	配置优先级	资源分配建议
操作系统	Ubuntu 22.04 LTS	高	最小20GB系统空间
Docker	24.0.0+	高	至少2GB运行内存
Docker Compose	2.18.0+	高	-
数据库	MySQL 8.0+	中	4GB内存/50GB存储
Redis	6.2+	中	2GB内存
网络带宽	100Mbps+	高	每50路视频增加50Mbps

环境初始化操作

# 克隆项目代码
git clone https://gitcode.com/GitHub_Trending/wv/wvp-GB28181-pro
cd wvp-GB28181-pro

# 环境依赖检查
./install.sh --check

# 赋予执行权限
chmod +x run.sh docker/*.sh

注意：install.sh脚本会自动检测系统依赖，缺失组件将给出安装建议，建议在root权限下执行

标准部署实施步骤

1. 环境变量配置

创建.env配置文件，注入核心环境变量：

# 数据库配置
DB_HOST=mysql
DB_PORT=3306
DB_NAME=wvp_db
DB_USER=wvp_user
DB_PASSWORD=StrongP@ssw0rd

# 服务配置
WVP_SIP_IP=192.168.1.100
WVP_SIP_PORT=5060
WVP_SIP_DOMAIN=4101050000
WVP_MEDIA_PORT_START=30000
WVP_MEDIA_PORT_END=30500

# 性能配置
WVP_THREAD_POOL_SIZE=200
WVP_MAX_DEVICES=500

2. Docker服务编排

# 进入Docker部署目录
cd docker

# 构建并启动服务
docker-compose --env-file ../.env up -d --build

# 查看服务状态
docker-compose ps

服务启动成功后应显示所有容器状态为"Up"，首次启动约需3-5分钟初始化数据库。

3. 系统初始化验证

# 检查服务健康状态
docker-compose exec wvp curl -s http://localhost:18080/api/health | jq .status

# 验证数据库表结构
docker-compose exec mysql mysql -u$DB_USER -p$DB_PASSWORD -e "use $DB_NAME; show tables;" | grep sip_device

注意：健康检查返回"UP"状态仅表示服务启动成功，还需通过管理界面验证功能可用性

设备接入流程

以下是标准GB28181设备接入流程图：

1. 平台配置准备

   • 登录管理后台（http://服务器IP:18080）
   • 进入"系统设置→国标配置"
   • 设置SIP服务器参数并保存

2. 设备参数配置

   • 设备端设置SIP服务器地址（WVP_SIP_IP）
   • 配置设备国标编码（3402000000xxxxxx）
   • 设置传输协议（建议TCP）

3. 平台添加设备

   • 进入"设备管理→设备列表"
   • 点击"添加设备"按钮
   • 填写设备信息并提交

4. 设备状态验证

   • 查看设备列表状态列显示"在线"
   • 点击"预览"按钮验证视频流
   • 检查"最近心跳"时间戳更新

图1：设备管理界面展示已接入的在线设备列表

边缘节点部署补充方案

针对分布式部署场景，边缘节点部署步骤：

# 1. 配置边缘节点标识
export EDGE_NODE_ID=edge-node-01

# 2. 启动边缘节点服务
docker-compose -f docker-compose.edge.yml up -d

# 3. 注册到中心平台
docker-compose exec wvp-edge ./register_edge.sh http://center-server:18080

注意：边缘节点需确保与中心平台网络互通，建议配置VPN或专线连接

运维保障层：性能优化与故障处理

性能调优策略

系统参数优化

通过环境变量调整关键性能参数：

# JVM性能优化
WVP_JVM_OPTS="-Xms2g -Xmx4g -XX:+UseG1GC -XX:MaxGCPauseMillis=200"

# 连接池配置
DB_POOL_SIZE=30
DB_MAX_WAIT=5000
REDIS_POOL_SIZE=20

# 媒体处理优化
MEDIA_PROCESS_THREADS=8
RTP_PACKET_CACHE_SIZE=100

水平扩展性能对比

节点数量	设备接入能力	并发预览路数	平均视频延迟	CPU利用率
1节点	200路	50路	450ms	65%
2节点	450路	120路	380ms	55%
3节点	700路	200路	320ms	45%

图2：系统信息配置界面展示关键性能参数

故障处理决策树

设备注册失败排查流程

1. 网络连通性检查

   # 测试设备到平台的网络连通性
   ping $WVP_SIP_IP
   nc -zv $WVP_SIP_IP $WVP_SIP_PORT
   

2. 配置一致性验证

   • 确认设备与平台SIP域一致
   • 核对注册密码是否匹配
   • 检查设备编码格式是否正确

3. 日志分析

   # 查看SIP注册日志
   docker-compose logs wvp | grep -i "REGISTER"
   

4. 防火墙设置

   # 检查端口开放情况
   ufw status | grep $WVP_SIP_PORT
   

视频流异常排查决策树

视频流异常
├─ 检查设备状态 → 离线
│  ├─ 检查网络连接
│  ├─ 重启设备服务
│  └─ 检查设备电源
└─ 设备在线
   ├─ 检查媒体端口范围是否开放
   ├─ 查看媒体服务日志
   │  ├─ 资源不足 → 增加系统资源
   │  └─ 编码不支持 → 更新媒体处理模块
   └─ 测试本地预览
      ├─ 正常 → 检查网络带宽
      └─ 异常 → 检查设备视频输出

系统扩展策略

存储扩展方案

当存储空间不足时，可通过以下步骤扩展：

1. 添加新存储卷

   # 创建新存储目录
   mkdir -p /data/wvp/new_storage
   
   # 修改docker-compose.yml添加新卷
   # 在wvp服务下添加:
   # volumes:
   #   - /data/wvp/new_storage:/opt/wvp/media/new
   

2. 配置存储策略

   • 进入"系统设置→存储管理"
   • 添加新存储路径
   • 设置文件老化策略（如7天自动清理）

级联扩展配置

多平台级联部署步骤：

1. 在上级平台添加下级平台信息

   图3：国标级联配置界面展示上级平台列表

2. 下级平台配置上级参数

   # 级联配置环境变量
   CASCADE_ENABLE=true
   CASCADE_UPPER_IP=10.0.0.10
   CASCADE_UPPER_PORT=5060
   CASCADE_UPPER_DOMAIN=3402000000
   CASCADE_UPPER_USER=34020000001380000001
   CASCADE_PASSWORD=UpperCascade@123
   

3. 验证级联状态

   # 查看级联注册状态
   docker-compose logs wvp | grep -i "cascade register"
   

注意：级联部署时需确保各级平台时间同步，建议配置NTP服务

日常运维最佳实践

自动化运维脚本

创建maintain.sh实现定期维护：

#!/bin/bash
# 系统维护脚本

# 1. 日志清理（保留7天）
find ./logs -name "*.log" -mtime +7 -delete

# 2. 数据库备份
docker-compose exec mysql mysqldump -u$DB_USER -p$DB_PASSWORD $DB_NAME > /backup/wvp_$(date +%Y%m%d).sql

# 3. 检查服务状态
docker-compose ps | grep -v "Up" | awk 'NR>1 {print $1}' | xargs -I {} docker-compose restart {}

# 4. 系统资源监控
top -b -n 1 > /monitor/$(date +%Y%m%d_%H%M%S).log

监控指标配置

编辑docker/nginx/templates/nginx.conf.template添加监控：

# 配置Prometheus监控指标
location /metrics {
    stub_status on;
    access_log off;
    allow 192.168.1.0/24;  # 限制监控服务器IP
    deny all;
}

图4：通道管理界面展示设备组织与状态监控

总结与建议

wvp-GB28181-pro平台部署应根据实际业务需求选择合适的部署模式，小型应用推荐轻量部署方案，中大型系统建议采用标准或集群部署方案。实施过程中需特别注意网络配置、设备兼容性和性能调优三个关键环节。

对于有分布式部署需求的场景，边缘节点方案可有效降低网络带宽压力并提高系统可靠性。日常运维中，建议建立完善的监控体系和自动化维护流程，确保系统长期稳定运行。

随着业务增长，可通过水平扩展和级联部署两种方式扩展系统容量，两种方式可独立或组合使用，以适应不同规模的监控需求。