企业官网建设流程全解析

抖音下载工具 douyin-downloader 完整使用指南：直播回放与批量下载一次搞定

【免费下载链接】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 是一个开源的抖音内容下载器，覆盖面比我最初想象的大得多：单个视频、图文笔记、合集、音乐原声都能下，而且自动优先无水印、自动挑选最高清片源；把用户主页链接丢进去，就能批量下载这位作者发布的作品、点赞的作品、合集的视频甚至他用的音乐；输入直播间地址，还能把整场直播录下来。

最打动我的是它的"省心"设计：内置进度条展示、失败自动重试、SQLite 数据库去重、下载完整性校验，还有翻页受限时的浏览器兜底。你不需要懂编程，只要有 Python 3.8 以上环境，照着下面的命令一步步来就能跑起来。

看完这张图你应该有感觉了——右侧是清晰的下载配置，左侧是实时进度和统计，整个过程完全可视化。接下来就跟着我的足迹，从环境搭建开始。

从零开始的环境准备：把工具请进你的电脑

别担心，这一步真的只需要三条命令。打开终端，逐行执行：

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

等等，你是不是也好奇为什么克隆完还要再cd进一层？因为这个仓库里装的是完整的新版项目，run.py、tools这些核心文件都在douyin-downloader子目录里，进去就对了。

如果你希望用到"自动获取 Cookie"和"浏览器兜底"这两个省心功能，建议顺手把 Playwright 也装上，同样很简单：

pip install playwright python -m playwright install chromium

环境就绪后你会发现，真正花时间的从来不是安装，而是后面怎么配置——而这一步工具也替你简化到了极致。

首次使用完整流程：下载一位博主主页的全部作品

我用一个具体场景带你走完全程：某天我发现了一位宝藏博主，主页有几十条高质量作品，想一次性全部保存下来。

第一步：复制配置并填上链接

项目自带一个写满注释的示例配置，先复制一份：

cp config.example.yml config.yml

然后打开config.yml，把想下载的链接填进link，选好下载模式和数量：

link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx path: ./Downloaded/ mode: - post - like number: post: 50 like: 20 thread: 5 retry_times: 3

这里解释几个关键字段，其实都不难：mode里post是作者发布的作品、like是他点赞的作品、mix是合集、music是他使用的音乐，可以同时填多个；number控制每种模式下载多少条，填0表示不限制；thread是并发数，默认 5 就够用了。

第二步：自动获取登录态，告别手动粘贴 Cookie

以前用类似的工具，最烦的就是手动复制一整串 Cookie，动不动就失效。douyin-downloader 提供了自动获取命令：

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

运行后会自动弹出浏览器让你登录抖音，登录完成后回到终端按一下回车，程序会把认证信息自动写进配置。整个过程不用复制粘贴任何东西，体验非常顺滑。

第三步：一条命令开始下载

配置和认证都搞定后，剩下的事情就是运行：

python run.py -c config.yml

如果临时想换个目标，也可以直接在命令行追加参数，不用反复改配置文件：

python run.py -c config.yml -u "https://www.douyin.com/video/1234567890123456789" -t 8

看到屏幕上出现一排排 100% 的绿色进度条时，那种满足感真的很难形容。而且工具会自动跳过已下载过的内容，哪怕中途断了重跑，也不会重复劳动。

第四步：在规范的文件目录里找到成果

下载完成后，打开path指定的目录，你会发现文件夹结构清晰得不像一个命令行工具产出的：

Downloaded/ └── 作者昵称/ ├── post/ │ └── 2024-02-07_作品标题_aweme_id/ │ ├── 视频.mp4 │ ├── 封面.jpg │ ├── 原声.mp3 │ └── 元数据.json ├── like/ └── mix/

每个作品一个独立文件夹，视频、封面、音乐、JSON 元数据分门别类，文件名自带日期和标题，找什么都一目了然。第一次跑通这个流程后，我就开始琢磨它的更多玩法了。

进阶玩法速览：增量下载、直播回放录制与完成通知

用顺手之后，有几个进阶功能让我彻底"真香"了，挑三个最实用的给你看看。

增量下载：只把"新作品"带回家

对于持续更新的博主，每次都全量下载既慢又浪费空间。开启增量模式后，工具会对照数据库和历史文件，只下载新出现的作品：

increase: post: true like: true database: true

我把关注的一个日更博主加了进来，之后每天跑一次命令，几十秒就把当天的新内容补齐了，体验接近"自动追更"。

直播回放录制：不错过任何一场精彩

这是我最喜欢的功能之一。把直播间地址放进link，再配上录制参数：

link: - https://live.douyin.com/123456789 live: max_duration_seconds: 3600 chunk_size: 65536 idle_timeout_seconds: 30

工具会实时录制并保存为 FLV 文件，支持清晰度选择，主播下播或网络中断时已录制的部分也会自动保留，不会前功尽弃。

下载完成通知：泡杯咖啡等推送

大批量下载时可以放心离开电脑，完成后工具会把结果推送到你的手机：

notifications: enabled: true on_success: true on_failure: true providers: - type: bark url: https://api.day.app/YOUR_DEVICE_KEY - type: webhook url: https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=xxx

支持 Bark、Telegram 和 Webhook，企业微信、飞书、钉钉机器人也能接，所有渠道并发推送，单个失败不影响下载流程。此外它还能按关键词搜索作品、拉取热搜榜，甚至以 REST API 服务模式运行，玩法非常多。当然，功能再多也难免踩坑，下面几个是我真实遇到过的。

避坑指南：这些坑我替你踩过了

为什么只能下载到 20 条作品？

这是抖音翻页风控的常见现象，不是工具坏了。解决办法是确保配置里browser_fallback.enabled: true且headless: false，下载过程中浏览器弹窗出现时，手动完成一下验证码，不要急着关窗口，程序会继续往下翻页。

Cookie 失效了怎么办？

不用慌，重新跑一遍自动获取命令就行：

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

下载速度慢怎么优化？

可以试试三个方向：把thread调大一点（比如 8）；在网络状况好的时段分批下载；或者配置proxy参数走代理。

想重新下载某个视频，但它总是被跳过？

因为工具用"数据库记录 + 本地文件"双重去重，想重下某个作品，删掉对应文件夹再清掉数据库里的记录即可：

sqlite3 dy_downloader.db "DELETE FROM aweme WHERE aweme_id = '目标作品ID';"

这些坑大多五分钟内能解决。绕过它们之后，这个工具就成了我日常内容管理里离不开的一环。

用了两周之后的真实感受

说句实话，没接触 douyin-downloader 之前，我保存抖音内容的方式是：一个个点开视频、长按、存到相册，遇到喜欢的作者就手动翻到底，偶尔还要忍受水印。碰到想收藏的直播，基本只能干瞪眼。

现在呢？发现好作者，丢个主页链接进config.yml，泡杯茶的功夫几十条作品就整整齐齐躺在文件夹里；晚上有重要的直播，挂上录制让它自己跑，第二天直接看回放；工具还顺带把封面、原声、元数据都保存好了，我甚至用它给收藏的内容做了个简单的本地索引。

这套工具其实还有个配套的桌面版客户端（目前内测中），粘贴链接、同步关注列表、可视化跟踪进度，不喜欢命令行的朋友可以直接用界面操作，后端逻辑和命令行版完全一致。

如果你也想要一个能长期打理自己抖音内容库的工具，我觉得 douyin-downloader 是当下很值得尝试的选择。

现在就开始你的第一次下载吧

回顾一下，真正动手只需要四步：

1. 克隆仓库并安装依赖：git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader，然后cd douyin-downloader && pip install -r requirements.txt
2. 复制配置：cp config.example.yml config.yml，填上想下载的链接
3. 自动获取登录态：python -m tools.cookie_fetcher --config config.yml
4. 运行下载：python run.py -c config.yml

详细的功能说明和参数表在项目内的config.example.yml和USAGE.md里都写得清清楚楚，遇到问题按图索骥即可。

最后也想提醒一句：请遵守平台规则，尊重创作者的版权，下载的内容尽量用于个人学习研究。工具本身是开源的，用得好不好，取决于我们如何使用它。让精彩不再错过，从今晚的第一条命令开始吧。

【免费下载链接】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