开源视频平台wvp-GB28181-pro容器化部署指南

wvp-GB28181-pro是一款基于GB/T 28181标准的开源视频平台，支持设备接入、视频监控、级联部署等核心功能。本文提供完整的容器化部署方案，帮助您快速搭建生产级视频监控系统。

环境准备

部署前检查清单

在开始部署前，请确保您的环境满足以下条件：

• 操作系统：Linux（推荐Ubuntu 20.04+或CentOS 7+）
• Docker版本：20.10.0+
• Docker Compose版本：2.0.0+
• 硬件要求：至少2核CPU、4GB内存、50GB可用磁盘空间
• 网络要求：开放8080、18978、8116等必要端口

安装依赖组件

执行以下命令安装Docker和Docker Compose：

# 更新系统包
sudo apt update && sudo apt upgrade -y

# 安装Docker
sudo apt install -y docker.io docker-compose

# 启动Docker服务并设置开机自启
sudo systemctl start docker
sudo systemctl enable docker

⚠️注意：如果您使用的是CentOS系统，请使用yum命令替换apt命令进行安装。

获取项目代码

克隆wvp-GB28181-pro项目代码到本地：

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

架构解析

系统架构概览

wvp-GB28181-pro采用微服务架构，通过Docker Compose实现服务编排，整体架构如下：

用户请求 → Nginx → WVP应用 → MySQL/Redis → ZLMediaKit

核心组件说明：

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

级联部署架构

wvp-GB28181-pro支持多级平台级联部署，实现大规模视频监控系统的构建：

级联平台列表界面展示

级联部署架构具有以下优势：

• 支持多层级平台互联
• 实现设备资源统一管理
• 提高系统可靠性和可扩展性

部署实施

配置文件修改

进入docker目录，修改核心配置参数：

cd docker

编辑docker-compose.yml文件，设置关键参数：

• SIP_HOST：SIP信令服务器IP地址
• STREAM_HOST：媒体流服务器IP地址
• 数据库密码（生产环境必须修改默认密码）

级联参数配置弹窗

⚠️注意：确保SIP_HOST和STREAM_HOST设置为服务器的公网IP地址，否则设备将无法正常连接。

容器构建与启动

执行以下命令构建并启动容器：

# 构建镜像
docker-compose build

# 后台启动服务
docker-compose up -d

容器状态检查命令速查表

命令	说明
docker-compose ps	查看所有服务状态
docker-compose logs -f polaris-wvp	查看WVP应用日志
docker-compose logs -f polaris-media	查看媒体服务日志
docker-compose restart polaris-wvp	重启WVP应用服务
docker-compose down	停止并移除所有容器
docker-compose exec polaris-mysql mysql -u root -p	进入MySQL容器

功能验证

服务状态验证

服务启动后，执行以下命令验证各服务是否正常运行：

# 检查容器状态
docker-compose ps

# 测试API接口
curl http://localhost:18978/api/version

如果一切正常，API接口将返回当前系统版本信息。

设备接入测试

登录Web管理界面（http://localhost:8080），默认账号：admin/admin。添加设备并验证接入功能：

1. 进入"设备管理"页面，点击"添加设备"
2. 填写设备信息，包括设备编码、IP地址、端口等
3. 点击"保存"并等待设备注册上线

级联部署状态验证

视频播放测试

在设备列表中找到已上线的设备，点击"预览"按钮测试视频播放功能。如果视频无法正常播放，请检查媒体服务是否运行正常。

运维优化

媒体服务监控

wvp-GB28181-pro提供了媒体服务节点管理功能，可以实时监控媒体服务状态：

媒体节点管理界面

通过节点管理界面，您可以：

• 查看媒体服务运行状态
• 监控流数量和资源占用
• 进行节点扩容和负载均衡

性能调优建议

为提高系统性能，建议进行以下优化：

1. 数据库优化：

   • 调整MySQL连接池大小，根据设备数量适当增加
   • 定期清理历史数据，保持数据库性能

2. 媒体服务优化：

   • 根据并发流数量调整ZLMediaKit的配置参数
   • 启用硬件编解码加速（如支持）

3. 网络优化：

   • 使用千兆以上网络环境
   • 配置适当的MTU值，减少网络分片

问题排查指南

常见问题及解决方案：

1. 设备注册失败：

   • 检查SIP服务器IP和端口是否配置正确
   • 确认设备端和国标平台的编码、密码一致
   • 检查防火墙是否开放相关端口

2. 视频播放卡顿：

   • 检查网络带宽是否充足
   • 降低视频码率或分辨率
   • 检查服务器资源使用情况，是否存在CPU或内存瓶颈

3. 录像文件无法生成：

   • 检查存储路径权限是否正确
   • 确认磁盘空间是否充足
   • 检查ZLMediaKit录像配置是否正确

通过以上步骤，您已成功部署并优化了wvp-GB28181-pro视频平台。该方案具有环境隔离、快速部署、易于维护和扩展性强等优势，能够满足各类视频监控场景需求。