|  | @@ -14,20 +14,11 @@ WVP-PRO通过调用ZLMediaKit的RESTful接口实现对ZLMediaKit行为的控制;
 | 
	
		
			
				|  |  |  基于spring boot的开发方式,配置文件的加载是很灵活的。默认在src/main/resources/application.yml,部分配置项是可选,你不需要全部配置在配置文件中,
 | 
	
		
			
				|  |  |  完全的配置说明可以参看all-application.yml。
 | 
	
		
			
				|  |  |  ### 1.1 默认加载配置文件方式
 | 
	
		
			
				|  |  | -使用maven打包后的jar包里,已经存在了配置文件,但是每次打开jar包修改配置文件或者修改后再打包都是比较麻烦的,所以大家可通过指定配置文件路径来加载指定位置的配置文件。
 | 
	
		
			
				|  |  | +使用maven打包后的target里,已经存在了配置文件,默认加载配置文件为application.yml,查看内容发现其中spring.profiles.active配置的内容,将入配置的值为dev,那么具体加载的配置文件就是application-dev.yml,如果配置的值找不到对应的配置文件,修改值为dev。
 | 
	
		
			
				|  |  |  ```shell
 | 
	
		
			
				|  |  |  cd wvp-GB28181-pro/target
 | 
	
		
			
				|  |  | -java -jar wvp-pro-*.jar --spring.config.location=../src/main/resources/application.yml
 | 
	
		
			
				|  |  | +java -jar wvp-pro-*.jar
 | 
	
		
			
				|  |  |  ```
 | 
	
		
			
				|  |  | -### 1.2 迁移配置文件以方便启动
 | 
	
		
			
				|  |  | -由于配置文件的命令比较长,所以为了启动方便通常我会把配置文件放到jar包的同级目录,类似这样,
 | 
	
		
			
				|  |  | -移除jar包内/BOOT-INF/classes/下所有以application开头的文件,使用解压缩工具打开jar即可,不需要解压出来。
 | 
	
		
			
				|  |  | -```shell
 | 
	
		
			
				|  |  | -cd wvp-GB28181-pro/target
 | 
	
		
			
				|  |  | -mv ../src/main/resources/application-dev.yml application.yml 
 | 
	
		
			
				|  |  | -java -jar wvp-pro-*.jar 
 | 
	
		
			
				|  |  | -```
 | 
	
		
			
				|  |  | -这也是我自己最常用的方式。
 | 
	
		
			
				|  |  |  ## 2 配置WVP-PRO
 | 
	
		
			
				|  |  |  wvp支持多种数据库,包括Mysql,Postgresql,金仓等,配置任选一种即可。
 | 
	
		
			
				|  |  |  ### 2.1 数据库配置
 | 
	
	
		
			
				|  | @@ -37,27 +28,28 @@ wvp支持多种数据库,包括Mysql,Postgresql,金仓等,配置任选
 | 
	
		
			
				|  |  |  数据库名称以wvp为例
 | 
	
		
			
				|  |  |  ```yaml
 | 
	
		
			
				|  |  |  spring:
 | 
	
		
			
				|  |  | -  datasource:
 | 
	
		
			
				|  |  | -    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&allowPublicKeyRetrieval=true
 | 
	
		
			
				|  |  | -    username: root
 | 
	
		
			
				|  |  | -    password: 12345678
 | 
	
		
			
				|  |  | -
 | 
	
		
			
				|  |  | -mybatis:
 | 
	
		
			
				|  |  | -  configuration:
 | 
	
		
			
				|  |  | -    map-underscore-to-camel-case: true
 | 
	
		
			
				|  |  | +  dynamic:
 | 
	
		
			
				|  |  | +    primary: master
 | 
	
		
			
				|  |  | +    datasource:
 | 
	
		
			
				|  |  | +      master:
 | 
	
		
			
				|  |  | +        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
 | 
	
		
			
				|  |  |  ```
 | 
	
		
			
				|  |  |  ####  2.1.3 Postgresql数据库配置
 | 
	
		
			
				|  |  |  数据库名称以wvp为例
 | 
	
		
			
				|  |  |  ```yaml
 | 
	
		
			
				|  |  |  spring:
 | 
	
		
			
				|  |  | -  datasource:
 | 
	
		
			
				|  |  | -    type: com.zaxxer.hikari.HikariDataSource
 | 
	
		
			
				|  |  | -    driver-class-name: org.postgresql.Driver
 | 
	
		
			
				|  |  | -    url: jdbc:postgresql://127.0.0.1:3306/wvp?useUnicode=true&characterEncoding=UTF8&rewriteBatchedStatements=true&serverTimezone=PRC&useSSL=false&allowMultiQueries=true&allowPublicKeyRetrieval=true
 | 
	
		
			
				|  |  | -    username: root
 | 
	
		
			
				|  |  | -    password: 12345678
 | 
	
		
			
				|  |  | +  dynamic:
 | 
	
		
			
				|  |  | +      primary: master
 | 
	
		
			
				|  |  | +      datasource:
 | 
	
		
			
				|  |  | +        type: com.zaxxer.hikari.HikariDataSource
 | 
	
		
			
				|  |  | +        driver-class-name: org.postgresql.Driver
 | 
	
		
			
				|  |  | +        url: jdbc:postgresql://127.0.0.1:3306/wvp?useUnicode=true&characterEncoding=UTF8&rewriteBatchedStatements=true&serverTimezone=PRC&useSSL=false&allowMultiQueries=true&allowPublicKeyRetrieval=true
 | 
	
		
			
				|  |  | +        username: root
 | 
	
		
			
				|  |  | +        password: 12345678
 | 
	
		
			
				|  |  |  
 | 
	
		
			
				|  |  |  pagehelper:
 | 
	
		
			
				|  |  |    helper-dialect: postgresql
 | 
	
	
		
			
				|  | @@ -66,12 +58,14 @@ pagehelper:
 | 
	
		
			
				|  |  |  数据库名称以wvp为例
 | 
	
		
			
				|  |  |  ```yaml
 | 
	
		
			
				|  |  |  spring:
 | 
	
		
			
				|  |  | -  datasource:
 | 
	
		
			
				|  |  | -    type: com.zaxxer.hikari.HikariDataSource
 | 
	
		
			
				|  |  | -    driver-class-name: com.kingbase8.Driver
 | 
	
		
			
				|  |  | -    url: jdbc:kingbase8://127.0.0.1:3306/wvp?useUnicode=true&characterEncoding=utf8
 | 
	
		
			
				|  |  | -    username: root
 | 
	
		
			
				|  |  | -    password: 12345678
 | 
	
		
			
				|  |  | +  dynamic:
 | 
	
		
			
				|  |  | +    primary: master
 | 
	
		
			
				|  |  | +    datasource:
 | 
	
		
			
				|  |  | +      type: com.zaxxer.hikari.HikariDataSource
 | 
	
		
			
				|  |  | +      driver-class-name: com.kingbase8.Driver
 | 
	
		
			
				|  |  | +      url: jdbc:kingbase8://127.0.0.1:3306/wvp?useUnicode=true&characterEncoding=utf8
 | 
	
		
			
				|  |  | +      username: root
 | 
	
		
			
				|  |  | +      password: 12345678
 | 
	
		
			
				|  |  |  
 | 
	
		
			
				|  |  |  pagehelper:
 | 
	
		
			
				|  |  |    helper-dialect: postgresql
 | 
	
	
		
			
				|  | @@ -88,8 +82,6 @@ server:
 | 
	
		
			
				|  |  |  ```yaml
 | 
	
		
			
				|  |  |  # 作为28181服务器的配置
 | 
	
		
			
				|  |  |  sip:
 | 
	
		
			
				|  |  | -    # [必须修改] 本机的IP
 | 
	
		
			
				|  |  | -    ip: 192.168.1.3
 | 
	
		
			
				|  |  |      # [可选] 28181服务监听的端口
 | 
	
		
			
				|  |  |      port: 5060
 | 
	
		
			
				|  |  |      # 根据国标6.1.2中规定,domain宜采用ID统一编码的前十位编码。国标附录D中定义前8位为中心编码(由省级、市级、区级、基层编号组成,参照GB/T 2260-2007)
 | 
	
	
		
			
				|  | @@ -106,58 +98,42 @@ sip:
 | 
	
		
			
				|  |  |  ```yaml
 | 
	
		
			
				|  |  |  #zlm 默认服务器配置
 | 
	
		
			
				|  |  |  media:
 | 
	
		
			
				|  |  | -    # ZLMediaKit的服务ID,必须配置
 | 
	
		
			
				|  |  | -    id: FQ3TF8yT83wh5Wvz
 | 
	
		
			
				|  |  | -    # [必须修改] zlm服务器的内网IP,sdp-ip与stream-ip使用默认值的情况下,这里不要使用127.0.0.1/0.0.0.0
 | 
	
		
			
				|  |  | -    ip: 192.168.1.3
 | 
	
		
			
				|  |  | -    # [必须修改] zlm服务器的http.port
 | 
	
		
			
				|  |  | -    http-port: 6080
 | 
	
		
			
				|  |  | -    # [可选] zlm服务器的hook.admin_params=secret
 | 
	
		
			
				|  |  | -    secret: 035c73f7-bb6b-4889-a715-d9eb2d1925cc
 | 
	
		
			
				|  |  | -    # 启用多端口模式, 多端口模式使用端口区分每路流,兼容性更好。 单端口使用流的ssrc区分, 点播超时建议使用多端口测试
 | 
	
		
			
				|  |  | -    rtp:
 | 
	
		
			
				|  |  | -        # [可选] 是否启用多端口模式, 开启后会在portRange范围内选择端口用于媒体流传输
 | 
	
		
			
				|  |  | -        enable: true
 | 
	
		
			
				|  |  | -        # [可选] 在此范围内选择端口用于媒体流传输,
 | 
	
		
			
				|  |  | -        port-range: 30000,30500 # 端口范围
 | 
	
		
			
				|  |  | -        # [可选] 国标级联在此范围内选择端口发送媒体流,
 | 
	
		
			
				|  |  | -        send-port-range: 30000,30500 # 端口范围
 | 
	
		
			
				|  |  | -    # 录像辅助服务, 部署此服务可以实现zlm录像的管理与下载, 0 表示不使用
 | 
	
		
			
				|  |  | -    record-assist-port: 18081
 | 
	
		
			
				|  |  | +  id: zlmediakit-local
 | 
	
		
			
				|  |  | +  # [必须修改] zlm服务器的内网IP
 | 
	
		
			
				|  |  | +  ip: 172.19.128.50
 | 
	
		
			
				|  |  | +  # [可选] 有公网IP就配置公网IP, 不可用域名
 | 
	
		
			
				|  |  | +  wan_ip:
 | 
	
		
			
				|  |  | +  # [必须修改] zlm服务器的http.port
 | 
	
		
			
				|  |  | +  http-port: 9092
 | 
	
		
			
				|  |  | +  # [可选] zlm服务器访问WVP所使用的IP, 默认使用127.0.0.1,zlm和wvp没有部署在同一台服务器时必须配置
 | 
	
		
			
				|  |  | +  hook-ip: 172.19.128.50
 | 
	
		
			
				|  |  | +  # [必选选] zlm服务器的hook.admin_params=secret
 | 
	
		
			
				|  |  | +  secret: TWSYFgYJOQWB4ftgeYut8DW4wbs7pQnj
 | 
	
		
			
				|  |  | +  # 启用多端口模式, 多端口模式使用端口区分每路流,兼容性更好。 单端口使用流的ssrc区分, 点播超时建议使用多端口测试
 | 
	
		
			
				|  |  | +  rtp:
 | 
	
		
			
				|  |  | +    # [可选] 是否启用多端口模式, 开启后会在portRange范围内选择端口用于媒体流传输
 | 
	
		
			
				|  |  | +    enable: true
 | 
	
		
			
				|  |  | +    # [可选] 在此范围内选择端口用于媒体流传输, 必须提前在zlm上配置该属性,不然自动配置此属性可能不成功
 | 
	
		
			
				|  |  | +    port-range: 30000,35000 # 端口范围
 | 
	
		
			
				|  |  | +    # [可选] 国标级联在此范围内选择端口发送媒体流,
 | 
	
		
			
				|  |  | +    send-port-range: 40000,40300 # 端口范围
 | 
	
		
			
				|  |  |  ```
 | 
	
		
			
				|  |  |  ### 2.4 个性化定制信息配置
 | 
	
		
			
				|  |  |  ```yaml
 | 
	
		
			
				|  |  |  # [根据业务需求配置]
 | 
	
		
			
				|  |  |  user-settings:
 | 
	
		
			
				|  |  | -    # [可选] 服务ID,不写则为000000
 | 
	
		
			
				|  |  | -    server-id:
 | 
	
		
			
				|  |  | -    # [可选] 自动点播, 使用固定流地址进行播放时,如果未点播则自动进行点播, 需要rtp.enable=true
 | 
	
		
			
				|  |  | -    auto-apply-play: false
 | 
	
		
			
				|  |  | -    # [可选] 部分设备需要扩展SDP,需要打开此设置
 | 
	
		
			
				|  |  | -    senior-sdp: false
 | 
	
		
			
				|  |  | -    # 保存移动位置历史轨迹:true:保留历史数据,false:仅保留最后的位置(默认)
 | 
	
		
			
				|  |  | -    save-position-history: false
 | 
	
		
			
				|  |  | -    # 点播等待超时时间,单位:毫秒
 | 
	
		
			
				|  |  | -    play-timeout: 3000
 | 
	
		
			
				|  |  | -    # 等待音视频编码信息再返回, true: 可以根据编码选择合适的播放器,false: 可以更快点播
 | 
	
		
			
				|  |  | -    wait-track: false
 | 
	
		
			
				|  |  | -    # 是否开启接口鉴权
 | 
	
		
			
				|  |  | -    interface-authentication: true
 | 
	
		
			
				|  |  | -    # 自动配置redis 可以过期事件
 | 
	
		
			
				|  |  | -    redis-config: true
 | 
	
		
			
				|  |  | -    # 接口鉴权例外的接口, 即不进行接口鉴权的接口,尽量详细书写,尽量不用/**,至少两级目录
 | 
	
		
			
				|  |  | -    interface-authentication-excludes:
 | 
	
		
			
				|  |  | -        - /api/v1/**
 | 
	
		
			
				|  |  | -    # 推流直播是否录制
 | 
	
		
			
				|  |  | -    record-push-live: true
 | 
	
		
			
				|  |  | -    # 国标是否录制
 | 
	
		
			
				|  |  | -    record-sip: true
 | 
	
		
			
				|  |  | -    # 是否将日志存储进数据库
 | 
	
		
			
				|  |  | -    logInDatabase: true
 | 
	
		
			
				|  |  | -    # 第三方匹配,用于从stream钟获取有效信息
 | 
	
		
			
				|  |  | -    thirdPartyGBIdReg: [\s\S]*
 | 
	
		
			
				|  |  | +  # 点播/录像回放 等待超时时间,单位:毫秒
 | 
	
		
			
				|  |  | +  play-timeout: 180000
 | 
	
		
			
				|  |  | +  # [可选] 自动点播, 使用固定流地址进行播放时,如果未点播则自动进行点播, 需要rtp.enable=true
 | 
	
		
			
				|  |  | +  auto-apply-play: true
 | 
	
		
			
				|  |  | +  # 推流直播是否录制
 | 
	
		
			
				|  |  | +  record-push-live: true
 | 
	
		
			
				|  |  | +  # 国标是否录制
 | 
	
		
			
				|  |  | +  record-sip: true
 | 
	
		
			
				|  |  | +  # 国标点播 按需拉流, true:有人观看拉流,无人观看释放, false:拉起后不自动释放
 | 
	
		
			
				|  |  | +  stream-on-demand: true
 | 
	
		
			
				|  |  |  ```
 | 
	
		
			
				|  |  | -
 | 
	
		
			
				|  |  | +更多完整的配置信息参考all-application.yml文件,需要那个配置项,复制到正在使用的配置文件中对应的文件即可。
 | 
	
		
			
				|  |  |  
 | 
	
		
			
				|  |  |  如果配置信息无误,你可以启动zlm,再启动wvp来测试了,启动成功的话,你可以在wvp的日志下看到zlm已连接的提示。
 | 
	
		
			
				|  |  |  接下来[部署到服务器](./_content/introduction/deployment.md), 如果你只是本地运行直接在本地运行即可。
 |