安装基础依赖
确保系统已安装 jdk 21、MySQL 5.7+、Redis 5.0+。若未安装,可通过以下命令安装
Linux系统:
bash
sudo apt update
sudo apt install openjdk-21-jdk mysql-server redis-server

下载并配置WVP
从GitHub克隆WVP-PRO项目:
bash
git clone https://github.com/648540858/wvp-GB28181-pro.git
cd wvp-GB28181-pro
修改配置文件 src/main/resources/application.yml:
- 更新MySQL连接信息(用户名、密码、数据库名)。
- 配置Redis的地址和端口。
- 修改SIP服务的IP、端口及设备通信参数。
windows 系统:
wvp-pro文件在绑定资源中。
windows ZLM编译好的下载:(下载后修改配置文件 config.ini)

如果报错:

安装【VC_redist.x64】
初始化数据库
登录MySQL并创建数据库:
sql
CREATE DATABASE wvp;
USE wvp;
source ./doc/wvp.sql;
编译与运行
使用Maven编译项目:
bash
mvn clean package
启动WVP服务:
bash
java -jar target/wvp-pro-*.jar
配置媒体服务(ZLM)
下载并运行ZLMediaKit(需提前安装FFmpeg):
bash
git clone https://github.com/ZLMediaKit/ZLMediaKit.git
cd ZLMediaKit
mkdir build && cd build
cmake .. && make -j4
./release/MediaServer
在WVP配置文件中指定ZLM的HTTP和流媒体端口(默认分别为80和554)。
访问与验证
浏览器打开 http://localhost:18080,使用默认账号 admin 和密码 admin 登录。
在Web界面添加GB28181设备,测试视频流拉取与播放功能。
常见问题处理
- 端口冲突:检查18080、5060(SIP)等端口是否被占用。
- 数据库连接失败:确认MySQL权限及配置文件中的JDBC URL格式。
- 媒体流无法播放:验证ZLM服务是否正常运行,FFmpeg是否支持H.264解码。
可选优化
- 使用Nginx反向代理WVP和ZLM以支持HTTPS。
使用Nginx方式,配置HTTPS时,ZLM需要将PEM和KEY文件合并为 【default.pem】
wvp改stream ip改域名,
wvp配置证书 走https,
网页请求使用htts://域名
zlm启动时使用域名对应的证书
- 配置防火墙规则开放SIP/RTP端口(5060、10000-20000)。