1. 环境准备与基础组件安装搭建基于WVP-Pro和ZLMediaKit的GB28181视频平台首先需要准备一个干净的Linux环境。我推荐使用Ubuntu 22.04 LTS版本这个版本长期支持且软件包兼容性好。在实际项目中我遇到过不少因为系统版本过旧导致的依赖问题所以强烈建议从官方渠道获取最新LTS镜像。安装过程就像搭积木需要按顺序完成各个组件的部署。首先是Node.js环境这是WVP-Pro前端编译的必备条件。我习惯从官网下载最新的LTS版本解压到/opt目录并设置环境变量。记得检查glibc版本是否兼容这个坑我踩过好几次。执行strings /lib/x86_64-linux-gnu/libc.so.6 | grep GLIBC_就能看到系统支持的版本列表。Java环境建议选择OpenJDK 11这是经过验证最稳定的版本。直接用apt安装就行但别忘了顺手把Maven也装上后面编译WVP-Pro时会用到。数据库方面MySQL 8.0和Redis的组合已经能满足大多数场景需求。特别提醒MySQL安装后一定要修改root密码并开启远程访问权限否则后续WVP-Pro连接时会报错。编译工具链包括g、cmake等基础组件还有ffmpeg这样的多媒体处理工具。这些都可以通过apt一键安装但cmake我更喜欢手动安装最新版因为ZLMediaKit的某些新特性需要较高版本的cmake支持。安装完记得把bin目录加入PATH这个步骤看似简单却经常被忽略。2. 核心组件编译与部署ZLMediaKit的编译过程比较考验机器性能。git clone代码后别忘记执行git submodule update --init拉取子模块。我在第一次编译时因为漏了这步结果各种头文件找不到的错误。编译参数建议用cmake .. -DCMAKE_BUILD_TYPERelease开启优化多核机器可以加上-j8参数加速编译。WVP-Pro的编译分为前端和后端两部分。前端需要进入web_src目录执行npm install安装依赖这个过程可能会遇到网络问题。我的经验是使用国内镜像源比如在命令后加上--registryhttps://registry.npmmirror.com。后端用mvn package打包时记得内存给够否则容易OOM崩溃。编译完成后建议建立统一的配置目录管理所有文件。我通常会在项目根目录下创建config文件夹把ZLMediaKit的config.ini和WVP-Pro的application.yml都放在这里。这样不仅方便管理也便于后期备份和迁移。配置文件中的关键参数需要特别注意比如ZLMediaKit的secret值必须与WVP-Pro配置完全一致否则媒体流传输会失败。3. 国标服务配置详解GB28181协议的核心是SIP信令交互这部分的配置主要在WVP-Pro的application.yml中。sip.ip需要填写服务器实际IP如果是云服务器要特别注意区分内外网地址。我曾经因为填错了这个参数导致设备注册总是超时。domain和id按照国标规范填写即可password则是设备注册时的鉴权密码。媒体服务器配置是另一个重点。media.ip要填写ZLMediaKit所在服务器的内网IPhttp-port默认80就行。rtp.port-range建议设置为30000-35000这样的范围确保有足够端口可供分配。hook-ip要特别注意这是ZLMediaKit回调WVP-Pro的地址如果填错会导致录像、点播等功能异常。数据库配置关系到整个平台的稳定性。WVP-Pro使用Hikari连接池管理数据库连接initialSize不宜设置过大50左右就够用了。maximum-pool-size可以根据实际设备数量调整200个连接能满足中小规模部署。记得提前创建好数据库并导入初始化脚本这个步骤经常被新手忽略。4. 设备对接与实战调试没有真实设备时可以用模拟器进行测试。HappyTime的GB28181模拟设备是我常用的工具Windows和Linux版本都有。配置文件主要修改server_ip、server_port等参数与WVP-Pro的sip配置对应即可。设备注册成功后在WVP-Pro的Web界面应该能看到在线设备列表。播放测试时常见的问题是视频黑屏或卡顿。这时候可以先检查ZLMediaKit的日志看是否收到了RTP流。如果收不到流可能是端口映射或防火墙问题。我遇到过NAT环境下端口未正确映射的情况最后通过tcpdump抓包才定位到问题。音频问题也值得关注确保设备端开启了音频编码否则录像文件会没有声音。云端录像功能需要同时配置WVP-Pro和ZLMediaKit。在WVP-Pro中设置user-settings.record-sip为trueZLMediaKit会自动将视频流保存为MP4文件。录像文件默认存储在ZLMediaKit的www/record目录下按设备ID和日期分类存放。记得定期清理旧文件否则磁盘很快会被占满。5. 生产环境优化建议正式环境部署时建议将各个组件配置为系统服务。用systemd管理ZLMediaKit和WVP-Pro进程可以设置自动重启和日志轮转。我写过一个现成的service文件模板只需要修改ExecStart路径就能直接用。内存方面ZLMediaKit建议至少4GBWVP-Pro根据设备数量配置一般8GB起步。负载均衡可以考虑用Nginx做反向代理特别是需要HTTPS访问时。我曾经用Certbot自动申请Lets Encrypt证书配合Nginx实现全站HTTPS。对于大规模部署可以把ZLMediaKit和WVP-Pro分开部署通过内网专线连接。这种架构下ZLMediaKit可以部署在离设备更近的位置减少网络延迟。监控报警是运维的关键环节。ZLMediaKit自带HTTP API可以获取服务器状态配合Prometheus和Grafana能搭建完整的监控系统。我通常会监控关键指标CPU使用率、内存占用、网络流量、活动连接数等。当某个指标超过阈值时通过Alertmanager发送邮件或短信报警。