抖音批量下载工具 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，就是为这些场景准备的。它是一款开源的抖音下载工具，主打抖音批量下载与去水印，支持视频、图集、合集、音乐、直播回放等多种内容类型，还能把作者主页、点赞列表、收藏夹一键打包成结构清晰的本地资料库。一句话概括：别人还在逐条手动保存，你已经整站归档完毕，正在喝茶。

先算一笔账：手动下载和工具下载的差距有多大

在进入安装步骤之前，我们先做一道算术题。假设你需要收集某位博主的 100 条作品，手动操作和工具操作的区别，不是"快一点"和"慢一点"的区别，而是两个量级的区别。

差距的根源在于：手动下载把"找链接、等解析、存文件"这三件事反复做了一百遍，而工具只做一遍——剩下的交给自动化。它省下的不只是时间，更是你的耐心。

十五分钟跑通第一个任务

安装过程没有想象中复杂，按下面四步走，大多数机器上十五分钟内能看到第一批文件落地。

第一步：装好运行环境

项目基于 Python 3.8+，先安装依赖：

pip install -r requirements.txt

这行命令把项目所需的核心库一次性装齐。如果打算用浏览器兜底功能（后面会讲为什么值得开），再补装 Playwright 和 Chromium：

pip install playwright python -m playwright install chromium

第二步：搞定登录凭据（Cookie）

抖音接口需要登录态，这一步绕不开。项目提供了自动获取脚本：

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

运行后会弹出浏览器窗口，你登录一次抖音，回到终端按回车，Cookie 就自动写进配置文件了。之后程序会帮你维护和刷新它，不用每次手动复制粘贴。

第三步：写一份最小配置

复制示例配置，改几行即可：

cp config.example.yml config.yml

最小可运行配置长这样：

link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx # 换成目标博主主页 path: ./Downloaded/ # 下载保存目录 mode: - post # post = 下载博主发布的全部作品 number: post: 50 # 只下最近 50 条，0 表示全量 thread: 5 # 并发下载数 retry_times: 3 # 失败重试次数 database: true # 开启 SQLite 去重与历史记录

mode是核心字段，post表示作品列表，还有like（点赞）、mix（合集）、music（音乐）等模式，稍后细说。

第四步：运行并检查结果

python run.py -c config.yml

终端会出现 Rich 进度条，逐条显示下载状态。任务结束后，去./Downloaded/目录看看，你会看到按博主名分好的文件夹，里面是规范命名的视频文件。

这就是从零到一的全过程。没有魔法，每一步都能被理解：装环境解决"跑得起来"，Cookie 解决"进得去"，配置解决"下什么"，运行解决"开始干活"。

跟随一次批量下载任务，看懂工具的全套本领

光会跑通还不够，值得花两分钟搞清楚：一次批量下载的背后，工具替你扛住了哪些脏活累活。

链接识别：9 种入口，一次解析

把任意抖音链接丢给它——短视频、图文笔记、合集、音乐页、博主主页、直播房间，甚至v.douyin.com短链——它都能自动识别类型并路由到正确的下载流程。这意味着你不需要记住"哪种链接用哪种工具"，复制粘贴就完事了。

并发与重试：让下载不再是排队

thread: 5意味着同时有 5 个文件在下载，而不是一条条排队。遇到网络抖动，指数退避重试（1 秒、2 秒、5 秒递增）会自动顶上；下载完成后还会比对 Content-Length 校验完整性，文件不完整就自动清理重下，不会给你留一堆残缺的坏文件。

去重与增量：第二次运行会快得离谱

这是我最喜欢的设计。工具内置两层去重：SQLite 数据库记录 + 本地文件扫描。第一次下载过的视频，第二次运行直接跳过；配合增量开关，它可以做到"只下载新发布的视频"：

increase: post: true

对于需要长期追更博主内容的用户，这个特性等于把"每周手动检查更新"变成了"跑一下命令就行"。

归档：比视频本身更值钱的附加资源

每个作品下载后，目录里不只是 mp4：

Downloaded/作者名/post/2024-02-07_作品标题_aweme_id/ ├── 2024-02-07_作品标题_aweme_id.mp4 ├── ..._cover.jpg # 封面 ├── ..._music.mp3 # 原声 ├── ..._avatar.jpg # 作者头像 └── ..._data.json # 完整元数据

对做内容分析或资料库建设的人来说，这份 JSON 元数据（点赞数、评论数、发布时间、标签）是后续做统计分析的素材底座，价值不亚于视频本身。

各模式怎么选：一张表看清适用场景

所有模式之间还会自动去重：同一个作品在post和like里都出现时，只下载一次。

一个运营人的周末：从"想备份"到"建好素材库"

朋友小林是短视频运营，负责一个美食账号。她最常做的事，就是盯竞品博主的内容，拆解选题和拍摄手法。过去每个周五下午，她都要花三四个小时手动保存竞品视频，还经常因为水印、命名混乱、文件散落各处而抓狂。

后来她配置了一个近乎"一劳永逸"的方案：

link: - https://www.douyin.com/user/竞品博主A - https://www.douyin.com/user/竞品博主B - https://www.douyin.com/user/竞品博主C mode: - post - like number: post: 100 like: 50 thread: 8 retry_times: 5 increase: post: true like: true comments: enabled: true include_replies: false max_comments: 200

每周五下班前，她跑一条命令，顺便把评论也抓下来——评论区是选题灵感的富矿。半小时后，最新的竞品视频、点赞内容和用户反馈全部安静地躺在本地目录里，按博主、按日期排得整整齐齐。

结果就是：她的素材库从"每周手工重建"变成了"自动持续累积"。半年后，这份沉淀成了团队内部最完整的竞品内容档案，甚至被老板点名表扬。工具的价值，往往不是让你干得更快，而是让你愿意干、能干得久。

新手最常踩的五个坑

以下是社区里出现频率最高的几个问题，提前避开能省不少时间。

坑一：只能抓到 20 条作品

现象：明明博主有几百条视频，结果只下了 20 条就停了。

原因：这是抖音翻页风控的典型表现，API 在翻页到一定深度时会被拦截。

解法：开启浏览器兜底。在配置里确保：

browser_fallback: enabled: true headless: false

运行时会弹出浏览器窗口，如果出现验证码，手动完成验证，别急着关窗口，程序会接着把剩下的作品抓完。

坑二：想重新下载某个视频，它却一直"跳过"

现象：删了文件重跑，还是提示已存在，就是不重新下载。

原因：工具是"数据库记录 + 本地文件"双重去重，只删一边不够。

解法：两边都清掉。删掉对应文件目录，同时删除数据库记录：

sqlite3 dy_downloader.db "DELETE FROM aweme WHERE aweme_id = '要重下的ID';"

坑三：进度条疯狂刷屏，日志看不下去

现象：终端全是进度刷屏，想要的信息被淹没。

原因：默认开启了详细进度日志。

解法：配置里加一行progress.quiet_logs: true，让进度阶段静默；需要排查时再临时用-v参数打开详细日志。

坑四：Cookie 失效，任务全部失败

现象：某天开始所有下载都报错。

原因：Cookie 过期了，这在抖音平台上很常见。

解法：重跑一次自动获取命令即可：

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

坑五：收藏夹模式和其他模式混用报错

现象：collect和其他模式写在一起，运行时报错或行为异常。

原因：收藏夹模式（collect/collectmix）设计上必须单独使用，且只能配合当前登录的账号。

解法：把收藏夹任务拆成独立配置单独运行，别和post、like等混在一个任务里。

命令行之外：还有哪些进阶玩法

项目的能力边界远不止"下载视频"三个字，下面这几个玩法适合按需解锁。

直播录制：不错过任何一场直播

live.douyin.com/{房间号}链接可以直接录制直播流，主播下播后已录的数据会保留。录制配置支持时长上限、空闲超时等参数，适合直播回放存档场景：

link: - https://live.douyin.com/123456789 live: max_duration_seconds: 3600 # 0 = 录到主播下播 idle_timeout_seconds: 30

热搜与关键词搜索：把下载变成数据采集

想研究当下抖音在流行什么？一条命令导出热搜榜快照：

python run.py --hot-board 30 -p ./Downloaded

想按关键词采集作品？同样一条命令搞定：

python run.py --search "猫咪" --search-max 100 -p ./Downloaded

输出是 JSONL 格式的结构化数据，可以直接喂给数据分析流程，让"下载工具"跨界变成"数据采集工具"。

REST API：把下载能力嵌入自己的系统

项目可以以服务模式运行，提供标准的下载接口：

python run.py --serve --serve-port 8000

配合POST /api/v1/download提交链接、GET /api/v1/jobs/{id}查询状态，你可以把下载能力封装进自己的后台工具、自动化脚本，甚至团队协作平台。

通知推送：下载完自动告诉你

支持 Bark、Telegram、Webhook 三类通知渠道。批量任务跑完，手机上直接收到结果推送，不用盯着终端干等。对需要定时任务（比如每天凌晨定时更新）的用户来说，这几乎是必备配置。

桌面版 Douzy：给不想碰命令行的人

项目还基于同一套后端推出了桌面客户端（内测中），粘贴链接即可开始下载，支持同步关注列表、可视化任务中心、SQLite 作品档案管理。对不习惯终端操作的用户，这降低了门槛；对老用户，命令行和桌面版共用一套逻辑，迁移成本为零。

最后的行动指令

总结一下这个工具真正打动我的三件事：批量能力把"逐条手动"变成"一次搞定"，去重与增量让长期追更变得可持续，元数据与结构化输出让下载行为升级为内容资产积累。

安装、配置、运行，三个动作做完，你就能感受到那种"把重复劳动外包给代码"的畅快。

现在就可以开始：把项目克隆下来（git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader），按上面四步跑通第一个任务，然后挑一个你最想备份的博主试试。半小时后，你会回来谢我——不，你会回来谢谢那个坚持把配置写完的自己。

建议配图清单：

1. 在"十五分钟跑通第一个任务"小节末尾，放置img/DouYinCommand2.png，alt 文本建议为"抖音批量下载工具命令行下载进度"。
2. 在"归档"小节，放置img/DouYinCommanddownload.jpg，alt 文本建议为"抖音下载工具批量下载文件归档目录"。
3. 在"直播录制"小节，放置img/DouYinCommandlive.jpg，alt 文本建议为"抖音下载工具直播录制命令行界面"。
4. 在"桌面版 Douzy"小节，放置douyin-downloader/img/desktop/001.png（粘贴链接即刻开始）与douyin-downloader/img/desktop/003.png（任务中心），alt 文本分别建议为"抖音批量下载工具桌面客户端下载页"和"抖音下载工具桌面客户端任务中心"。

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