别再一个个保存了！douyin-downloader 抖音视频批量下载实战手记

别再一个个保存了！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 就是为这类需求而生的抖音批量下载工具：去水印，支持视频、图集、合集、音乐，还能整页归档作者主页。

我把它从安装到玩出花，完整走了一遍。下面这份手记按「新手入门 → 进阶提速 → 高阶玩法 → 避坑指南」四个梯度展开，你跟着做，今晚就能把第一个视频顺利搬回家。

第一级 新手村：十分钟跑通第一次下载

第一步：装好运行环境

工具基于 Python 开发，支持 macOS、Linux、Windows。先克隆项目并安装依赖：

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

如果你打算用「浏览器兜底」和「自动获取 Cookie」这两个能力，再补一步：

pip install playwright python -m playwright install chromium

第二步：拿到你的抖音 Cookie

抖音的接口需要登录态，Cookie 是关键。手动从浏览器开发者工具里复制也行，但更省事的做法是让程序帮你自动抓取：

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

命令运行后会弹出浏览器，你正常扫码登录抖音，回到终端按一下回车，Cookie 就自动写进配置文件了，全程不用碰代码。

第三步：写一份最小配置

新建config.yml，先下载单个视频试试水：

link: - https://www.douyin.com/video/7604129988555574538 path: ./Downloaded/ # 文件保存目录 thread: 5 # 并发下载数 retry_times: 3 # 失败重试次数 database: true # 开启 SQLite 去重记录

第四步：跑起来

python run.py -c config.yml

看到进度条跳动的那一刻，你就已经入门了。下载目录里除了无水印视频，还会自动带上封面、原声音乐、作者头像和一份完整的 JSON 元数据，每条作品一个独立文件夹，井井有条。

第二级 提速器：从单条搬运到整页归档

单个视频只是热身。真正拉开差距的，是作者主页的批量下载——这也是它最核心的用法。

把link换成用户主页链接，再通过mode指定要抓什么：

link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx mode: - post # 主页作品 - like # 点赞过的内容 - mix # 创建的合集 - music # 用过的原声 number: post: 0 # 0 表示全量抓取，不设上限 like: 50 # 也可以指定条数

几个实用的组合拳：

• 增量下载：开启increase.post: true，配合数据库记录，下次运行只抓新增作品，追更博主就像追番一样轻松。
• 时间过滤：设置start_time: "2026-01-01"，只保留今年发布的内容，研究某个时间段的传播规律时尤其好用。
• 跨模式去重：同一个视频在post和like里都出现？不会重复下载，程序会自动识别。

下载几百条视频时，并发数、重试次数和进度显示就派上用场了——中途断网、单条失败都会自动重试，不完整的文件会被清理掉重新下，不需要你守在旁边盯着。

第三级 高阶玩法：下载之外的那些事

用熟了批量下载之后，下面这些能力值得逐个解锁。

你的内容不只视频

每一条作品都会沉淀为一整套数字资产：视频（优先无水印高清源）、封面图、原声文件、作者头像、JSON 元数据，甚至评论。研究竞品、做二创素材、存档内容，都能直接取用。

文件名也能完全自定义：

filename_template: "{date}_{author}_{title}_{id}" # 可用变量：date、author、title、id、like_count 等

热搜榜与关键词搜索

想追热点或做选题？两条命令直接导出数据：

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

结果以 JSONL 格式落盘，方便后续做分析。

直播录制

遇到值得留档的直播，链接放进配置即可录制，支持 FLV/HLS，主播下播后已录的数据会自动保留：

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

给视频配文字稿

开启transcript功能后，下载完的视频会自动调用转写接口生成 txt 和 json 文字稿，做视频库检索、内容复盘都很省力。此外还有 REST API 服务模式（--serve）和完成通知推送（Bark / Telegram / Webhook），方便你把下载能力嵌进自己的系统里。

第四级 避坑手册：遇到问题这样办

只抓到 20 条就停了？

这是抖音翻页风控的常见现象。解决方案是开启浏览器兜底：

browser_fallback: enabled: true headless: false # 非无头模式

弹窗出现后手动完成验证，别急着关窗口，程序会继续翻页抓取。

Cookie 失效了？

下载报错、抓取为空时，多半是 Cookie 过期了。重新跑一遍python -m tools.cookie_fetcher --config config.yml即可，程序会自动检测并提示。

下载速度上不去？

先别急着怀疑网络。检查thread是否设得过高反而触发限速，一般 5-10 为宜；如果遇到 IP 限制，可以配置proxy走代理。

想重新下载某条作品？

程序靠「数据库记录 + 本地文件」双重检查判断是否跳过。想重下，得同时清理：删掉对应文件夹，再用 sqlite3 删掉数据库里的那条aweme记录，否则它会以为你已经下过了。

写在最后：把工具用成习惯

从单条链接到整页归档，从手动另存为到全自动增量更新，douyin-downloader 解决的其实是一个很朴素的问题——把时间还给内容本身。我现在的习惯是：刷到喜欢的博主，先跑一次全量，之后每周用增量模式追更，素材库一直在稳定增长，却几乎不再花时间。

下一步你可以这样开始：

1. 克隆项目，跑通第一条下载；
2. 换成作者主页链接，体验一次批量归档；
3. 按需打开评论采集、直播录制或转写功能；
4. 遇到问题对照本文第四级排查。

最后提醒一句：工具本身没有立场，用的人才有。请务必在法律法规和平台规则允许的范围内使用，尊重创作者版权，把它用于个人收藏、内容研究等正当用途。祝你的素材库，越攒越顺手。

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