抖音批量下载工具实测：4小时素材整理，我用它压到25分钟

抖音批量下载工具实测：4小时素材整理，我用它压到25分钟

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

抖音批量下载向来是个体力活：挨个打开作品页、右键另存、手动改名、再按作者归档，攒够50个视频常常要耗掉大半个下午。直到我试用了 douyin-downloader 这个开源工具，流程才被彻底改写。这篇文章不打算罗列功能清单，而是分享我实测一周后的真实感受：它的效率提升到底靠什么支撑、安装配置要几步、哪些坑最容易踩，以及可以直接抄走的配置模板。

先给结论：它适合谁，能解决什么

一句话总结：如果你需要把抖音内容成规模地保存下来——无论是一个作者的几百条作品、某个合集的全部视频，还是直播回放——douyin-downloader 都是当前性价比很高的选择。

我按自己的使用体验给它打了分：

它不是那种"装完就吃灰"的工具。下面用数据说话。

一组可以拿去核对的数字

在解释它如何实现之前，先看我实测的一轮对比。同样是"保存50个视频并整理归档"，手动流程和工具流程的耗时差距如下：

效率提升超过 85% 的来源，不在"下载"这一个动作本身，而在三个隐藏能力：识别、落盘、抗风控。

拆开看：三个核心能力撑起整套体验

能力一：识别链接，不挑格式

平时收藏的抖音链接五花八门：/video/单条视频、/note/图文、/collection/合集、/music/原声、/user/主页，还有v.douyin.com这类短链。

douyin-downloader 把这些入口全部统一了。你把任意一种链接丢进配置或命令行，它先自动解析出作品 ID 和类型，再走对应的下载流程。这意味着你不用记忆任何格式规则，也不用先手动"解短链"。更实用的是，用户主页可以一次性声明要下载的内容范围：发布作品（post）、喜欢的作品（like）、合集（mix）、音乐（music），一次配置批量执行。

能力二：下载落盘，命名与去重一次搞定

下载本身不难，难的是"下完之后不乱"。

它的文件落盘逻辑值得单独表扬：支持filename_template命名模板，可用变量包括{id}、{title}、{author}、{date}、{year}、{month}等；作者目录层还有三种策略可选——纯昵称（直观但重名会合并）、sec_uid（稳定唯一但不直观）、昵称加 sec_uid（兼顾两者，重度用户推荐）。

配合database: true开启 SQLite 记录后，每次下载前都会比对历史，已存在的作品直接跳过。这解决了我过去最头疼的"重复下载"问题——尤其是反复关注、取消关注的作者，历史记录都在，不会白下。

能力三：扛住风控，下载不中断

下载工具最常见的翻车场景，是请求太快被平台限制。它的应对是三层组合拳：

• 指数退避重试：失败后按 1 秒、2 秒、5 秒的间隔重试，不盲目撞墙；
• 限速保护：默认每秒约 2 个请求，配合thread并发参数（建议 3–5），在速度和风险之间找平衡；
• 浏览器兜底：当 API 翻页受限时，自动拉起浏览器走页面验证，人工过一下验证码即可继续。

另外还有一层完整性校验：下载完成后比对 Content-Length，文件不完整会自动清理并重新拉取，避免"下完才发现文件损坏"的尴尬。

10分钟上手：从安装到跑通第一个任务

第一步：拉取代码并安装依赖

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

网络环境受限时，可以给 pip 加上清华镜像源加速：

pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple

如果后续想用浏览器兜底功能，再补装 Playwright 的 Chromium：

pip install playwright python -m playwright install chromium

第二步：配置 Cookie（唯一必须手动参与的环节）

抖音的内容访问依赖登录态，这一步绕不开。推荐用自动获取方式，它会打开浏览器引导你登录：

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

登录完成后回到终端按 Enter，程序会自动把 Cookie 写回配置文件，不用手动复制粘贴那一长串msToken、ttwid。

第三步：写一份最小配置

cp config.example.yml my_config.yml

我的第一份配置只改了链接和保存路径：

link: - https://www.douyin.com/user/你的目标用户主页 path: ./我的抖音素材/ music: true cover: true json: true thread: 5

music、cover、json分别控制是否附带原声、封面图和 JSON 元数据；thread: 5是并发数，第一次跑建议先保持默认。

第四步：启动下载

python run.py -c my_config.yml

命令行里会看到 Rich 进度条，每个作品的下载状态、已处理数量都实时刷新。跑完第一轮，你就知道这套流程到底有多省事。

三个高频场景的配置模板

只下载新作品：增量下载与去重技巧

作者更新频繁时，每次都全量下载是浪费。开启增量模式后，工具只处理数据库里没有的新作品：

database: true database_path: dy_downloader.db increase: post: true # 只下载新发布的 like: true # 只下载新喜欢的 mix: true # 只下载新合集内容 music: true # 只下载新音乐

配合start_time/end_time时间过滤，还能进一步限定只拿某个时间段内的内容。对做素材库的创作者来说，这两个参数组合起来就是"自动补货"。

直播录制方法：主播下播后自动保存

需要记录直播内容时，直接用命令行参数指定直播间：

python run.py -l "https://live.douyin.com/直播间ID" -p ./直播录制/

FLV 源录完可直接播放；如果主播用的是 HLS 源，工具会保存 playlist 文件，需要再用 ffmpeg 做后处理。主播下播时录制会自动收尾，已录内容不会丢。

评论采集：给创作选题攒素材

选题阶段最缺的是"真实用户在想什么"。在配置里打开评论采集，每个作品会额外生成一份*_comments.json，可选抓取二级回复：

comments: enabled: true include_replies: true max_comments: 0 # 0 表示不限量

这份数据配合 JSON 元数据里的互动指标（点赞、评论、分享、收藏），足够支撑一轮像样的内容分析。

你可能踩过的坑：5 条避坑经验

这些坑我都实际遇到过，提前知道能省不少时间：

1. 翻页只出 20 条就停了？这是平台的翻页风控。在配置里开启browser_fallback.enabled: true并把headless设为false，让浏览器弹出人工过验证，验证通过后即可继续翻页。
2. 下载速度慢得离谱？先看thread是否设得过大或过小，3–5 是甜点区间；再确认限速参数没有把请求压得太死；网络环境特殊时还可以配置proxy。
3. Cookie 过期后任务全失败？Cookie 有效期一般 7–30 天，过期后重跑一次python -m tools.cookie_fetcher --config config.yml即可，不用手改配置。
4. 文件名互相覆盖？命名模板里必须包含{id}，这是唯一性保证。{date}_{title}_{id}是最稳妥的组合。
5. 收藏夹下载不生效？collect/collectmix模式只能单独使用，不能和post/like混在一起声明，且只支持当前登录账号。

什么时候不建议用它

诚实地说，它也有边界：

• 浏览器兜底目前只对post（发布作品）做了完整验证，like/mix/music主要依赖 API 正常分页，极端风控下可能受限；
• 直播的 webcast 接口没有覆盖所有场景，官方将其标注为实验性功能；
• 它擅长的是"批量、稳定、有序"，如果你的需求只是偶尔存一两个视频，杀鸡用牛刀了。

另外提醒一句：请遵守平台服务条款与相关法规，把它用在个人学习、素材研究和内容创作上，不要用于商业侵权。

写在最后

回到开头那个问题：为什么同样 50 个视频，有人花 4 小时，有人 25 分钟搞定？差距不在手速，而在流程设计——自动识别链接、并发下载、命名归档、数据库去重，每一环都在替你把机械劳动抹平。🚀

工具的价值在于把时间还给你，让你把精力放在真正重要的事情上。如果你也被"保存素材"这件事折磨过，不妨从一份最小配置开始，跑通第一个任务。剩下的，交给它就好。🎯

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