wvp-GB28181-pro容器化部署与生产环境配置指南

wvp-GB28181-pro是一款基于GB/T28181-2016协议的开源视频平台，支持设备接入、实时视频播放、录像回放等功能。通过容器化部署可以快速搭建稳定的视频平台，本文将详细介绍从环境准备到生产环境配置的完整流程，帮助您实现wvp-GB28181-pro的快速部署和视频平台搭建。

一、环境准备：确保部署基础

1.1 硬件资源需求清单

部署wvp-GB28181-pro视频平台需要以下硬件资源支持：

• CPU：至少4核心，推荐8核心及以上。视频处理是计算密集型任务，更多核心能支持更多路视频流并发处理。
• 内存：至少8GB，推荐16GB。视频数据缓存和转发需要较大内存空间。
• 存储：至少200GB可用空间，推荐500GB以上。视频录像文件会占用大量存储空间。
• 网络：千兆网卡，推荐万兆网卡。视频流传输对网络带宽要求较高。

1.2 软件环境检查

在开始部署前，需要确保系统中已安装以下软件：

# 检查Docker是否安装
docker --version
# 检查Docker Compose是否安装
docker-compose --version

如果尚未安装Docker和Docker Compose，请先参考官方文档进行安装配置。

二、部署实施：解决关键问题

2.1 获取项目代码

问题：如何获取wvp-GB28181-pro项目代码？ 方案：通过Git克隆项目仓库到本地

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

为什么这么做：通过Git可以获取最新版本的代码，便于后续更新和维护。

2.2 配置Docker服务

问题：如何配置Docker服务以满足wvp-GB28181-pro的运行需求？ 方案：使用项目提供的Docker配置文件

# 进入docker目录
cd docker
# 查看Docker配置文件
ls -la

docker目录中包含了完整的容器化部署配置，包括docker-compose.yml、各服务Dockerfile和配置模板。这些文件定义了wvp-GB28181-pro所需的所有服务组件及其关系。

2.3 启动服务集群

问题：如何一键启动所有必要的服务？ 方案：使用docker-compose命令启动服务

# 构建并后台启动所有容器
docker-compose up -d
# 查看服务状态
docker-compose ps

为什么这么做：docker-compose可以根据配置文件一次性启动所有关联服务，确保服务之间的依赖关系正确。

正常启动后，你应该看到类似下面的输出：

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 上级平台配置

上级平台配置是实现国标级联的关键，通过以下步骤进行配置：

1. 在平台界面中，点击"国标级联"菜单，进入上级平台列表页面
2. 点击"添加"按钮，打开添加上级平台配置窗口
3. 填写必要的配置信息，包括平台名称、SIP服务器ID、IP地址与端口等

关键配置项说明：

• 平台名称：自定义标识，便于管理
• SIP服务器ID：唯一标识符，符合国标规范
• IP地址与端口：确保与上级平台网络可达
• 设备编码规则：按国标要求设置

3.2 媒体节点配置

媒体节点负责视频流的接收、转发和存储，配置界面如下：

端口映射配置示例：

ports:
  - "5540:5540"    # RTSP服务端口，用于视频流传输
  - "6080:6080"    # HTTP API端口，用于控制和管理
  - "10935:10935"  # RTMP服务端口，用于视频流分发

3.3 设备订阅配置

设备订阅配置确保设备能够正常上报状态和接收指令：

订阅周期设置建议：

• 心跳周期：60秒，用于检测设备在线状态
• 目录订阅：3600秒，用于获取设备目录信息
• 告警订阅：实时，确保及时接收设备告警信息

四、验证部署：确保系统正常运行

4.1 服务健康检查

执行以下命令验证服务是否正常运行：

# 验证WVP API服务
curl http://localhost:18978/api/version

预期返回：

{"code":0,"msg":"success","data":"v2.7.4"}

这个命令用于检查WVP服务是否正常响应，返回版本信息表示服务运行正常。

4.2 前端界面访问

打开浏览器访问：http://服务器IP:8080

默认登录信息：

• 用户名：admin
• 密码：admin

登录后可以看到设备列表界面，确认设备是否正常连接：

4.3 节点状态检查

在"节点管理"页面查看媒体节点状态，确保媒体服务正常运行：

五、性能调优：提升系统表现

5.1 资源配置优化

根据服务器硬件配置，调整Docker资源限制：

# 在docker-compose.yml中调整服务资源限制
services:
  wvp:
    deploy:
      resources:
        limits:
          cpus: '4'
          memory: 8G

为什么这么做：合理分配资源可以避免某个服务占用过多资源而影响其他服务运行。

5.2 数据库优化

对MySQL数据库进行优化配置：

# MySQL优化配置
environment:
  MYSQL_INNODB_BUFFER_POOL_SIZE: 2G  # 缓存池大小，建议设为系统内存的50%
  MYSQL_MAX_CONNECTIONS: 1000        # 最大连接数，根据并发量调整

六、安全加固：保障系统安全

6.1 访问控制

• 修改默认管理员密码：登录后立即修改admin用户的默认密码
• 配置IP访问限制：在Nginx中设置允许访问的IP白名单
• 启用HTTPS：配置SSL证书，确保数据传输安全

6.2 容器安全

• 使用非root用户运行容器
• 定期更新容器镜像
• 限制容器的系统调用权限

七、生产环境注意事项

7.1 数据备份策略

• 定期备份MySQL数据库
• 配置录像文件的自动备份
• 制定数据恢复预案

7.2 监控与告警

• 部署系统监控工具，监控服务器资源使用情况
• 设置关键服务的告警机制
• 定期检查日志文件，及时发现问题

7.3 系统更新

• 制定系统更新计划
• 测试环境验证更新内容
• 生产环境灰度更新

通过以上步骤，您可以完成wvp-GB28181-pro的容器化部署并配置生产环境。这种部署方式不仅简化了部署流程，还提供了更好的可维护性和扩展性。在实际运行过程中，根据具体需求进行适当的配置调整和优化，可以获得更好的系统性能和稳定性。