直播录制这件事,说简单也简单,说麻烦也麻烦。如果你只是偶尔录一场抖音直播,用系统自带的屏幕录制就够用;但如果你是内容创作者、运营人员,或者需要对多个平台进行长期值守录制,那你就需要一个能循环监测、自动录制、还不能太占资源的工具。
今天要介绍的 DouyinLiveRecorder,就是这样一款项目——它基于 FFmpeg 实现,支持 40+ 直播平台,GitHub 累计获得 9.8k Stars、1.3k Forks,在同类开源项目中属于头部存在。

相关链接
- GitHub:https://github.com/ihmily/DouyinLiveRecorder
- 最新版下载:https://github.com/ihmily/DouyinLiveRecorder/releases/latest
- Docker 镜像:https://hub.docker.com/r/ihmily/douyin-live-recorder
DouyinLiveRecorder 是什么
DouyinLiveRecorder 是一款简易的可循环值守直播录制工具,由开发者 ihmily 主导开发维护(项目贡献者众多),基于 Python 3.11 + FFmpeg 实现。其核心能力是:输入直播间地址,工具自动循环监测——主播开播则自动开始录制,播完自动停止并保存,真正实现「无人值守」。
MIT 开源协议,代码完全公开,历经 300+ 次提交,版本已迭代至 v4.0.7。项目结构清晰,除了核心录制功能外,还提供了消息推送(钉钉/微信/Bark/Email 等)、自定义录制画质、代理配置、分平台保存等配套功能。
核心功能
先说最核心的东西——支持平台数量。目前 DouyinLiveRecorder 已稳定支持 40+ 直播平台,包括但不限于:
- 国内主流:抖音、TikTok、快手、虎牙、斗鱼、B站、小红书、YY、网易 CC、微博直播、酷狗直播、花椒直播、百度直播、知乎直播、Acfun
- 海外平台:Youtube、Twitch、ShowRoom、TwitCasting、LiveMe、TikTok、SOOP(原 AfreecaTV)
- 电商直播:淘宝直播、京东直播、Shopee
- 其他平台:17Live、CHZZK、Picarto、咪咕、Faceit 等
基本上你听说过的直播平台,都覆盖了。具体每一项的稳定性,可以查看项目 README 中的 checkbox 清单,已完成的是「绿灯」状态。
功能细节上,有几个比较实用的设计:
- 循环值守:持续监测直播间状态,开播自动录,结束自动停,不用人工干预
- 多画质选择:默认录制原画,也可针对单个直播间单独设置超清/高清等画质
- 代理支持:录制 TikTok、SOOP 等海外平台,可配置全局或按平台设置代理
- 消息推送:支持 Bark、钉钉、企业微信、邮箱、pushplus、ntfy 等多种推送渠道,直播开始/结束都能收到通知
- 批量管理:一个配置文件搞定多个直播间,一行一个地址,想停哪个就在前面加 #
- 录制格式:推荐使用 ts 格式录制,异常中断后也能保证已录内容不损坏
快速部署
项目提供了多种运行方式,总有一种适合你。
方式一:下载即用(适合 Windows 小白用户)
直接前往 Releases 页面下载最新打包好的 zip 压缩包,解压后配置 config/URL_config.ini 添加直播间地址,运行 DouyinLiveRecorder.exe 即可。某些安全软件可能会报毒,忽略即可。
方式二:源码运行(适合有 Python 基础的用户)
项目推荐使用 uv 来管理 Python 环境和依赖,这也是我个人比较推荐的方式——一条命令搞定虚拟环境和依赖安装:
git clone https://github.com/ihmily/DouyinLiveRecorder.git
cd DouyinLiveRecorder
uv sync
uv run main.py
如果遇到 pip 安装速度慢的问题,项目文档里也贴心地提供了使用清华镜像源的方法。
另外需要注意,FFmpeg 是录制必需的依赖。Windows 用户下载的打包版自带 ffmpeg.exe,可以跳过这一步;Linux/macOS 用户需要自行安装:
# Ubuntu
apt update && apt install ffmpeg
# CentOS
yum install epel-release && yum install ffmpeg
# macOS
brew install ffmpeg
方式三:Docker 部署(适合有容器经验的用户)
一条命令启动:
docker-compose up
注意,在容器内运行之前,需要先在宿主机上编辑配置文件添加直播间地址,然后再启动容器。另外,强烈建议将录制格式设置为 ts,避免手动中断导致视频文件损坏。
适用人群
从我的实际体验来看,这个工具比较适合以下几类用户:
- 内容创作者:需要保存自己直播或他人直播素材,用于二次创作
- 直播运营人员:监测多个账号/平台的直播动态,批量存档
- 研究/数据分析人员:采集直播数据、弹幕、互动信息用于研究分析
- 技术爱好者:研究直播流获取原理,学习 FFmpeg 实战应用
不过需要提醒的是,录制他人直播涉及版权问题,请确保用于个人学习研究或经授权的用途,不要用于商业传播。
测试体验
WarpNav 小编测试了录制 B站直播间和抖音直播间两个场景,整个流程相当顺畅。
在 Windows 上使用打包版的话,解压即用,几乎零门槛。配置文件写好直播间地址,运行 EXE,控制台窗口会实时输出各直播间的状态——「监测中」「录制中」「已停止」,一目了然。小编测试的 B站直播间从开播到检测到开始录制,大约等了 30 秒左右,不算快但也不算慢,毕竟要走完「检测开播→获取流地址→启动 FFmpeg」这个链路。
录制画质方面,默认原画体验不错,文件保存在 downloads 目录,按平台分文件夹存放,命名格式是「主播名+开始时间」,后期整理素材时很方便找。唯一比较麻烦的是抖音直播间有时候会因为请求频繁触发风控导致获取不到流地址,项目文档建议把循环检测间隔设置长一些,比如 120 秒以上,能有效降低被封 IP 的概率。
另外测试了一下 Docker 部署方式,对于已经有 Docker 环境的人来说,这条命令确实是最干净的方案,不需要在主机上装 Python 和各种依赖。容器启动后观察内存占用也比较克制,录制期间 CPU 占用也不高,长期挂着值守完全没问题。
整体来说,DouyinLiveRecorder 是一个功能完善、维护活跃、文档清晰的开源项目。如果你有直播录制需求,它值得一试。