GB28181视频平台WVP实战部署：从源码编译到服务联调

1. 环境准备与依赖安装刚拿到一台全新的CentOS服务器时我习惯先做两件事更新系统基础环境和检查网络连通性。对于GB28181视频平台部署来说这些准备工作尤为重要。记得有次在客户现场部署时因为没装EPEL源导致后续编译频频报错白白浪费了两小时排查时间。执行系统更新时建议使用这条组合命令yum update -y yum install -y epel-releaseWVP平台的核心依赖包括Java运行时、构建工具和前端编译环境。这里有个细节要注意OpenJDK 1.8的兼容性最好新版JDK可能会遇到奇怪的类加载问题。安装时记得连带开发工具包一起装yum install -y java-1.8.0-openjdk-devel maven nodejs npm git验证环境是否就绪时我习惯用这个检查清单java -version应显示1.8.xmvn -v版本建议3.6node -v需要12.x以上确保/usr/bin下有npm软链接2. 源码获取与前端编译从Gitee克隆源码时建议使用HTTPS协议而非SSH特别是在企业内网环境。我遇到过防火墙阻断SSH端口导致克隆失败的情况git clone https://gitee.com/pan648540858/wvp-GB28181-pro.git进入web目录编译前端时有三个常见坑点需要注意国内网络建议换淘宝镜像源确保磁盘剩余空间大于1GB内存不足时可添加swap分区具体操作命令如下cd wvp-GB28181-pro/web/ npm config set registry https://registry.npmmirror.com npm install --legacy-peer-deps npm run build:prod编译成功的标志是在src/main/resources下生成static文件夹。如果遇到node-sass报错可以尝试npm rebuild node-sass3. 后端服务编译与打包Maven打包前建议先清理旧构建产物避免缓存干扰cd ../ mvn clean package -DskipTests打包过程可能会遇到这些典型问题依赖下载超时检查Maven镜像配置内存溢出设置MAVEN_OPTS-Xmx1024m编码问题添加-Dfile.encodingUTF-8成功编译后在target目录会生成两个关键文件wvp-pro-*.jar主程序包application-dev.yml默认配置文件建议将这两个文件复制到单独的部署目录保持项目结构清晰mkdir -p /opt/wvp-pro cp target/wvp-pro-*.jar target/application*.yml /opt/wvp-pro/4. 关键配置详解与调优application-dev.yml中有几个生死攸关的配置项需要特别注意SIP服务配置sip: port: 15060 domain: 3402000000 id: 34020000002000000001 password: StrongPassword123!媒体服务器配置media: ip: 192.168.1.100 http-port: 9092 secret: ComplexSecretKey456$ rtp: enable: true port-range: 40000,45000生产环境必改项清单所有默认密码必须修改SIP ID需按GB/T 28181规范编码RTP端口范围需与防火墙策略匹配Redis连接池参数调整数据库配置建议使用连接池优化spring: datasource: hikari: maximum-pool-size: 20 connection-timeout: 300005. 服务启动与验证启动服务时推荐使用nohup配合日志重定向nohup java -jar wvp-pro-*.jar wvp.log 21 验证服务是否正常运行的三个步骤检查日志无ERROR级别报错访问http://服务器IP:18080应出现登录页使用admin/admin测试登录常见启动问题排查指南端口冲突netstat -tunlp|grep java内存不足添加-Xmx1024m参数数据库连接失败检查字符集是否为utf8mb46. 与ZLM媒体服务器联调媒体服务器连接成功的标志是在WVP管理后台看到在线节点。如果状态异常可按这个流程排查确认ZLM的hook配置正确检查双方时间同步NTP服务验证网络连通性telnet测试端口查看ZLM日志中的HTTP回调记录联调通过后建议立即修改默认管理员密码并在安全组中限制SIP端口访问源IP。7. 日常维护与监控配置生产环境部署后建议配置这些监控项Prometheus监控JVM指标ELK收集服务日志定时任务定期清理录像文件内存调优参数示例java -server -Xms2g -Xmx2g -XX:MaxMetaspaceSize512m -jar wvp-pro-*.jar对于高可用部署可以考虑的方案包括使用Nginx做负载均衡Redis哨兵模式数据库主从复制8. 国标设备接入实战添加摄像头设备时这几个参数必须与设备端完全一致SIP服务器地址SIP ID编码规则认证密码传输协议TCP/UDP设备注册流程的典型问题处理注册超时检查网络ACL规则认证失败核对密码和SIP ID视频无法播放确认RTP端口开放设备管理中的实用技巧使用通道编号作为检索条件批量导出设备列表时用CSV格式配置移动侦测报警联动规则