wvp-GB28181-pro 国标视频平台完整部署实战指南

wvp-GB28181-pro 国标视频平台完整部署实战指南【免费下载链接】wvp-GB28181-pro基于GB28181-2016、部标808、部标1078标准实现的开箱即用的网络视频平台。自带管理页面支持NAT穿透支持海康、大华、宇视等品牌的IPC、NVR接入。支持国标级联支持将普通摄像机/直播流/直播推流转国标共享到国标平台。项目地址: https://gitcode.com/GitHub_Trending/wv/wvp-GB28181-prowvp-GB28181-pro是一款基于GB/T 28181-2016国标协议的开源视频平台完整支持SIP信令与RTP媒体流传输实现多厂商设备统一接入、跨平台级联互通、智能云录像管理等核心功能。该平台专为安防监控、智慧城市、企业园区等场景设计支持海康、大华、宇视等主流品牌IPC、NVR设备接入是构建现代化视频监控系统的理想选择。第一阶段环境准备与规划1.1 系统环境核查在开始部署前请确保系统满足以下基础条件环境组件最低要求推荐配置操作系统Linux/CentOS 7Ubuntu 20.04Docker20.1024.0Docker Compose2.02.20内存4GB8GB存储空间50GB200GBCPU核心2核4核系统依赖检查步骤# 检查Docker版本 docker --version # 检查Docker Compose版本 docker-compose --version # 检查系统资源 free -h df -h # 检查端口占用情况关键端口 netstat -tlnp | grep -E 5060|8080|18978|30000-305001.2 项目结构与资源分析项目目录解析wvp-GB28181-pro/ ├── docker/ # 容器化部署配置中心 │ ├── docker-compose.yml # 核心服务编排文件 │ ├── wvp/ # WVP应用配置 │ ├── media/ # ZLMediaKit配置 │ ├── mysql/ # 数据库配置 │ └── redis/ # Redis配置 ├── src/ # Java后端业务逻辑 ├── web/ # Vue前端用户界面 ├── 数据库/ # 各版本SQL初始化脚本 │ ├── 2.7.4/ # 最新版本数据库脚本 │ └── old/ # 历史版本升级脚本 └── 打包/ # 打包配置文件关键配置文件说明docker/docker-compose.yml服务编排主文件定义所有容器服务docker/wvp/wvp/application-docker.ymlWVP应用Docker环境配置docker/media/config.iniZLMediaKit媒体服务器配置数据库/2.7.4/初始化-mysql-2.7.4.sql数据库初始化脚本1.3 网络与端口规划端口分配方案服务端口协议用途说明WVP管理界面8080HTTP平台Web管理界面访问WVP API接口18978HTTP后端API服务端口SIP信令服务8116TCP/UDPGB28181信令通信端口ZLMediaKit HTTP8080HTTP媒体流HTTP访问端口ZLMediaKit RTMP10935TCP/UDPRTMP流接收端口ZLMediaKit RTSP5540TCP/UDPRTSP流接收端口ZLMediaKit RTP10000TCP/UDPRTP流接收端口MySQL数据库3306TCP数据库服务端口Redis缓存6379TCP缓存服务端口防火墙配置建议# 开放关键端口Ubuntu/Debian sudo ufw allow 8080/tcp sudo ufw allow 18978/tcp sudo ufw allow 8116/tcp sudo ufw allow 8116/udp sudo ufw allow 10000:10500/tcp # 媒体流端口范围 sudo ufw allow 10000:10500/udp # 开放关键端口CentOS/RHEL sudo firewall-cmd --permanent --add-port8080/tcp sudo firewall-cmd --permanent --add-port18978/tcp sudo firewall-cmd --permanent --add-port8116/tcp sudo firewall-cmd --permanent --add-port8116/udp sudo firewall-cmd --permanent --add-port10000-10500/tcp sudo firewall-cmd --permanent --add-port10000-10500/udp sudo firewall-cmd --reload第二阶段核心服务部署2.1 基础服务安装一键部署命令# 克隆项目源码 git clone https://gitcode.com/GitHub_Trending/wv/wvp-GB28181-pro cd wvp-GB28181-pro # 进入docker目录 cd docker # 启动所有服务后台运行 docker-compose up -d服务启动验证# 检查容器运行状态 docker-compose ps # 查看服务启动日志 docker-compose logs polaris-wvp docker-compose logs polaris-media # 检查服务健康状态 docker-compose exec polaris-redis redis-cli ping docker-compose exec polaris-mysql mysql -u wvp_user -p wvp_password -e SELECT 1⚠️注意事项首次启动需要下载Docker镜像时间取决于网络速度确保docker-compose.yml中的端口未被占用如果使用自定义端口请修改环境变量配置2.2 平台初始化配置管理界面访问访问地址http://localhost:8080默认账号admin默认密码admin基础参数设置登录系统使用默认账号密码登录管理界面系统配置进入系统管理 → 参数配置SIP服务器配置SIP服务器ID34020000002000000001SIP服务器域3402000000SIP服务器端口8116SIP认证密码设置安全密码媒体服务器配置媒体服务器IDpolaris媒体服务器IP本机IP地址HTTP端口8080RTP端口范围30000-305002.3 功能模块激活核心功能启用步骤设备管理模块确认设备管理功能已启用配置设备接入参数测试设备注册功能云录像模块配置录像存储路径设置录像计划测试录像回放功能平台级联模块配置上级平台信息设置级联参数测试级联通信用户管理模块创建管理员账户设置角色权限配置API访问密钥模块依赖关系说明设备管理 → 依赖 → 媒体服务器 云录像 → 依赖 → 存储服务 平台级联 → 依赖 → SIP服务 用户管理 → 依赖 → 数据库服务第三阶段功能集成与验证3.1 外部设备接入设备注册流程设备端配置# 国标设备配置示例 SIP服务器地址192.168.1.100 SIP服务器端口8116 设备编号34020000001320000001 SIP域3402000000 认证密码[设置的密码]平台端操作进入国标设备 → 设备列表点击添加设备按钮填写设备基本信息保存配置并等待设备注册注册状态验证检查设备状态显示在线验证设备心跳信息确认通道信息同步协议配置要点GB28181-2016协议版本SIP传输协议TCP/UDP编码格式H.264/H.265视频分辨率支持多种格式音频编码G.711/G.7263.2 核心功能测试功能验证清单功能模块测试项目预期结果验证方法实时视频单路播放视频流畅无卡顿点击播放按钮实时视频多路分屏多路同时播放选择分屏模式云录像手动录制录像文件生成点击录制按钮云录像定时录制按计划生成录像配置录像计划录像回放时间轴回放可正常播放选择时间段设备控制PTZ控制云台正常转动操作控制面板设备控制预置位调用快速定位到预设位置调用预置位报警管理移动侦测触发报警通知模拟移动事件性能基准测试# 并发连接测试 ab -n 1000 -c 100 http://localhost:8080/ # 视频流延迟测试 ffmpeg -i rtsp://admin:password192.168.1.101:554/stream -f null - # 数据库性能测试 docker-compose exec polaris-mysql mysql -u wvp_user -p wvp_password -e SHOW STATUS LIKE Threads_connected;3.3 系统集成验证API接口测试# 测试API健康检查 curl http://localhost:18978/api/version # 测试设备列表API curl -X GET http://localhost:18978/api/device/list?page1count10 \ -H Authorization: Bearer [token] # 测试视频流API curl -X POST http://localhost:18978/api/play/start \ -H Content-Type: application/json \ -d {deviceId:34020000001320000001,channelId:34020000001320000001}数据同步检查设备信息同步验证设备信息从数据库正确读取检查Redis缓存设备状态确认前端显示与实际状态一致录像文件同步检查录像文件存储位置验证录像索引生成测试录像文件检索功能用户权限同步测试不同角色权限限制验证API访问控制检查操作日志记录第四阶段运维与优化4.1 日常监控配置监控指标设置监控项目监控指标告警阈值检查频率系统资源CPU使用率80%每分钟系统资源内存使用率85%每分钟系统资源磁盘使用率90%每小时网络状态端口连通性不可达每分钟服务状态容器健康状态不健康每分钟业务指标在线设备数异常波动每5分钟业务指标并发流数量100路每分钟业务指标录像存储量90%每小时告警规则定义# Prometheus告警规则示例 groups: - name: wvp_alerts rules: - alert: HighCPUUsage expr: rate(process_cpu_seconds_total{jobwvp}[5m]) * 100 80 for: 5m labels: severity: warning annotations: summary: WVP CPU使用率过高 description: {{ $labels.instance }} CPU使用率超过80%持续5分钟 - alert: DeviceOffline expr: wvp_device_status 0 for: 3m labels: severity: critical annotations: summary: 设备离线告警 description: 设备 {{ $labels.device_id }} 已离线超过3分钟4.2 性能调优建议系统参数优化JVM参数调整# application-docker.yml中添加 server: tomcat: max-threads: 200 min-spare-threads: 20 spring: datasource: hikari: maximum-pool-size: 20 minimum-idle: 5Redis缓存优化# redis.conf配置优化 maxmemory 2gb maxmemory-policy allkeys-lru timeout 300 tcp-keepalive 60数据库优化-- 创建索引优化查询性能 CREATE INDEX idx_device_status ON wvp_device (status); CREATE INDEX idx_record_time ON wvp_cloud_record (start_time, end_time); CREATE INDEX idx_user_login ON wvp_user (username, login_time);资源分配策略服务组件内存分配CPU分配存储分配WVP应用2-4GB2-4核10GBZLMediaKit4-8GB4-8核100GBMySQL数据库2-4GB2-4核50GBRedis缓存1-2GB1-2核2GB4.3 故障排查指南常见问题分析设备注册失败可能原因 - 网络连通性问题 - SIP参数配置不一致 - 防火墙端口未开放 - 设备编号冲突 排查步骤 1. ping设备IP验证连通性 2. 检查SIP服务器配置 3. 查看WVP应用日志 4. 验证设备端配置视频播放异常可能原因 - 媒体服务器未正常运行 - 端口映射错误 - 编码格式不支持 - 网络带宽不足 排查步骤 1. 检查ZLMediaKit服务状态 2. 验证端口映射配置 3. 检查设备编码格式 4. 测试网络带宽录像功能异常可能原因 - 存储空间不足 - 文件权限问题 - 录像计划配置错误 - 数据库连接异常 排查步骤 1. 检查磁盘空间使用率 2. 验证存储目录权限 3. 检查录像计划配置 4. 测试数据库连接日志分析方法# 查看WVP应用日志 docker-compose logs polaris-wvp --tail 100 # 查看媒体服务器日志 docker-compose logs polaris-media --tail 100 # 查看数据库日志 docker-compose logs polaris-mysql --tail 50 # 实时监控日志 docker-compose logs -f polaris-wvp # 搜索特定错误 docker-compose logs polaris-wvp | grep -i error\|exception\|fail部署成功确认清单✅环境准备完成系统环境满足最低要求端口规划合理防火墙配置正确✅核心服务运行正常所有Docker容器正常运行服务健康检查通过✅平台初始化成功管理界面可正常访问基础参数配置完成✅设备接入功能正常国标设备可成功注册设备状态显示在线✅视频功能验证通过实时视频播放流畅云录像功能正常✅平台级联配置完成上级平台对接成功通道共享功能正常✅系统集成验证通过API接口正常响应数据同步准确✅监控告警配置完成系统监控指标设置合理告警规则生效进阶配置可选高可用部署集群配置方案负载均衡配置# Nginx负载均衡配置 upstream wvp_servers { server 192.168.1.101:18978 weight3; server 192.168.1.102:18978 weight2; server 192.168.1.103:18978 weight2; keepalive 32; } upstream media_servers { server 192.168.1.101:8080; server 192.168.1.102:8080; server 192.168.1.103:8080; }数据库主从复制-- 主库配置 [mysqld] server-id1 log-binmysql-bin binlog-formatROW -- 从库配置 [mysqld] server-id2 relay-logmysql-relay-bin read-only1Redis哨兵模式# docker-compose高可用配置 services: redis-master: image: redis:latest command: redis-server --requirepass yourpassword --masterauth yourpassword redis-slave: image: redis:latest command: redis-server --slaveof redis-master 6379 --requirepass yourpassword redis-sentinel: image: redis:latest command: redis-sentinel /usr/local/etc/redis/sentinel.conf安全加固安全最佳实践访问控制策略# 修改默认密码 ALTER USER wvp_user% IDENTIFIED BY StrongPassword123!; # 限制数据库访问IP GRANT ALL PRIVILEGES ON wvp.* TO wvp_user192.168.1.%;HTTPS加密传输# Nginx SSL配置 server { listen 443 ssl; server_name wvp.yourdomain.com; ssl_certificate /etc/nginx/ssl/wvp.crt; ssl_certificate_key /etc/nginx/ssl/wvp.key; ssl_protocols TLSv1.2 TLSv1.3; location / { proxy_pass http://polaris-wvp:18978; proxy_set_header Host $host; } }定期备份策略# 数据库备份脚本 #!/bin/bash BACKUP_DIR/backup/wvp DATE$(date %Y%m%d_%H%M%S) # 备份数据库 docker-compose exec -T polaris-mysql mysqldump -u wvp_user -pwvp_password wvp $BACKUP_DIR/wvp_$DATE.sql # 备份配置文件 tar -czf $BACKUP_DIR/config_$DATE.tar.gz docker/wvp/wvp/application*.yml docker/media/config.ini # 保留最近7天备份 find $BACKUP_DIR -type f -mtime 7 -delete安全审计日志# 启用详细日志记录 logging: level: com.genersoft.iot.vmp: DEBUG org.springframework.security: DEBUG file: path: /opt/wvp/logs/ max-history: 30 max-size: 100MB通过以上完整的部署指南您已成功搭建并配置了wvp-GB28181-pro国标视频平台。该平台提供了从设备接入、视频管理到平台级联的全方位功能支持企业级视频监控系统的构建与扩展。建议定期检查系统运行状态及时更新安全补丁并根据业务需求调整资源配置。【免费下载链接】wvp-GB28181-pro基于GB28181-2016、部标808、部标1078标准实现的开箱即用的网络视频平台。自带管理页面支持NAT穿透支持海康、大华、宇视等品牌的IPC、NVR接入。支持国标级联支持将普通摄像机/直播流/直播推流转国标共享到国标平台。项目地址: https://gitcode.com/GitHub_Trending/wv/wvp-GB28181-pro创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考