Files
SecMPS/owl_zlmediakit/README.md
2026-05-15 23:22:48 +08:00

189 lines
6.1 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# GoWVP (Owl) + ZLMediaKit 离线部署包
> **生成时间**: 2026-04-29
> **适用平台**: 飞腾S5000C (ARM64) + 统信UOS20
> **部署方式**: Docker Compose 融合部署
---
## 📦 文件清单
### ✅ 已包含文件(可直接使用)
| 文件/目录 | 说明 |
|-----------|------|
| `部署手册.md` | 完整的离线部署手册,包含所有步骤和命令 |
| `configs/docker-compose.yml` | Docker Compose 融合部署配置 |
| `configs/zlm-config.ini` | ZLMediaKit 配置文件已配置与GoWVP联动 |
| `scripts/install-docker.sh` | Docker 离线安装脚本ARM64 |
| `scripts/setup.sh` | 一键部署脚本 |
| `scripts/verify.sh` | 部署验证脚本 |
| `source-packages/libsrtp-2.5.0.tar.gz` | WebRTC依赖库源码版本必须严格2.5.0 |
### ⚠️ 需要手动下载的文件
由于当前网络环境限制,以下文件需要您在**可联网的笔记本/工作站**上手动下载:
#### 1. Docker 镜像文件(需通过 Docker 拉取后导出)
```bash
# 创建目录
mkdir -p docker-images
# 拉取 ZLMediaKit 官方镜像
docker pull zlmediakit/zlmediakit:master
# 拉取 GoWVP 官方镜像
docker pull gospace/gowvp:latest
# 导出镜像
docker save -o docker-images/zlmediakit-master-arm64.tar zlmediakit/zlmediakit:master
docker save -o docker-images/gowvp-latest-arm64.tar gospace/gowvp:latest
```
**镜像说明**:
- `zlmediakit-master-arm64.tar`: ZLMediaKit 流媒体服务器镜像,约 300-700MB
- `gowvp-latest-arm64.tar`: GoWVP 管理平台镜像,约 200MB
#### 2. Docker 离线安装包
```bash
# 下载目录: deb-packages/
# Docker CE ARM64 静态二进制包 (约 70MB)
wget https://download.docker.com/linux/static/stable/aarch64/docker-27.5.1.tgz
# Docker Compose ARM64 二进制 (约 60MB)
wget https://github.com/docker/compose/releases/download/v2.29.1/docker-compose-linux-aarch64
```
#### 3. 源码包(备用方案)
```bash
# 下载目录: source-packages/
# ZLMediaKit 最新源码
wget https://github.com/ZLMediaKit/ZLMediaKit/archive/refs/heads/master.zip
# GoWVP v1.3.0 ARM64 预编译二进制
wget https://github.com/gowvp/owl/releases/download/v1.3.0/owl_linux_arm64.tar.gz
```
#### 4. 系统依赖包(根据包管理器类型选择)
**如果目标系统使用 `yum` (A/E版本 - 龙蜥/欧拉):**
在另一台联网的同版本 ARM64 机器上执行:
```bash
mkdir -p deb-packages/yum-deps
sudo yum install -y yum-utils
# 下载 Docker 及依赖
yumdownloader --resolve --destdir=deb-packages/yum-deps \
docker-ce docker-ce-cli containerd.io
# 下载常用工具
yumdownloader --resolve --destdir=deb-packages/yum-deps \
wget curl vim net-tools telnet
```
**如果目标系统使用 `apt` (D版本 - Debian):**
在另一台联网的同版本 ARM64 机器上执行:
```bash
mkdir -p deb-packages/apt-deps
sudo apt-get update
# 下载 Docker
apt-get download docker.io
apt-get download $(apt-cache depends --recurse --no-recommends --no-suggests \
--no-conflicts --no-breaks --no-replaces --no-enhances docker.io | grep "^\w")
# 下载常用工具
apt-get download wget curl vim net-tools telnet
```
---
## 📖 使用步骤
### 第一步:在联网笔记本上准备(有网络的环境)
1. 安装 Docker Desktop (Windows/Mac/Linux)
2. 执行上述下载命令,获取所有需要的文件
3. 将文件放入对应的目录中
4. 打包整个文件夹,传输到生产服务器
```bash
# 打包
tar czf owl-zlmediakit-offline-package-arm64.tar.gz \
docker-images/ deb-packages/ source-packages/ configs/ scripts/ 部署手册.md
```
### 第二步:在生产服务器上部署(离线环境)
1. 确认系统版本和包管理器类型 (`yum``apt`)
2. 安装 Docker使用提供的脚本或手动安装
3. 加载 Docker 镜像
4. 运行部署脚本
5. 验证部署结果
详细步骤请参考 `部署手册.md` 第五章。
---
## 🔧 目录结构说明
```
owl_zlmediakit/
├── 部署手册.md # 完整部署手册
├── README.md # 本文件
├── docker-images/ # Docker镜像文件需手动下载
│ ├── zlmediakit-master-arm64.tar
│ └── gowvp-latest-arm64.tar
├── deb-packages/ # 系统依赖包(需手动下载)
│ ├── docker-27.5.1.tgz (推荐) / docker-28.5.2.tgz / docker-29.4.1.tgz
│ ├── docker-compose-linux-aarch64
│ ├── yum-deps/ # yum系统依赖可选
│ └── apt-deps/ # apt系统依赖可选
├── source-packages/ # 源码包
│ ├── libsrtp-2.5.0.tar.gz # ✅ 已包含
│ ├── ZLMediaKit-master.zip # 需手动下载
│ └── owl_linux_arm64.tar.gz # 需手动下载
├── configs/ # 配置文件
│ ├── docker-compose.yml # ✅ 已包含
│ └── zlm-config.ini # ✅ 已包含
└── scripts/ # 部署脚本
├── install-docker.sh # ✅ 已包含
├── setup.sh # ✅ 已包含
└── verify.sh # ✅ 已包含
```
---
## ⚠️ 重要提示
1. **架构兼容性**: 所有镜像和二进制文件必须选择 **ARM64 (aarch64)** 版本x86_64 版本无法在飞腾S5000上运行
2. **统信UOS版本**: 1070军事版通常基于龙蜥/欧拉,使用 `yum` 包管理器,但请以实际系统为准
3. **Docker版本**: 建议 Docker >= 20.10,以支持多架构镜像
4. **libsrtp版本**: 如需源码编译 ZLMediaKit 并启用 WebRTClibsrtp 版本必须严格为 **2.5.0**,其他版本有兼容性问题
5. **端口占用**: 确保生产服务器的 80, 443, 15123, 15060, 1935, 554, 8000, 9000, 10000, 20000-20100 端口未被占用
---
## 📚 参考链接
| 资源 | 地址 |
|------|------|
| ZLMediaKit GitHub | https://github.com/ZLMediaKit/ZLMediaKit |
| ZLMediaKit 文档 | https://docs.zlmediakit.com/ |
| GoWVP (Owl) GitHub | https://github.com/gowvp/owl |
| Docker CE 下载 | https://download.docker.com/linux/static/stable/aarch64/ |
| Docker Compose 下载 | https://github.com/docker/compose/releases |
---
> 如有问题,请参考 `部署手册.md` 中的常见问题排查章节。