wvp-pro api文档

### WVP-Pro 与 ZLM 连接配置 为了实现 WVP-Pro 和 ZLM (ZLMediaKit) 的连接，需完成以下几个方面的设置： #### 配置文件调整 WVP-Pro 使用 `application.yml` 文件作为主要配置文件。如果开发环境中有多个配置文件（如 `application-dev.yml`），可以通过复制的方式将其重命名为默认加载的配置文件名 `application.yml`[^1]。 以下是典型的 `application.yml` 中涉及 ZLM 媒体服务器的部分配置项： ```yaml server: port: 8088 zlm: enable: true ip: 127.0.0.1 httpPort: 8089 wsPort: 5700 rtmpPort: 1935 pullStreamTimeoutSecs: 60 ``` 上述配置说明如下： - **enable**: 是否启用 ZLM 支持。 - **ip**: ZLMediaKit 所运行的服务 IP 地址。 - **httpPort**: ZLM 提供 HTTP 接口监听的端口号，默认为 8089。 - **wsPort**: WebSocket 协议使用的端口号，默认为 5700。 - **rtmpPort**: RTMP 协议支持的端口号，默认为 1935。 - **pullStreamTimeoutSecs**: 拉流超时时间，单位秒。 以上参数均需要根据实际部署情况修改，特别是当 ZLM 不在同一台机器上运行时，应将 `ip` 替换为目标主机的实际地址。 --- #### 启动服务 在完成配置后，通过命令行启动 WVP-Pro 服务： ```bash java -jar wvp-pro-2.7.0-02250919.jar ``` 此时浏览器访问 URL (`http://<wvp-server-ip>:8088`) 可验证服务是否正常启动[^3]。 对于 ZLMediaKit，则按照其官方文档中的方法编译并启动服务。通常情况下，只需执行以下命令即可快速测试： ```bash ./media_server ``` --- #### 录像功能集成 WVP-Pro 辅助录像程序 `wvp-pro-assist` 是专门设计用于配合 ZLM 实现录像管理的功能模块。该模块可以独立运行并与 ZLM 结合使用，提供录像录制、合并以及下载等功能接口[^2]。 要使两者协同工作，除了基础网络连通性和配置一致性外，还需确认以下几点： - 确保 ZLM 已开启录像存储路径及相关权限； - 在 WVP-Pro 的 API 调用中指定正确的媒体源 ID 或通道号； - 如果存在跨域请求场景，建议检查 CORS 设置以允许前端页面调用后台接口。 --- #### 故障排查提示 若发现无法建立连接或者视频流播放异常，请依次检查下列事项： 1. 网络可达性：Ping 测试目标设备之间的通信状态。 2. 端口开放状况：确保所有必需的服务端口未被防火墙阻断。 3. 日志记录分析：查看 WVP-Pro 和 ZLMediaKit 的日志输出寻找错误线索。 ---

<think>好的，用户想要使用Docker安装ZLM和WVP-Pro，我需要根据提供的引用内容来整理步骤。首先，用户提到了几个引用，其中引用[2]和[3]提到了Docker部署的相关信息，特别是五个镜像和步骤。我需要先确认这些引用的具体内容，然后组织成一个清晰的安装流程。 首先，用户需要安装Docker环境，这里引用[1]提到了在CentOS上安装Docker Engine，但用户的操作系统是Ubuntu Server 22.04，所以可能需要调整步骤。不过用户可能已经安装好了Docker，但需要确认版本是否合适。根据引用[2]，Docker版本是26.0.2，但用户建议安装最新的，所以可以推荐用户安装最新版Docker。 接下来，部署Redis和MySQL。引用[2]指出这两个服务可以与其他项目共用，但如果用户没有的话需要自己部署。这里需要给出部署这两个容器的命令，比如使用docker run命令，并设置必要的环境变量，比如密码和端口映射。这部分需要确保用户正确配置数据库和Redis，避免后续服务无法连接。 然后是部署ZLM（ZLMediaKit）。引用[3]提到需要将ZLM的端口改为8091，并映射内外网端口。同时，hook地址要设置为WVP-Pro的外网地址。这部分需要注意docker命令中的端口映射和环境变量设置，特别是hook.admin_params.url的配置，指向WVP-Pro的外网IP和端口。 接下来是部署WVP-Pro的三个必要镜像：wvp-pro、wvp-pro-talk和wvp-assist。每个容器需要连接到之前创建的docker网络，并正确配置环境变量，如数据库连接信息、Redis地址、ZLM的IP和端口等。这里需要确保环境变量中的IP地址是容器名称，因为同一网络下可以通过容器名通信。同时，WVP-Pro的HTTP端口需要映射到宿主机的适当端口，比如18080，并确保外网可以访问。 最后，用户可能需要验证安装是否成功，访问WVP-Pro的Web界面，并检查各个服务是否正常通信。此外，用户需要注意防火墙设置，开放相关端口，如ZLM的8091和WVP的18080等。 用户可能遇到的常见问题包括网络配置错误、环境变量设置不正确、端口冲突等。需要提醒用户在部署时仔细检查这些部分，并参考官方文档或社区资源进行故障排除。此外，如果用户有多个服务器，可能需要调整网络配置，确保不同服务器上的容器能够互相访问，特别是hook地址可能需要设置为公网IP或域名。 总结步骤应该是：安装Docker→部署Redis和MySQL→创建共享网络→部署ZLM→部署WVP的三个组件。同时，强调环境变量和网络配置的重要性，避免因为连接问题导致服务不可用。</think>### 使用Docker安装ZLM和WVP-Pro的步骤指南 #### 1. 准备工作 - **操作系统**：推荐使用Ubuntu Server 22.04[^2] - **安装Docker**：确保已安装最新版Docker Engine，参考[官方文档](https://docs.docker.com/engine/install/) - **网络规划**：所有容器需连接到同一Docker网络以实现通信 #### 2. 部署Redis和MySQL ```bash # 创建共享网络（若已有其他网络可跳过） docker network create wvp-network # 启动Redis docker run -d --name redis --network wvp-network -p 6379:6379 redis:latest # 启动MySQL docker run -d --name mysql --network wvp-network -p 3306:3306 \ -e MYSQL_ROOT_PASSWORD=your_password mysql:latest ``` *注：需记录数据库密码和端口供后续配置使用[^2]* #### 3. 部署ZLMediaKit (ZLM) ```bash docker run -d --name zlmediakit --network wvp-network \ -p 8091:8091 -p 1935:1935 -p 554:554 \ -e ZLM_HOOK_ADMIN_URL=http://wvp-pro:18080/api/hook \ panjjo/zlmediakit:latest ``` *关键配置说明*： - `ZLM_HOOK_ADMIN_URL`需指向WVP-Pro的容器地址（若跨服务器需用公网IP）[^3] - 内外网端口统一映射为8091[^3] #### 4. 部署WVP-Pro核心组件 ```bash # 1. wvp-pro主服务 docker run -d --name wvp-pro --network wvp-network -p 18080:18080 \ -e SPRING_DATASOURCE_URL="jdbc:mysql://mysql:3306/wvp?useSSL=false" \ -e SPRING_DATASOURCE_USERNAME=root \ -e SPRING_DATASOURCE_PASSWORD=your_password \ -e ZLM_MEDIA_SERVER_IP=zlmediakit \ -e REDIS_HOST=redis \ wvp-pro:latest # 2. wvp-pro-talk（信令服务） docker run -d --name wvp-pro-talk --network wvp-network \ -e SPRING_REDIS_HOST=redis \ wvp-pro-talk:latest # 3. wvp-assist（辅助服务） docker run -d --name wvp-assist --network wvp-network \ -e SPRING_DATASOURCE_URL="jdbc:mysql://mysql:3306/wvp?useSSL=false" \ wvp-assist:latest ``` #### 5. 验证安装 1. 访问 `http://服务器IP:18080` 进入WVP-Pro管理界面 2. 检查ZLM状态： ```bash curl http://localhost:8091/index/api/getServerConfig ``` 3. 查看容器日志： ```bash docker logs -f wvp-pro ``` #### 常见问题处理 - **网络不通**：确认所有容器使用同一网络 `docker network inspect wvp-network` - **数据库连接失败**：检查MySQL容器状态和权限设置 - **端口冲突**：修改`-p 宿主机端口:容器端口`映射关系