news 2026/5/29 6:43:22

Ubuntu 20.04下ZLMediaKit编译全攻略：从依赖安装到WebRTC推流测试

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
Ubuntu 20.04下ZLMediaKit编译全攻略：从依赖安装到WebRTC推流测试

Ubuntu 20.04下ZLMediaKit编译全攻略：从依赖安装到WebRTC推流测试

在流媒体开发领域，ZLMediaKit凭借其高性能和丰富的功能支持，已成为众多开发者的首选框架。特别是在WebRTC推拉流场景中，它展现出了卓越的稳定性和低延迟特性。本文将带你从零开始，在Ubuntu 20.04系统上完成ZLMediaKit的完整编译过程，并重点解决WebRTC模块配置中的常见问题。

1. 环境准备与依赖安装

在开始编译ZLMediaKit之前，确保你的Ubuntu 20.04系统已经更新到最新状态：

sudo apt update && sudo apt upgrade -y

1.1 基础工具链安装

编译ZLMediaKit需要以下基础工具链：

sudo apt install -y build-essential cmake git pkg-config

关键版本要求：

  • GCC ≥ 7.3
  • CMake ≥ 3.0
  • Git ≥ 2.0

1.2 OpenSSL编译与配置

WebRTC功能需要特定版本的OpenSSL支持，建议从源码编译安装：

wget https://www.openssl.org/source/openssl-1.1.1w.tar.gz tar -xzf openssl-1.1.1w.tar.gz cd openssl-1.1.1w ./config --prefix=/usr/local/openssl --openssldir=/usr/local/openssl shared zlib make -j$(nproc) sudo make install

配置环境变量确保系统能找到新安装的OpenSSL：

echo 'export PATH=/usr/local/openssl/bin:$PATH' >> ~/.bashrc echo 'export LD_LIBRARY_PATH=/usr/local/openssl/lib:$LD_LIBRARY_PATH' >> ~/.bashrc source ~/.bashrc

1.3 其他关键依赖

安装WebRTC所需的libsrtp库：

git clone https://github.com/cisco/libsrtp.git cd libsrtp ./configure --enable-openssl make -j$(nproc) && sudo make install

安装多媒体相关依赖：

sudo apt install -y libssl-dev libsdl2-dev libavcodec-dev libavutil-dev ffmpeg

2. ZLMediaKit源码获取与准备

2.1 克隆源码仓库

推荐使用国内镜像源加速下载：

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

2.2 初始化子模块

这是很多开发者容易忽略的关键步骤：

git submodule update --init --recursive

注意：如果网络环境不佳，可能导致子模块下载失败。此时可以尝试多次执行该命令，或手动修改.gitmodules文件中的仓库地址为国内镜像源。

3. 编译配置与构建

3.1 创建构建目录

mkdir build && cd build

3.2 CMake配置选项

启用WebRTC支持的核心配置命令：

cmake .. -DENABLE_WEBRTC=on \ -DOPENSSL_ROOT_DIR=/usr/local/openssl \ -DOPENSSL_LIBRARIES=/usr/local/openssl/lib

常用编译选项：

选项说明默认值
ENABLE_WEBRTC启用WebRTC支持OFF
ENABLE_SRT启用SRT协议支持OFF
ENABLE_RTPPROXY启用RTP代理功能OFF
BUILD_SHARED_LIBS构建动态链接库OFF

3.3 开始编译

使用多核并行编译加速过程：

make -j$(nproc)

3.4 常见编译问题解决

问题1：OpenSSL路径错误

症状：

Could NOT find OpenSSL, try to set the path to OpenSSL root folder...

解决方案：

  • 确保环境变量已正确设置
  • 显式指定OpenSSL路径：
cmake .. -DOPENSSL_ROOT_DIR=/usr/local/openssl

问题2：libsrtp链接失败

症状：

undefined reference to `srtp_init'

解决方案：

  • 检查libsrtp是否安装成功
  • 添加链接路径：
export PKG_CONFIG_PATH=/usr/local/lib/pkgconfig:$PKG_CONFIG_PATH

4. WebRTC推流测试实战

4.1 准备运行环境

编译完成后，生成的可执行文件位于：

cd release/linux/Debug

复制Web测试页面：

cp -r ../../../www .

生成SSL证书（用于HTTPS和WebRTC）：

openssl req -newkey rsa:2048 -nodes -keyout ssl.key -x509 -days 365 -out ssl.crt cat ssl.key ssl.crt > ssl.pem

4.2 启动媒体服务器

./MediaServer -s ./ssl.pem

4.3 浏览器测试

访问以下URL进行测试：

https://[服务器IP]/webrtc/

测试场景示例：

  1. 推流端：

    • 点击"Push"按钮
    • 允许浏览器访问摄像头和麦克风
    • 观察视频是否正常传输

  2. 播放端：

    • 点击"Play"按钮
    • 输入推流端生成的流ID
    • 检查视频延迟和画质

4.4 性能优化参数

在config.ini中添加以下WebRTC相关配置：

[webrtc] # 启用UDP传输 enable_udp=1 # 启用TCP传输 enable_tcp=1 # 端口范围 port_range=30000-40000 # 关键帧请求间隔 keyframe_gop=100

5. 高级配置与生产环境部署

5.1 系统调优

提高文件描述符限制：

ulimit -n 65535

调整内核网络参数：

echo 'net.core.rmem_max=4194304' | sudo tee -a /etc/sysctl.conf echo 'net.core.wmem_max=4194304' | sudo tee -a /etc/sysctl.conf sudo sysctl -p

5.2 守护进程配置

创建systemd服务文件：

[Unit] Description=ZLMediaKit Media Server After=network.target [Service] Type=simple User=media WorkingDirectory=/opt/zlm/release/linux/Debug ExecStart=/opt/zlm/release/linux/Debug/MediaServer -c /opt/zlm/config.ini -s /opt/zlm/ssl.pem Restart=always RestartSec=5s [Install] WantedBy=multi-user.target

5.3 监控与日志

启用详细日志记录：

[log] # 日志级别：0-4（0为最详细） level=3 # 日志文件路径 file_path=./logs # 单个日志文件大小(MB) max_size=50

6. WebRTC扩展功能开发

6.1 自定义信令协议

ZLMediaKit支持通过插件扩展WebRTC信令协议。基本开发流程：

  1. 创建插件目录结构：
webrtc-plugin/ ├── CMakeLists.txt └── src/ └── webrtc_signaling.cpp
  1. 实现核心接口：
class WebRTCSignaling : public WebRTCInterface { public: void onOffer(const string &offer, const onResp &cb) override { // 处理SDP offer string answer = generateAnswer(offer); cb(answer); } };

6.2 集成STUN/TURN服务

配置外网可访问的WebRTC服务：

[webrtc] # STUN服务器地址 stun_server=stun.l.google.com:19302 # TURN服务器配置 turn_server=turn:example.com:3478 turn_user=username turn_password=password

6.3 性能监控接口

ZLMediaKit提供了丰富的API用于监控WebRTC会话状态：

GET /index/api/getWebRTCInfo

响应示例：

{ "code": 0, "data": { "sessions": 15, "bitrate": 2500000, "loss_rate": 0.02 } }

在实际项目部署中，我们发现WebRTC的UDP传输在跨运营商环境下可能会出现连接不稳定的情况。这时可以尝试启用TCP回退功能，或者结合QUIC协议来改善传输质量。对于大规模并发场景，建议将TURN服务器部署在边缘节点，并启用ZLMediaKit的集群模式来实现负载均衡。

版权声明: 本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若内容造成侵权/违法违规/事实不符，请联系邮箱：809451989@qq.com进行投诉反馈，一经查实，立即删除！
网站建设 2026/5/29 6:42:57

2025_NIPS_Open-World Drone Active Tracking with Goal-Centered Rewards

文章核心总结 本文针对开放世界无人机主动跟踪的基准缺失和复杂环境适应性问题，提出了首个开放世界无人机空对地主动跟踪基准DAT和强化学习方法GC-VAT。DAT提供24个城市级场景、高保真动力学模拟和数字孪生场景生成工具；GC-VAT通过目标中心奖励函数和课程式训练策略，实现了…

作者头像 李华
网站建设 2026/5/28 12:30:01

llama-cpp-python 的CPU与GPU安装指南：从基础配置到性能优化

1. 环境准备：硬件与软件基础 在开始安装llama-cpp-python之前，我们需要确保硬件和软件环境满足基本要求。我遇到过不少开发者因为忽略了这个步骤，导致后续安装过程频繁报错。首先确认你的设备是否具备NVIDIA显卡——打开终端输入lspci | grep…

作者头像 李华
网站建设 2026/5/23 2:10:43

WiFiConnect Lite：ESP32/ESP8266轻量级WiFi配置库解析

1. WiFiConnect Lite：面向ESP32/ESP8266的轻量级WiFi配置管理库深度解析 1.1 项目定位与工程演进脉络 WiFiConnect Lite 是一个聚焦于嵌入式WiFi连接管理的精简型开源库，其技术谱系可追溯至已停止维护的经典项目 WiFiManager。该库并非从零构建&#x…

作者头像 李华
网站建设 2026/5/23 2:10:54

FMEA在CNAS软件测试实验室公正性风险评估中的实践指南

1. 为什么软件测试实验室需要关注公正性风险 在软件测试这个行当里干了十几年，我见过太多因为忽视公正性问题而翻车的案例。去年有个第三方检测机构，因为被查出给自家投资的游戏公司出具虚假测试报告，直接被撤销了CNAS认可资格。这可不是闹着…

作者头像 李华
网站建设 2026/5/23 2:10:55

Unity游戏开发：Physics.SphereCast实战技巧与常见问题解决

Unity游戏开发：Physics.SphereCast实战技巧与常见问题解决 在3D游戏开发中，精确的碰撞检测是实现真实物理交互的基础。当简单的射线检测无法满足复杂场景需求时，Physics.SphereCast便成为开发者工具箱中的利器。想象一下，你需要检…

作者头像 李华