免费开源抖音下载工具实战：30分钟学会直播回放保存与批量下载

免费开源抖音下载工具实战：30分钟学会直播回放保存与批量下载

【免费下载链接】douyin-downloaderA practical Douyin downloader for both single-item and profile batch downloads, with progress display, retries, SQLite deduplication, and browser fallback support. 抖音批量下载工具，去水印，支持视频、图集、合集、音乐(原声)。项目地址: https://gitcode.com/GitHub_Trending/do/douyin-downloader

核心关键词：抖音直播下载、抖音批量下载、抖音内容留存；长尾词：直播回放保存、博主作品批量下载、抖音评论采集

周五晚上十点，小周点进一直关注的美食博主主页，发现刚才那场直播已经结束。他想回看那道糖醋排骨的完整步骤，翻遍平台也找不到回放入口。这已经不是他第一次和直播内容擦肩而过。后来同事递来一个免费开源工具 douyin-downloader，告诉他：抖音直播下载、博主作品批量下载、评论区内容留存，这一套它都能安排。

如果你也囤积教程、追更博主，或者需要把直播内容留作学习资料，这篇文章会陪你从安装一路走到熟练使用，全程不用写一行复杂代码。

先认识它：一个把抖音内容"搬回家"的工具

douyin-downloader 是一个面向实用场景的抖音下载工具，支持视频、图文、合集、音乐原声，也能批量拉取博主主页的作品，还可以录制直播、采集评论。它的核心价值可以概括成一句话：把你看到的抖音内容，变成硬盘里随时能翻看的文件。

适合用它的人大致有三类：一是想保存知识直播、反复学习的学习型用户；二是喜欢某个创作者、想完整留存其作品的追更党；三是做内容整理归档的运营或编辑。工具完全免费开源，命令行为主，也有配套的桌面版，下文会讲到。

上图是它跑批量任务时的样子：作品数量、线程数、保存路径、跳过已存在文件的提示都一目了然。下面我们从零把它跑起来。

第一次上手：从安装到跑通第一条下载

环境只需要 Python 3.8 以上，macOS、Linux、Windows 都支持。先把代码拿到本地：

git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt

这三条命令分别负责：把项目下载到本地、进入项目目录、安装全部依赖。

抖音接口需要登录态，好在不用手动复制 Cookie。运行自动获取命令，浏览器会自己打开：

python -m tools.cookie_fetcher --config config.yml

登录抖音后回到终端按一下回车，程序会把认证信息写进配置。以后 Cookie 过期了，重跑这条命令就能续上。

接着复制一份配置文件，往里填你想下载的链接：

cp config.example.yml config.yml

config.example.yml 是项目自带的示例配置，每一项都有注释说明。第一次跑通，先放一条最简单的链接：

link: - https://www.douyin.com/video/1234567890123456789 path: ./Downloaded/

这段配置的作用是：告诉工具去下载这一条视频，存到当前目录下的 Downloaded 文件夹。然后执行：

python run.py -c config.yml

跑完之后打开 Downloaded，视频、封面、音乐和一份 JSON 元数据都在。所谓元数据，就是标题、作者、发布时间这些信息，之后整理内容全靠它。

把直播留档：错过直播，不再错过内容

小周最关心的就是直播留存。知识分享类直播往往没有回放，而 douyin-downloader 支持直接录制直播间，把直播链接放进配置即可：

link: - https://live.douyin.com/123456789 live: max_duration_seconds: 3600 # 录 1 小时，填 0 则录到主播下播 chunk_size: 65536 idle_timeout_seconds: 30

这段配置的作用是：把直播流按时长切分保存，主播下播或网络空闲时会自动收尾，已经录下来的内容不会丢。录制结果会存到作者目录下的 live 文件夹，还附带一份直播间信息快照。

录制支持 FLV 和 HLS 两种来源。需要留意的是，HLS 源目前只保存播放列表文件，想转成可播放的视频还得借助 ffmpeg 做一次后处理，属于实验性能力，官方文档里写得很清楚。

批量追更一个博主：一次跑完他的全部作品

小周后来发现，真正省时间的还是批量下载。他关注了一位做家居改造的博主，主页上有几百条作品，手工一条条存太不现实。于是他在配置里这样写：

link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx path: ./Downloaded/ mode: - post # 博主发布的作品 - like # 博主点赞过的公开作品 - mix # 博主的合集 - music # 博主使用过的原声 number: post: 0 # 0 表示不限制数量

这段配置的用途是：进入博主主页，按发布、点赞、合集、原声四个维度分别拉取。工具会自动按"作者名/类型"建好目录，同一个作品即使出现在多个模式里，也只下载一次。

Downloaded/ └── 博主昵称/ ├── post/ ├── like/ ├── mix/ └── music/

更贴心的是增量下载。把increase.post: true和database: true打开，程序会用 SQLite 记录下载历史，下次再跑同一任务只下载新发布的作品，已有的自动跳过。对长期追更的人来说，这相当于给博主主页装了一个"有更新才同步"的开关。

让整理变得省心：命名、筛选、评论与通知

批量下载只是第一步，把内容整理得随时能找到才是关键。这几处配置值得花两分钟设置。

命名规则。默认文件名是"日期_标题_作品ID"，你也可以按自己的习惯定制：

filename_template: "{date}_{title}_{id}" author_dir: "nickname_uid"

它的作用是让每个文件自带日期和标题，一眼认出内容，之后检索也方便。

时间筛选。只想保留某个时间段的作品，用start_time和end_time圈定范围，比如只下载今年上半年的内容。

评论采集。做内容运营的人常需要分析用户反馈。开启评论采集后，每个作品会额外生成一份_comments.json：

comments: enabled: true max_comments: 500 # 0 表示不限

这样评论区就变成可检索的文本数据，适合做选题参考或舆情梳理。

完成通知。任务跑完想第一时间知道？配置一个通知推送即可，支持 Bark、Telegram 和 Webhook：

notifications: enabled: true on_success: true providers: - type: bark url: https://api.day.app/YOUR_DEVICE_KEY

搜索与接口。命令行还藏着两个顺手能力：python run.py --hot-board 30可以拉取热搜榜，python run.py --search "关键词"可以按关键词搜索作品并导出 JSONL。想把下载能力接进自己的系统，运行python run.py --serve --serve-port 8000会启动一个 REST API 服务，通过 HTTP 提交下载任务，适合接入自动化流程。

几个常见疑问，一次性说清

问：为什么有时只拉到 20 条作品？答：这是平台翻页限制，属于正常现象。可以开启配置里的browser_fallback（浏览器兜底），翻页受限时程序会弹出浏览器，手动完成一次验证码，它就能继续往下抓。

问：Cookie 过期了怎么处理？答：不用手动找 Cookie，重跑一次python -m tools.cookie_fetcher --config config.yml，重新登录即可。

问：想重新下载某条视频，但它总被跳过？答：程序靠"数据库记录 + 本地文件"双重判断去重。想重下某一条，删掉对应的本地文件夹，再用 sqlite3 删掉数据库里那条记录即可，具体命令在 USAGE.md 里有现成示例。

问：下载历史怎么查？答：数据库默认生成dy_downloader.db，可以用 sqlite3 直接查询，也可以打开桌面版的任务中心看图形化的历史列表。

除了命令行，还有桌面版

如果你不习惯敲命令，项目还附带一个基于同一套后端的桌面客户端 Douzy：粘贴链接即刻开始、同步关注列表、任务中心逐条展示状态、作品档案按作者和关键词筛选，下载历史都存在 SQLite 里。当前处于内测阶段，可以从项目 Releases 页面下载安装文件。

想深入了解细节，可以翻仓库里的几份材料：USAGE.md是完整使用手册，config.example.yml是全部配置项的对照表，core/目录是下载流程的源码，想二次开发可以从这里入手。

结尾：把精彩留在自己的硬盘里

回到小周。现在他每周五都会顺手把喜欢的直播录下来，周末再把博主主页的新作品同步一次，评论区也定期导出做选题。当初错过的那道糖醋排骨，如今在他的硬盘里躺得整整齐齐，连发布日期都标得清清楚楚。

如果你也经常为"内容消失"而遗憾，不妨今晚就动手：克隆项目、配好认证、放上第一条链接。从单条视频到直播回放，再到整个博主的作品库，你可以按自己的节奏一点点建起来。

最后提醒一句：工具本身仅用于技术研究和个人数据管理。下载的内容请只用于个人学习研究，尊重创作者版权，遵守平台规则。把好用的工具用对地方，它才会一直好用下去。

【免费下载链接】douyin-downloaderA practical Douyin downloader for both single-item and profile batch downloads, with progress display, retries, SQLite deduplication, and browser fallback support. 抖音批量下载工具，去水印，支持视频、图集、合集、音乐(原声)。项目地址: https://gitcode.com/GitHub_Trending/do/douyin-downloader