背景:传统 WebRTC 编译到底卡在哪?
做实时音视频的同学都懂,WebRTC 源码动辄 20 GB,拉取一次就要半天。
更糟的是,它自带一套“全家桶”依赖:absl、protobuf、ffmpeg、libjpeg、opus……只要其中某个版本对不上,编译器就甩出一屏红色弹幕。
公司内网还时不时抽风,gclient sync 到 99% 断线重来,心态直接炸裂。
于是大家开始找替代方案:docker 镜像、预编译 SDK、vcpkg 等等。
这些都能用,但体积大、升级慢,跨平台还得再编一份。
直到我把目光移到 conda——这个原本给 Python 科学计算准备的包管理器,居然把 WebRTC 全家桶都悄悄打好了二进制包,而且跨 Windows/Linux/macOS 统一版本号。
试了一次就回不去,遂整理成这份“避坑手册”。
技术对比:conda 凭什么胜出?
源码编译
- 优势:可裁剪、可调试、可上定制补丁
- 劣势:时间长、磁盘占用 50 GB+、CI 排队感人
Docker 镜像
- 优势:环境一次打包,团队复用
- 劣势:镜像 5 GB 起步,推送/拉取都占带宽;本地调试要挂 volume,Windows 下性能打折
conda 二进制包
- 优势:
- 下载体积 < 300 MB(压缩后),公司内网镜像源 5 分钟搞定
- 版本号全局一致,依赖冲突时自动报错,不给你“惊喜”
- 与 CMake / Ninja / Visual Studio 无缝衔接,调试符号可拆可合
- 劣势:
- 官方 channel 更新略慢大版本 2-3 周
- 静态编译选项不如源码灵活(普通项目够用)
- 优势:
一句话:想“快速把 WebRTC 跑起来”而不是“研究 WebRTC 本身”,conda 最划算。
核心实现:三步把 WebRTC 装进电脑
1. 环境配置
# 新建一个干净环境,Python 版本随意,我们只看 C++ 库 conda create -n webrtc-cxx conda-forge::webrtc=118 cmake ninja -y conda activate webrtc-cxxchannel 优先级写在~/.condarc里,避免以后每次-c:
channels: - conda-forge - nodefaults # 防止混入 anaconda 主仓库的旧包2. 版本锁定策略
多人协作最怕“我这边能编,你那边报错”。
把环境导出成environment.yml并写死 build number:
name: webrtc-cxx channels: - conda-forge dependencies: - webrtc=118.0.0=*_h4c0c8c7_3 # buildbuild 号也锁死 - cmake>=3.26 - ninja - pkg-configCI 里直接conda env create -f environment.yml,保证任何时间都能复现。
3. 关键路径速查
安装完先打印变量,省得后面 CMake 写错:
conda list webrtc # Name Version Build Channel # webrtc 118.0.0 h4c0c8c7_3 conda-forge pkg-config --cflags --libs webrtc # -I$CONDA_PREFIX/include/webrtc -L$CONDA_PREFIX/lib -lwebrtcCMake 集成:把库真正链进项目
cmake_minimum_required(VERSION 3.26) project(my_p2p LANGUAGES CXX) # 1. 找到 conda 提供的 webrtc find_package(PkgConfig REQUIRED) pkg_check_modules(WEBRTC REQUIRED webrtc) # 2. 头文件 + 库路径 add_executable(p2p_demo main.cpp peer_connection_observer.cpp ) target_include_directories(p2p_demo PRIVATE ${WEBRTC_INCLUDE_DIRS}) target_link_libraries(p2p_demo PRIVATE ${WEBRTC_LIBRARIES}) # 3. C++17 与异常符号 set_property(TARGET p2p_demo PROPERTY CXX_STANDARD 17)Windows 下 conda 包同样提供.lib+.dll,find_library一把梭,无需改动。
生产考量:二进制兼容与体积裁剪
兼容
conda-forge 的 Linux 包用 CentOS7 容器编,GLIBC 2.17,能覆盖 90% 生产发行版。
若目标机更老,可自己 conda build 降 ABI,或把webrtc静态库重新打包。体积
Debug 版符号 300 MB,交付前用strip -g $CONDA_PREFIX/lib/libwebrtc.so可缩到 40 MB;
若仍嫌大,conda 安装webrtc-static包,只把.a链进最终可执行文件,运行时零依赖。
避坑指南:两个大坑一次说清
GLIBC 冲突
现象:本地跑得好好的,放到客户 Ubuntu 18 上提示version GLIBC_2.29 not found。
根因:conda-forge 包在 CentOS7 编,但开发机被系统 ffmpeg 带进来高版本 glibc。
解法:
- 环境变量隔离
LD_LIBRARY_PATH=$CONDA_PREFIX/lib:$LD_LIBRARY_PATH - 或者干脆
conda install 'ffmpeg<5'把高版本踢掉,让 webrtc 用自带 ffmpeg 4.4。
ffmpeg 依赖树循环
webrtc 自带 ffmpeg,conda-forge 也提供 ffmpeg,二者符号重名,链接器随机抓一个。
解决:
- 编译阶段
pkg-config --static --libs webrtc强制只链 webrtc 内部 ffmpeg; - 运行阶段
conda install webrtc-ffmpeg-compat做符号转发,避免双份 so 打架。
互动:跑通最小 P2P 示例
把下面代码粘到main.cpp,编译成功后,两端机器分别跑:
// 极简验证:创建 PeerConnection,打洞成功即打印 Candidate #include <api/peer_connection_interface.h> #include <api/create_peerconnection.h> rtc::scoped_refptr<webrtc::PeerConnectionInterface> pc_webrtc( webrtc::CreatePeerConnectionFactory()->CreatePeerConnection( {}, nullptr, nullptr, nullptr, nullptr)); // 具体信令代码略……- 内网两台机器运行
p2p_demo - 观察日志出现
Got candidate: udp host …即证明 conda 提供的 WebRTC 动态库工作正常。 - 若 Candidate 迟迟不出,检查防火墙 UDP 端口,或把
conda install coturn本地搭个中继验证。
小结
用 conda 管理 WebRTC,其实就是“把操作系统级依赖交给专业的人打理”。
省下来的编译时间,可以专心写业务逻辑,而不是盯着 ninja 进度条发呆。
当然,真要做深度定制(改 RTP 封装、调带宽预测)还是得回到源码。
但 90% 的实时音视频项目,conda 版 WebRTC 足够稳、足够快。
祝你编译不报错,Candidate 一路绿灯。