要在 Windows 11 本地环境中下载并运行 zlmediakit/zlmediakit:master Docker 镜像

要在 Windows 11 本地环境中下载并运行 zlmediakit/zlmediakit:master Docker 镜像

---

步骤 1：安装 Docker Desktop（Win11）

1、下载 Docker Desktop

访问 Docker 官网 下载并安装。
确保启用 WSL 2（Windows Subsystem for Linux 2）。
安装后重启电脑。

2、检查 Docker 是否运行

打开终端（PowerShell / CMD），运行：

docker --version

确保输出类似 Docker version 20.10.x，说明 Docker 已安装成功。

步骤 2：拉取 zlmediakit/zlmediakit:master 镜像

在终端运行：

docker pull zlmediakit/zlmediakit:master

说明：
zlmediakit/zlmediakit 是镜像名称。
master 是标签（即版本）。
如果下载慢（国内网络可能较慢）：
可以设置国内镜像加速器：

# 编辑 Docker 配置文件（Windows 是 `%USERPROFILE%\.docker\daemon.json`）
# 加入以下内容：
{
  "registry-mirrors": [
    "https://registry.docker-cn.com",
    "https://docker.mirrors.ustc.edu.cn"
  ]
}

重启 Docker 使配置生效。

步骤 3：运行 ZLMediaKit

1、直接运行（测试用）

docker run -it --rm zlmediakit/zlmediakit:master

-it 表示交互模式运行。
–rm 表示容器停止后自动删除（适用于临时测试）。

2、后台运行（推荐）

docker run -d --name zlmedia -p 1935:1935 -p 8080:8080 zlmediakit/zlmediakit:master

-d 表示后台运行。
--name zlmedia 为容器命名（方便管理）。
-p 1935:1935 映射 RTMP 端口（直播推流）。
-p 8080:8080 映射 HTTP API 端口（Web 接口）。

3、验证是否运行成功

docker ps

应该能看到 zlmediakit 容器在运行。

步骤 4：测试 ZLMediaKit

1、检查 RTMP 流
使用 OBS 或 FFmpeg 推流到：

rtmp://localhost:1935/live/stream

然后用 VLC 播放：

rtmp://localhost:1935/live/stream

2、访问 Web 管理界面
浏览器打开：

http://localhost:8080

查看 ZLMediaKit 的 API 文档和状态。

步骤 5（可选）：挂载本地目录持久化数据

如果需要在容器运行期间保留配置文件或录制文件，可以使用 -v 挂载本地目录：

docker run -d --name zlmedia \
  -p 1935:1935 -p 8080:8080 \
  -v "C:/docker_zlmedia/conf:/opt/zlmediakit/conf" \
  -v "C:/docker_zlmedia/www:/opt/zlmediakit/www" \
  zlmediakit/zlmediakit:master

C:/docker_zlmedia/conf（本地存放配置文件）
C:/docker_zlmedia/www（本地存放录制的流）

常见问题

1. docker pull 报错 “no matching manifest for windows/amd64”
   原因：ZLMediaKit 是基于 Linux 的 Docker 镜像，不能在 Windows 原生运行（即使安装了 Docker）。
   解决方法：
   确保 WSL 2 已启用（Docker Desktop 设置里勾选）。
   运行 wsl --list 确认 WSL 已启动。
2. 端口冲突（如 8080 被占用）
   修改映射端口：

docker run -d --name zlmedia -p 1935:1935 -p 8888:8080 zlmediakit/zlmediakit:master

然后用 http://localhost:8888 访问。

3. 如何查看容器日志？

docker logs zlmedia

总结

`

步骤	命令
安装 Docker	下载 Docker Desktop
拉取镜像	docker pull zlmediakit/zlmediakit:master
运行容器	docker run -d --name zlmedia -p 1935:1935 -p 8080:8080 zlmediakit/zlmediakit:master
访问 Web	http://localhost:8080
推流测试	rtmp://localhost:1935/live/stream

推荐学习：

Docker 官方文档
ZLMediaKit 文档