# 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 并启用 WebRTC，libsrtp 版本必须严格为 **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` 中的常见问题排查章节。