Ubuntu搭建国标平台WVP-GB28181-PRO

爱分享

2025-6-16

学习笔记

简介

WVP-PRO基于GB/T 28181-2016标准实现的流媒体平台，依托优秀的开源流媒体服务ZLMediaKit ，提供完善丰富的功能。
GB/T 28181-2016 中文标准名称是《公共安全视频监控联网系统信息传输、交换、控制技术要求》是监控领域的国家标准。大量应用于政府视频平台。
通过28181协议你可以将IPC摄像头接入平台，可以观看也可以使用28181/rtsp/rtmp/flv等协议将视频流分发到其他平台。

特性

实现标准的28181信令，兼容常见的品牌设备，比如海康、大华、宇视等品牌的IPC、NVR以及平台。
支持将国标设备级联到其他国标平台，也支持将不支持国标的设备的图像或者直播推送到其他国标平台
前端完善，自带完整前端页面，无需二次开发可直接部署使用。
完全开源，且使用MIT许可协议。保留版权的情况下可以用于商业项目。
支持多流媒体节点负载均衡。

编译

WVP-PRO使用Spring boot开发，maven管理依赖。对于熟悉spring开发的朋友是很容易进行编译部署以及运行的。
下面将提供一种通用方法方便大家运行项目。

安装依赖

依赖	版本	用途	开发环境需要	生产环境需要
jdk	>=1.8	运行与编译java代码	是	是
maven	>=3.3	管理java代码依赖	否	否
git		下载/更新/提交代码	否	否
nodejs		编译于运行前端文件	否	否
npm		管理前端文件依赖	否	否

如果你是一个新手，建议你使用linux或者macOS平台。windows不推荐。

ubuntu环境，以ubuntu 24为例：

apt-get install -y openjdk-11-jre git maven nodejs npm cmake

centos环境,以centos 8为例：

yum install -y java-1.8.0-openjdk.x86_64 git maven nodejs npm cmake

安装mysql以及redis

安装MySQL

安装

#移除以前的mysql相关
sudo apt remove --purge mysql-\*
#安装mysql
sudo apt install mysql-server mysql-client
#查看是否启动
systemctl status mysql
#手动启动
systemctl start mysql
#查看mysql版本
mysql --version

修改密码

#免密进入mysql
sudo mysql -uroot
#your_new _password 修改成用户密码
alter user 'root'@'localhost' identified with mysql_native_password by 'your_new _password';
#然后就可以使用密码登录了
mysql -u root -p

use mysql;
#root账号可以访问所有主机
update user set host='%' where user= 'root';
flush privileges;
#授权
grant all on *.* to 'root'@'%';
flush privileges;
quit;

安装redis

sudo apt update
sudo apt install redis-server

#启动
redis-server

#查看Redis是否正常
systemctl status redis
redis-cli
#输入ping返回PONG表示正常

编译ZLMediaKit

# 国内用户推荐从同步镜像网站gitee下载 
git clone --depth 1 https://gitee.com/xia-chu/ZLMediaKit
cd ZLMediaKit
# 千万不要忘记执行这句命令
git submodule update --init
#编译
mkdir build
cd build
cmake ..
make -j4

编译WVP-PRO

从gitee克隆

git clone https://gitee.com/pan648540858/wvp-GB28181-pro.git

从github克隆

git clone https://github.com/648540858/wvp-GB28181-pro.git

编译前端页面

cd wvp-GB28181-pro/web/
npm --registry=https://registry.npmmirror.com install
npm run build:prod

编译如果报错, 一般都是网络问题, 导致的依赖包下载失败
编译完成后在src/main/resources下出现static目录 编译完成一般是这个样子，中间没有报红的错误信息

生成可执行jar

cd wvp-GB28181-pro
mvn package

生成war

cd wvp-GB28181-pro
mvn package -P war

编译如果报错, 一般都是网络问题, 导致的依赖包下载失败
编译完成后在target目录下出现 wvp-pro-VERSION.jar 和 wvp-pro-VERSION.war 文件。

编译结果说明

最终编译生成的结果在wvp-GB28181-pro/target目录,内容如下:

配置服务

有两个配置文件:

1.WVP-PRO配置文件;

2.ZLMediaKit配置文件

WVP-PRO配置文件

./src/main/resources/application.yml
./target/classes/application.yml
./target/wvp-pro-2.7.4-06150649/WEB-INF/classes/application.yml

./src/main/resources/all-application.yml
./target/classes/all-application.yml
./target/wvp-pro-2.7.4-06150649/WEB-INF/classes/all-application.yml

如上all-application.yml,application.yml使用哪一组都可以,这里使用all-application.yml进行修改.

将配置文件和可执行文件统一存放至/opt/config目录

cp /opt/wvp-GB28181-pro/src/main/resources/配置详情.yml /opt/config/application.yml
cp /opt/ZLMediaKit/release/linux/Debug/MediaServer /opt/config/

Mysql数据库配置

注意

share数据库删除
master数据库wvp2需要修改为wvp,必须要和建立的数据库名称对应

cd /opt/config/
vim application.yml

    # [必选] jdbc数据库配置
    datasource:
        # kingbase配置
        #        type: com.zaxxer.hikari.HikariDataSource
        #        driver-class-name: com.kingbase8.Driver
        #        url: jdbc:kingbase8://192.168.1.55:54321/wvp?useUnicode=true&characterEncoding=utf8
        #        username: system
        #        password: system
        # postgresql配置
        #    type: com.zaxxer.hikari.HikariDataSource
        #    driver-class-name: org.postgresql.Driver
        #    url: jdbc:postgresql://192.168.1.242:3306/242wvp
        #    username: root
        #    password: SYceshizu1234
        # mysql配置
        type: com.zaxxer.hikari.HikariDataSource
        driver-class-name: com.mysql.cj.jdbc.Driver
        url: jdbc:mysql://127.0.0.1:3306/wvp?useUnicode=true&characterEncoding=UTF8&rewriteBatchedStatements=true&serverTimezone=PRC&useSSL=false&allowMultiQueries=true
        username: root
        password: root123
        hikari:
            connection-timeout: 20000             # 是客户端等待连接池连接的最大毫秒数
            initialSize: 50                       # 连接池初始化连接数
            maximum-pool-size: 200                # 连接池最大连接数
            minimum-idle: 10                       # 连接池最小空闲连接数
            idle-timeout: 300000                  # 允许连接在连接池中空闲的最长时间（以毫秒为单位）
            max-lifetime: 1200000                 # 是池中连接关闭后的最长生命周期（以毫秒为单位)

MySQL设置

#wvp数据库修改,需要和url: jdbc:mysql://127.0.0.1:3306/wvp?对应
create DATABASE wvp;
use wvp;
source /opt/wvp-GB28181-pro/数据库/2.7.4/初始化-mysql-2.7.4.sql
flush privileges;
exit

REDIS数据库配置

    # REDIS数据库配置
    redis:
        # [必须修改] Redis服务器IP, REDIS安装在本机的,使用127.0.0.1
        host: 127.0.0.1
        # [必须修改] 端口号
        port: 6379
        # [可选] 数据库 DB
        database: 6
        # [可选] 访问密码,若你的redis服务器没有设置密码，就不需要用密码去连接
        password:
        # [可选] 超时时间
        timeout: 10000
        # [可选] 一个pool最多可分配多少个jedis实例
        poolMaxTotal: 1000
        # [可选] 一个pool最多有多少个状态为idle(空闲)的jedis实例
        poolMaxIdle: 500
        # [可选] 最大的等待时间(秒)
        poolMaxWait: 5

配置服务启动端口

# [可选] WVP监听的HTTP端口, 网页和接口调用都是这个端口
server:
    port: 18080

配置28181相关信息

# 作为28181服务器的配置
sip:
    # [必须修改] 本机的IP，对应你的网卡，监听什么ip就是使用什么网卡，
    # 如果要监听多张网卡，可以使用逗号分隔多个IP， 例如： 192.168.1.4,10.0.0.4
    # 如果不明白，就使用0.0.0.0，大部分情况都是可以的
    # 请不要使用127.0.0.1，任何包括localhost在内的域名都是不可以的。
    ip: 192.168.100.17
    # [可选] 没有任何业务需求，仅仅是在前端展示的时候用
    show-ip: 192.168.100.17
    # [可选] 28181服务监听的端口
    port: 5060
    # 根据国标6.1.2中规定，domain宜采用ID统一编码的前十位编码。国标附录D中定义前8位为中心编码（由省级、市级、区级、基层编号组成，参照GB/T 2260-2007）
    # 后两位为行业编码，定义参照附录D.3
    # 3701020049标识山东济南历下区 信息行业接入
    # [可选]
    domain: 3717250000
    # [可选]
    id: 37172500002000000001
    # [可选] 默认设备认证密码，后续扩展使用设备单独密码, 移除密码将不进行校验
    password: admin123
    # [可选] 国标级联注册失败，再次发起注册的时间间隔。 默认60秒
    register-time-interval: 60
    # [可选] 云台控制速度
    ptz-speed: 50
    # TODO [可选] 收到心跳后自动上线， 重启服务后会将所有设备置为离线，默认false，等待注册后上线。设置为true则收到心跳设置为上线。
    # keepalliveToOnline: false
    # 是否存储alarm信息
    alarm: false
    # 命令发送等待回复的超时时间, 单位:毫秒
    timeout: 1000

配置ZLMediaKit连接信息

#zlm 默认服务器配置
media:
    # [必须修改] zlm服务器唯一id，用于触发hook时区别是哪台服务器,general.mediaServerId
    id: admin001
    # [必须修改] zlm服务器的内网IP
    ip: 192.168.0.100
    # [可选] 有公网IP就配置公网IP, 不可用域名
    wan_ip:
    # [可选] 返回流地址时的ip，置空使用 media.ip
    stream-ip:
    # [可选] wvp在国标信令中使用的ip，此ip为摄像机可以访问到的ip， 置空使用 media.ip
    sdp-ip:
    # [可选] zlm服务器访问WVP所使用的IP, 默认使用127.0.0.1，zlm和wvp没有部署在同一台服务器时必须配置
    hook-ip: 127.0.0.1
    # [必须修改] zlm服务器的http.port
    http-port: 8880
    # [可选] zlm服务器的http.sslport, 置空使用zlm配置文件配置
    http-ssl-port:
    # [可选] zlm服务器的rtmp.port, 置空使用zlm配置文件配置
    rtmp-port:
    # [可选] zlm服务器的rtmp.sslport, 置空使用zlm配置文件配置
    rtmp-ssl-port:
    # [可选] zlm服务器的 rtp_proxy.port, 置空使用zlm配置文件配置
    rtp-proxy-port:
    # [可选] zlm服务器的 rtsp.port, 置空使用zlm配置文件配置
    rtsp-port:
    # [可选] zlm服务器的 rtsp.sslport, 置空使用zlm配置文件配置
    rtsp-ssl-port:
    # [可选] 是否自动配置ZLM, 如果希望手动配置ZLM, 可以设为false, 不建议新接触的用户修改
    auto-config: true
    # [可选] zlm服务器的hook.admin_params=secret
    secret: 035c73f7-bb6b-4889-a715-d9eb2d1925cc
    # 录像路径
    record-path: ./www/record
    # 录像保存时长
    record-day: 7
    # 启用多端口模式, 多端口模式使用端口区分每路流，兼容性更好。 单端口使用流的ssrc区分， 点播超时建议使用多端口测试
    rtp:
        # [可选] 是否启用多端口模式, 开启后会在portRange范围内选择端口用于媒体流传输
        enable: true
        # [可选] 在此范围内选择端口用于媒体流传输, 必须提前在zlm上配置该属性，不然自动配置此属性可能不成功
        port-range: 30000,30500 # 端口范围
        # [可选] 国标级联在此范围内选择端口发送媒体流，请不要与收流端口范围重合
        send-port-range: 50502,50506 # 端口范围
    # 录像辅助服务， 部署此服务可以实现zlm录像的管理与下载， 0 表示不使用
    record-assist-port: 0

id必须和ZLMediaKit配置中general.mediaServerId设置一致
ip必须正确设置
http-port和ZLMediaKit配置中http.port相同
secret和ZLMediaKit配置中api.secret相同

ZLMediaKit配置文件

[api]
    #一些比较敏感的http api在访问时需要提供secret，否则无权限调用
    #如果是通过127.0.0.1访问,那么可以不提供secret
    secret=035c73f7-bb6b-4889-a715-d9eb2d1925cc

[general]
    #服务器唯一id，用于触发hook时区别是哪台服务器
    mediaServerId=admin001

[http]
    #http服务器监听端口
    port=8880

[rtp_proxy]
    #随机端口范围，最少确保36个端口
    #该范围同时限制rtsp服务器udp端口范围
    port_range=30000-35000

运行测试

运行ZLMediaKit

/opt/config/MediaServer -c /opt/config/config.ini

运行wvp-GB28181-pro

java -jar /opt/config/wvp-pro-*.jar --spring.config.location=/opt/config/application.yml

正式运行

准备运行脚本

ZLMediaKit.sh

WVP_ZLM_PLATFORM_PATH=/opt
ZLMEDIAKIT_MEDIASERVER=${WVP_ZLM_PLATFORM_PATH}/ZLMediaKit/release/linux/Debug/MediaServer
ZLMEDIAKIT_CONFIG_FILE=${WVP_ZLM_PLATFORM_PATH}/config/ZLMediaKit.ini

sudo ${ZLMEDIAKIT_MEDIASERVER} -c ${ZLMEDIAKIT_CONFIG_FILE}

wvp_gb28181.sh

WVP_ZLM_PLATFORM_PATH=/opt
WVP_GB28181_JAR=${WVP_ZLM_PLATFORM_PATH}/wvp-GB28181-pro/target/wvp-pro-*.jar
WVP_GB28181_CONFIG_FILE=${WVP_ZLM_PLATFORM_PATH}/config/wvp_gb28181.yml

sudo java -jar ${WVP_GB28181_JAR} --spring.config.location=${WVP_GB28181_CONFIG_FILE}

版权声明 1 本文章标题：Ubuntu搭建国标平台WVP-GB28181-PRO
2 本文章地址：https://www.stelnet.cn/111.html
3 本网站部分内容可能来源于网络，仅供大家学习与参考，如有侵权，请发送邮件至maxiushun@163.com进行删除处理。
4 本站一切资源不代表本站立场，并不代表本站赞同其观点和对其真实性负责。

THE END