wvp-GB28181-pro容器化部署指南：从环境准备到生产级优化

wvp-GB28181-pro是一款基于GB/T28181-2016协议的开源视频监控平台，支持设备接入、视频直播、录像回放等核心功能。本文将通过容器化部署方案，帮助您快速构建稳定高效的国标视频监控系统，解决传统部署中的环境依赖复杂、配置繁琐等问题。

一、准备阶段：如何确保部署环境满足要求？

1.1 硬件资源规划表

部署wvp-GB28181-pro前，请确保服务器满足以下配置要求：

资源类型	最低配置	推荐配置	应用场景说明
CPU	4核心	8核心	影响并发视频流处理能力，推荐8核心以上支持50+路高清流
内存	8GB	16GB	视频缓存和转发需要足够内存，避免频繁GC
存储	200GB SSD	500GB SSD	录像文件存储需求大，建议使用高性能SSD
网络	千兆网卡	万兆网卡	保证视频流传输稳定性，降低延迟

1.2 软件环境检查清单

# 检查Docker是否安装
docker --version  # 需Docker 19.03+版本

# 检查Docker Compose是否安装
docker-compose --version  # 需docker-compose 1.27+版本

# 验证网络连通性
ping -c 3 gitcode.com  # 确保能访问代码仓库

⚠️ 注意：如果缺少Docker环境，请先执行以下命令安装：

# Ubuntu系统示例
sudo apt-get update && sudo apt-get install docker-ce docker-ce-cli containerd.io docker-compose-plugin

二、实施阶段：如何快速部署完整服务栈？

2.1 获取项目代码

# 克隆代码仓库
git clone https://gitcode.com/GitHub_Trending/wv/wvp-GB28181-pro.git

# 进入项目目录
cd wvp-GB28181-pro

2.2 容器编排配置

项目提供了完整的Docker Compose配置，包含WVP应用、媒体服务器、数据库等组件：

# 进入Docker配置目录
cd docker

# 查看配置文件结构
ls -la
# 关键文件说明：
# - docker-compose.yml: 服务编排主配置
# - wvp/: WVP应用配置目录
# - media/: 媒体服务器配置
# - mysql/: 数据库配置

💡 提示：建议部署前先检查docker-compose.yml中的端口映射是否与现有服务冲突，特别是8080、5540等常用端口。

2.3 一键启动服务

# 构建并后台启动所有服务
docker-compose up -d

# 查看服务启动状态
docker-compose ps

# 查看服务日志（可选）
docker-compose logs -f wvp  # 实时查看WVP应用日志

成功启动后，您将看到类似以下的服务状态输出：

Name                    Command               State           Ports         
-----------------------------------------------------------------------------
polaris-media    MediaServer -c /conf/conf ... Up      0.0.0.0:5540->5540/tcp
polaris-mysql    docker-entrypoint.sh mysqld Up      3306/tcp              
polaris-nginx    nginx -g daemon off;       Up      0.0.0.0:8080->8080/tcp
polaris-redis    redis-server /opt/polaris/r ... Up      6379/tcp
polaris-wvp      java -Xms512m -Xmx1024m ... Up      0.0.0.0:18978->18978/tcp

三、验证阶段：如何确认部署成功并排查问题？

3.1 服务健康检查

# 检查API服务可用性
curl http://localhost:18978/api/version

# 预期返回格式：
{"code":0,"msg":"success","data":"v2.7.4"}

3.2 前端界面访问

打开浏览器访问：http://服务器IP:8080，使用默认账号登录：

• 用户名：admin
• 密码：admin

登录后可看到设备列表页面，显示已接入的设备信息：

图1：wvp-GB28181-pro设备列表界面，显示设备在线状态和连接信息

3.3 媒体节点状态验证

在平台管理界面的"节点管理"页面，确认媒体服务器节点已正常注册：

图2：媒体节点管理界面，显示ZLMediaKit节点在线状态

四、优化阶段：如何配置国标级联和性能调优？

4.1 上级平台级联配置

要实现与上级国标平台的级联，需在系统中添加上级平台信息：

图3：添加上级平台配置界面，关键参数包括SIP服务器ID、地址和端口

关键配置项说明：

• SIP服务器ID：上级平台的唯一标识符，通常为20位数字
• SIP服务器地址：上级平台的IP地址或域名
• SIP服务器端口：上级平台的SIP端口，默认为5060
• 认证密码：与上级平台约定的认证密码

4.2 设备订阅参数优化

设备订阅配置直接影响设备状态更新和控制指令响应速度，建议按以下参数配置：

图4：设备订阅参数配置界面，包含订阅周期和订阅类型设置

推荐配置对比：

配置项	默认值	优化值	优化说明
心跳周期	300秒	60秒	提高设备在线状态检测灵敏度
目录订阅周期	3600秒	1800秒	平衡服务器负载和目录更新及时性
订阅类型	自动订阅	自动订阅+位置订阅	增加对设备位置信息的订阅

4.3 性能调优配置

通过修改docker-compose.yml文件，针对不同服务进行资源分配优化：

# MySQL性能优化示例
services:
  mysql:
    environment:
      MYSQL_INNODB_BUFFER_POOL_SIZE: 2G  # 缓存池大小，建议设为物理内存的50%
      MYSQL_MAX_CONNECTIONS: 1000        # 最大连接数，根据并发量调整
    deploy:
      resources:
        limits:
          cpus: '2'                      # CPU资源限制
          memory: 4G                     # 内存资源限制

# WVP应用优化示例
  wvp:
    environment:
      JAVA_OPTS: "-Xms1024m -Xmx2048m"  # JVM内存设置
    deploy:
      resources:
        limits:
          cpus: '4'
          memory: 4G

附录：部署检查清单与问题排查

部署检查清单

• [ ] 服务器硬件满足最低配置要求
• [ ] Docker及Docker Compose已正确安装
• [ ] 网络端口未被占用（8080、18978、5540等）
• [ ] 服务启动后各容器状态为Up
• [ ] API接口返回正常版本信息
• [ ] 前端页面可正常登录
• [ ] 媒体节点显示在线状态
• [ ] 至少一台设备成功注册并在线

常见问题排查流程

1. 服务启动失败

   • 检查容器日志：docker-compose logs [服务名]
   • 确认端口是否冲突：netstat -tulpn | grep 端口号
   • 检查挂载目录权限：ls -ld /path/to/mount

2. 设备注册失败

   • 检查设备网络是否可达平台
   • 验证SIP参数配置是否正确
   • 查看WVP日志中的注册请求处理过程

3. 视频无法播放

   • 检查媒体服务器是否正常运行
   • 验证端口映射是否正确
   • 查看媒体服务器日志是否有错误信息

资源监控命令速查表

# 查看容器资源使用情况
docker stats

# 查看特定容器日志
docker-compose logs -f wvp

# 查看媒体服务器状态
curl http://localhost:8080/index/api/getServerInfo

# 数据库连接数监控
docker exec -it polaris-mysql mysql -uroot -p -e "show processlist;"

通过以上步骤，您已完成wvp-GB28181-pro的容器化部署和基础配置。在实际生产环境中，建议进一步配置HTTPS、定期备份数据，并根据实际业务需求调整资源分配和性能参数。