如何快速部署GB28181视频监控平台：3步完成容器化配置

如何快速部署GB28181视频监控平台：3步完成容器化配置

【免费下载链接】wvp-GB28181-pro基于GB28181-2016、部标808、部标1078标准实现的开箱即用的网络视频平台。自带管理页面，支持NAT穿透，支持海康、大华、宇视等品牌的IPC、NVR接入。支持国标级联，支持将普通摄像机/直播流/直播推流转国标共享到国标平台。项目地址: https://gitcode.com/GitHub_Trending/wv/wvp-GB28181-pro

wvp-GB28181-pro是一款基于GB28181-2016、部标808、部标1078标准实现的开箱即用的网络视频平台，负责实现核心信令与设备管理后台部分，支持NAT穿透，支持海康、大华、宇视等品牌的IPC、NVR接入。支持国标级联，支持将不带国标功能的摄像机/直播流/直播推流转发到其他国标平台。本文将为你提供完整的容器化部署指南，让你快速搭建自己的视频监控系统。

🎯 新手面临的挑战：传统部署的痛点

在开始部署之前，让我们先看看传统部署方式会遇到哪些问题：

📋 环境预检清单

在开始部署前，请确保你的系统满足以下基本要求：

✅操作系统：Linux（推荐Ubuntu 20.04+或CentOS 7+） ✅硬件配置：至少2核CPU、4GB内存、20GB磁盘空间 ✅网络端口：确保8080、18978、8116等端口未被占用 ✅Docker环境：已安装Docker和Docker Compose

如果你还没有安装Docker，可以运行以下命令快速安装：

# Ubuntu/Debian系统 sudo apt update && sudo apt install -y docker.io docker-compose # 启动Docker服务 sudo systemctl start docker sudo systemctl enable docker

🚀 快速开始：3步完成部署

第1步：获取项目代码并准备配置

首先克隆项目仓库到本地：

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

复制环境变量配置文件：

cp .env.example .env

第2步：配置关键参数

编辑.env文件，设置以下关键参数：

# SIP信令服务器配置 SIP_Id=34020000002000000001 SIP_Domain=3402000000 SIP_Password=12345678 SIP_Port=8116 # 网络地址配置（根据实际情况修改） SIP_ShowIP=你的服务器公网IP Stream_IP=你的服务器公网IP SDP_IP=你的服务器公网IP # 数据库配置（生产环境请修改为强密码） MYSQL_ROOT_PASSWORD=your_strong_password REDIS_PASSWORD=your_strong_password # Web访问端口 WebHttp=8080

⚠️安全提醒：生产环境务必修改默认密码，避免安全风险！

第3步：启动所有服务

在docker目录下执行以下命令：

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

如果一切正常，你将看到类似以下输出：

NAME STATUS PORTS polaris-mysql Up (healthy) 3306/tcp polaris-redis Up (healthy) 6379/tcp polaris-media Up 5540/tcp, 10000/tcp, 10935/tcp polaris-wvp Up 18978/tcp, 8116/tcp, 8116/udp polaris-nginx Up 0.0.0.0:8080->8080/tcp

📊 服务架构解析：理解各个组件的作用

wvp-GB28181-pro采用微服务架构，各个组件协同工作：

各组件功能说明：

1. WVP应用服务：核心信令处理，负责GB28181协议解析和设备管理
2. ZLMediaKit：媒体流转发服务，支持RTSP、RTMP、HTTP-FLV等多种协议
3. MySQL：存储设备信息、用户数据、配置信息等
4. Redis：缓存服务，提升系统性能
5. Nginx：反向代理，提供Web访问入口

🔍 部署验证：确保一切正常

服务健康检查

运行以下命令验证各服务状态：

# 检查WVP服务日志 docker-compose logs -f polaris-wvp # 检查媒体服务日志 docker-compose logs -f polaris-media # 检查数据库连接 docker exec -it wvp-GB28181-pro-polaris-mysql-1 mysql -uwvp_user -pwvp_password -e "SHOW DATABASES;"

Web界面访问

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

使用默认账号密码登录：

• 用户名：admin
• 密码：admin

登录后立即修改默认密码，确保系统安全！

API接口测试

通过curl命令测试API接口是否正常：

curl http://localhost:18978/api/version

如果返回JSON格式的版本信息，说明API服务运行正常。

🛠️ 深度配置：优化平台性能

媒体节点配置

在Web管理界面中，你可以配置多个媒体节点实现负载均衡：

1. 进入"节点管理"菜单
2. 点击"添加节点"
3. 填写节点信息：
   • 节点名称：自定义标识
   • 节点IP：媒体服务器IP地址
   • 密钥：与媒体服务器配置一致

国标设备接入

添加国标设备的步骤：

1. 进入"设备管理" → "国标设备"
2. 点击"添加设备"
3. 填写设备信息：
   • 设备编号：符合GB28181标准的20位编码
   • 设备名称：自定义设备名称
   • SIP服务器IP：填写WVP服务器IP
   • SIP服务器端口：8116
   • SIP ID：与.env文件中的SIP_Id一致
   • 密码：与.env文件中的SIP_Password一致

级联配置

配置上级平台级联：

1. 进入"国标级联" → "上级平台"
2. 点击"添加上级平台"
3. 填写平台信息：
   • 平台名称：上级平台名称
   • SIP服务编号：上级平台SIP ID
   • SIP服务域名：上级平台域名
   • SIP服务IP/端口：上级平台地址
   • 密码：上级平台认证密码

🚨 常见问题排查指南

问题1：设备注册失败

可能原因及解决方案：

问题2：视频无法播放

排查步骤：

1. 检查媒体服务状态：docker-compose logs -f polaris-media
2. 验证端口开放：确保5540、10000等媒体端口可访问
3. 检查设备码率：降低设备视频码率测试
4. 查看网络带宽：确保上行带宽充足

问题3：Web界面无法访问

快速诊断：

# 检查Nginx服务 docker-compose logs -f polaris-nginx # 检查端口占用 netstat -tlnp | grep 8080 # 检查防火墙 sudo ufw status sudo ufw allow 8080/tcp

📈 性能优化建议

硬件配置推荐

网络优化配置

1. 端口映射优化：

   # 在docker-compose.yml中优化端口配置 ports: - "8116:8116/tcp" - "8116:8116/udp" - "10000-10100:10000-10100/udp" # RTP端口范围

2. 媒体流优化：

   • 启用UDP多端口模式提高性能
   • 配置合适的缓冲区大小
   • 根据网络状况调整码率

🔄 运维管理：保障系统稳定运行

日常监控命令

# 查看容器状态 docker-compose ps # 查看资源使用情况 docker stats # 查看实时日志 docker-compose logs -f # 备份数据库 docker exec wvp-GB28181-pro-polaris-mysql-1 mysqldump -uwvp_user -pwvp_password wvp > backup.sql

告警指标设置

建议设置以下监控告警：

✅CPU使用率：持续5分钟超过80%告警 ✅内存使用率：持续5分钟超过85%告警
✅磁盘使用率：超过85%告警 ✅服务状态：任何容器停止运行立即告警 ✅设备在线率：低于95%告警

🎯 两种部署路径选择

路径一：快速体验（适合测试环境）

如果你只是想快速体验wvp-GB28181-pro的功能：

1. 使用默认配置启动
2. 接入1-2台测试设备
3. 体验基本功能
4. 了解平台架构

路径二：生产部署（适合正式环境）

如果你需要部署到生产环境：

1. 详细规划网络架构
2. 配置SSL证书启用HTTPS
3. 设置强密码和安全策略
4. 配置备份和监控系统
5. 进行压力测试
6. 制定应急预案

📝 配置目录说明

• 官方文档：doc/
• Docker部署文件：docker/
• 数据库脚本：数据库/
• 前端代码：web/
• 后端源码：src/

💡 最佳实践建议

安全配置

1. 修改默认密码：首次登录后立即修改admin密码
2. 启用HTTPS：为Web界面配置SSL证书
3. 防火墙策略：只开放必要的端口
4. 定期更新：关注项目更新，及时升级版本

备份策略

1. 数据库备份：每天自动备份MySQL数据
2. 配置文件备份：备份.env和docker-compose.yml
3. 录像文件备份：配置定期备份到外部存储
4. 镜像备份：导出Docker镜像作为恢复点

🎬 功能演示：平台核心功能展示

云录像管理

wvp-GB28181-pro支持云端录像功能，你可以：

1. 为指定通道设置录像计划
2. 按时间查询历史录像
3. 在线播放录像文件
4. 下载录像到本地
5. 设置录像存储策略

电子地图集成

平台内置电子地图功能，支持：

• 在地图上显示设备位置
• 拖拽修改设备位置
• 百万级数据分层展示
• 支持常见地图引擎

🚀 现在就行动！

通过本文的指南，你已经掌握了wvp-GB28181-pro的完整容器化部署流程。无论你是视频监控领域的新手，还是有一定经验的开发者，都可以按照这个指南快速搭建自己的视频监控平台。

立即开始你的部署之旅：

1. 克隆项目代码：git clone https://gitcode.com/GitHub_Trending/wv/wvp-GB28181-pro.git
2. 进入docker目录：cd wvp-GB28181-pro/docker
3. 配置环境变量：编辑.env文件
4. 启动服务：docker-compose up -d
5. 访问Web界面：http://你的IP:8080

如果在部署过程中遇到任何问题，欢迎查阅项目文档或加入社区讨论。祝你部署顺利，早日构建出稳定可靠的视频监控系统！

【免费下载链接】wvp-GB28181-pro基于GB28181-2016、部标808、部标1078标准实现的开箱即用的网络视频平台。自带管理页面，支持NAT穿透，支持海康、大华、宇视等品牌的IPC、NVR接入。支持国标级联，支持将普通摄像机/直播流/直播推流转国标共享到国标平台。项目地址: https://gitcode.com/GitHub_Trending/wv/wvp-GB28181-pro