ZLMediaKit 快速开始指南

简介

ZLMediaKit 是一个流媒体服务器项目，本教程（快速开始）将指导开发者完成 ZLMediaKit 的编译与运行，帮助新手在本地构建环境并启动相关程序。官方强烈建议新手使用 Ubuntu 16 以上版本编译，macOS 为次选，不推荐 CentOS 6.x 或 Windows。

构建环境

• 编译器：需支持完整 C++11 标准。Linux 下 gcc >= 4.8；macOS 下 Clang（版本未明确）；Windows 下 Visual Studio >= 2015（建议 vs2017）。
• CMake：项目使用 CMake 构建，需提前安装（如 Debian/Ubuntu 下 sudo apt install cmake）。
• 获取代码：使用 Git 克隆并初始化子模块，不可通过下载 zip 包方式获取（因依赖 Git 子模块管理）。
  bash 复制代码

  git clone --depth 1 https://gitee.com/xia-chu/ZLMediaKit
  cd ZLMediaKit
  git submodule update --init

• 依赖库：
  • 必须：openssl（用于 flash player 播放 rtmp、https/rtsps/webrtc 等）。
  • 可选：ffmpeg（运行时 fork 进程拉流，编译不需安装）、sdl、avcodec、avutil（仅 test_player 测试用，通常不需安装）。
  • Debian/Ubuntu 安装示例：sudo apt install libssl-dev 等。

主要功能与产物

构建编译步骤（Linux 示例）：

cd ZLMediaKit
mkdir build
cd build
cmake ..
make -j4

编译后主要在 release 目录生成三类二进制目标：

MediaServer 进程

作为服务器的主进程，可直接作为测试流媒体服务器使用，无需开发。支持通过 Web HOOK 和 RESTful API 实现复杂业务逻辑，通过配置文件控制参数。启动示例：

cd ZLMediaKit/release/linux/Debug
./MediaServer -h        # 查看启动参数
./MediaServer -d &      # 守护进程模式

C 接口的 SDK

提供 C 接口 SDK 库，头文件位于 ZLMediaKit/api/include（含详细注释），库文件如 ZLMediaKit/release/linux/Debug/libmk_api.so，供二次开发。

以 test_ 开头的测试程序

代码在 ZLMediaKit/tests 目录，可对照代码启动测试进程。

适用场景

• 快速搭建本地流媒体测试服务器（MediaServer）。
• 基于 C SDK 进行流媒体相关二次开发。
• 学习 ZLMediaKit 编译流程及推流测试（推流测试参考官方推流播放测试页）。

注意：默认不开启 webrtc 编译，需参考专项文档开启。