Ubuntu搭建国标平台WVP-GB28181-PRO
简介
- 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}