免费抖音批量下载工具，5分钟上手不踩坑

【免费下载链接】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 值得你花 5 分钟试试。它是一个免费开源的抖音批量下载工具：视频、图集、合集、原声音乐全都能抓，博主主页几十条作品可以一键整页拿下，默认去水印、自动挑最高清画质，下载过程还自带进度条、失败重试和数据库去重。下面我用最直白的话，带你从零把它跑起来。

第一章 先看货：它能吞下哪些类型的作品

动笔之前，先看清这个工具的"胃口"。它把抖音上的内容大致分成几类，每一类都有对应的链接解析方式：

更贴心的是，你在抖音里复制的短链接（v.douyin.com/...）它也能自动解析出真实地址，省去了手动拆链接的功夫。也就是说，你只管复制粘贴，剩下的解析、分类、下载它全包了。

第二章 5分钟起步：装好环境，喂它第一个链接

上手过程就三步：装环境、配 Cookie、跑命令。

第一步，把项目拉到本地并安装依赖：

# 克隆项目到本地 git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader # 安装 Python 依赖（需要 Python 3.8+） pip install -r requirements.txt

第二步，准备好配置文件和 Cookie。Cookie 是访问抖音接口的"通行证"，好在工具提供了自动获取脚本，按提示在浏览器登录一次抖音，回到终端按回车，Cookie 就自动写进配置文件了：

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

第三步，跑起来。最省事的用法是命令行直接追加链接，比如：

python run.py -c config.yml \ -u "https://www.douyin.com/video/7604129988555574538" \ -t 8 -p ./Downloaded

-t是并发线程数，-p是保存目录。从粘贴链接到看到文件落盘，全程不到 5 分钟。

第三章 三种下载姿势：单条、主页、收藏夹

跑通一次之后，你会发现下载方式其实就三种"姿势"，掌握它们就等于解锁了 90% 的使用场景。

姿势一：单条精准下载。上面那条命令就是，适合收藏某一条爆款视频，参数简洁，临时想下载时随手就能用。

姿势二：博主主页批量抓取。这是最常用的场景。把链接换成博主主页，再指定模式，就能一口气把 TA 的作品全部搬回家：

link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx mode: - post # 发布的全部作品 - like # 点赞过的视频 - mix # 参与过的合集 - music # 用过的原声 number: post: 50 # 0 表示不限制数量

四种模式可以同时开，工具会自动去重——同一个视频在"发布"和"点赞"里都出现时，只会下载一次，不会白白浪费流量。

姿势三：收藏夹同步。如果你习惯把喜欢的内容放进收藏，那这个功能是刚需。配置好登录账号后，把链接指向自己的收藏页，就能定期把收藏内容增量同步到本地：

link: - https://www.douyin.com/user/self?showTab=favorite_collection mode: - collect number: collect: 0

第四章 下载过程中的安心感：进度、重试与去重

批量下载最怕什么？跑了一半不知道卡在哪、断网了要全部重来、下完了发现和上次重复占空间。这些问题工具都提前想到了：

• 进度一目了然：终端里有实时进度条，每完成一个作品都有统计反馈，下载总数、成功数、耗时清清楚楚，全程心里有数。
• 失败自动重试：网络抖动时按 1 秒、2 秒、5 秒的指数退避自动重试，不用你盯着。
• 完整性校验：下载完成后比对文件大小，不完整的文件会被自动清理并重新下载，杜绝"下了一半的残废文件"。
• SQLite 双重去重：数据库记录 + 本地文件双重检查，重复内容自动跳过；开启增量模式后，每次只补下新增的作品，长期关注某位博主也不会把硬盘塞爆。

上图是实际运行的效果：左边是下载配置与进度，右边是最终的下载统计，成功数、耗时、保存路径一次看清。

第五章 进阶玩法：直播、评论与自动通知

如果你觉得"能批量下载"已经够用了，那接下来的功能算是锦上添花的惊喜。

直播录制。看到喜欢的直播却没法全程守着？工具支持录制抖音直播，指定直播间链接后自动开录，主播下播时已录制的数据也会完整保留下来：

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

录制得到的 FLV 文件存放在Downloaded/{作者}/live/目录下，还会附带一份直播间元数据快照，方便事后整理。

评论采集。想把某个作品的评论区完整留存？开启评论采集后，工具会把评论（含二级回复）导出成 JSON 文件，做内容分析或者舆情研究都很方便。

热搜与搜索。想追热点？一条命令就能导出热搜榜快照，或者按关键词搜索作品，结果以 JSONL 格式落盘，方便后续处理：

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

完成通知推送。下载是耗时任务，你没必要一直盯着终端。配置 Bark、Telegram 或 Webhook 之后，下载完成或失败都会推送消息到你手机，跑完回来验收成果就行。

REST API 模式。进阶玩家可以把它以服务模式运行（--serve --serve-port 8000），通过 HTTP 接口提交下载任务、查询任务状态，方便二次开发或嵌入到自己的工具链里。

第六章 避坑手册：遇到问题这样处理

用任何下载工具都会碰到几个"经典问题"，这里把高频坑提前给你排掉。

翻页被风控，只能抓到 20 条作品？这是抖音对翻页请求的常见限制。确保配置里打开了浏览器兜底功能，并让浏览器窗口保持可见；当弹出验证码时手动完成验证，之后就能继续往下抓了。

Cookie 过期了怎么办？长期使用后接口报错、抓不到数据，多半是 Cookie 失效。重新跑一遍python -m tools.cookie_fetcher --config config.yml刷新即可，不用重装任何东西。

想重新下载某个作品？工具靠"数据库记录 + 本地文件"双重判断是否跳过。想重新下载时，删掉对应的本地文件夹和数据库记录，再跑一次就会重新下载；只删一边都不会触发重新下载。

下载后文件太乱？工具默认按"作者 → 作品类型 → 发布日期_标题_ID"的层级自动归档，一个作品一个文件夹，视频、封面、原声、元数据各归其位：

结尾：现在就动手

从单条收藏到整页备份，从画质挑选到自动归档，douyin-downloader 把"存抖音"这件事打磨得足够顺手，而它完全免费、开源、无任何功能付费墙。你不需要懂代码，复制三条命令就能跑起来；想要更多，它也给了你直播、评论、热搜、API 这些可玩性十足的空间。

别让喜欢的内容只在别人的服务器上存在。现在就克隆项目、粘贴你收藏夹里的第一个链接，5 分钟后，这些视频就是你的了。

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