完全免费的抖音下载工具实战：三步跑通 douyin-downloader，再解锁几个省时间的玩法

2026/8/14 10:36:05

完全免费的抖音下载工具实战：三步跑通 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 的实战记录，是写给所有"收藏了等于没收藏"的朋友的。动笔之前我翻了翻自己的抖音收藏夹：三百多个"以后再看"的视频，真正回看过的不到十个——剩下的不是显示"已删除"，就是糊着马赛克和去不掉的水印。如果你也有同款经历，往下读，我带你一步步把它跑通，再顺路解锁几个能帮你省下大把时间的进阶玩法。

先说说我自己的收藏夹惨案

去年我想把一个讲摄影构图的教学视频存到本地慢慢学，试了一圈：录屏，画质缩水还带水印；截图，动态画面根本截不全；找在线解析网站，折腾半小时下载下来的却是个 480p 压缩包。最后我只能眼睁睁看着它躺在收藏夹里，等它某天被作者删掉。

后来朋友甩给我一个开源项目，我才发现：保存抖音内容这件事，本来可以像复制粘贴一样简单。

它到底是个什么工具？一句话讲清楚

douyin-downloader 是一个完全免费的开源抖音下载工具。把链接丢给它，它就能把无水印的原始文件下载到本地——不管是单个视频、图文、合集，还是音乐原声，甚至连整个作者主页和直播间都能处理。

和同类工具比，最打动我的其实是三点：

它默认就是"最高清"：不用你手动选画质，工具会自动从抖音返回的码率列表里挑出最好的源，视频和实况图都适用。
它有"记性"：每次下载都会写入 SQLite 数据库，同时对照本地文件做双重去重。下过的自动跳过，还能开"增量模式"只下载新作品。
它抗折腾：翻页被风控时自动拉起浏览器让你手动验证；Cookie 失效了会引导你重新登录，而不是甩给你一串看不懂的报错。

第一次使用：三条命令看到第一个无水印视频

新手最大的门槛往往不是功能，而是"不知道从哪里开始"。别担心，从零到第一次成功下载，只需要三步。

第一步，把项目拿下来。找一个干净的目录，执行：

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

这里要求本机有 Python 3.8 以上的环境，其他依赖都会由 requirements.txt 自动装好。之后如果想用"浏览器兜底"和"自动获取 Cookie"这两个能力，再补一条pip install playwright && python -m playwright install chromium即可。

第二步，给工具一张"门票"：配置 Cookie。抖音的大部分内容需要登录态才能访问，所以首次使用得先让它拿到你的登录凭证。最省心的方式是让工具自己打开浏览器扫码：

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

运行后浏览器会自动弹出，你用手机抖音扫码登录，回到终端按一下回车，Cookie 就自动写进 config.yml 了。不想装 Playwright 的话，也可以把浏览器开发者工具里复制出来的整串 Cookie 粘贴进配置文件，两种方式任选。

第三步，放进链接，跑起来。打开 config.yml，在 link 里先放一条你最想保存的视频短链（比如点分享按钮复制出来的那种 v.douyin.com 链接）：

link: - https://v.douyin.com/xxxxx/

保存后执行python run.py -c config.yml，等进度条走完，去Downloaded/目录看看——你的第一个无水印视频已经躺在那里了。

上图：命令行版下载完成的输出，显示成功数量、用时和保存路径。

默认情况下，文件会被自动整理成"作者名 → 作品类型 → 日期_标题_ID"的文件夹结构，视频、封面、背景音乐、元数据 JSON 分开放，找起来一目了然。文件名里的日期用的是作品本身的发布时间，而不是下载时间，回看时按时间线梳理非常顺手。

上图：下载后的本地目录结构，按日期和标题自动分类存放。

跑通之后，这几个隐藏玩法能帮你省下大把时间

第一次下载成功只是开始。下面这几个能力藏在配置里，很多人用了很久都没发现，但它们才是真正"省时间"的地方。

追更神器：增量下载。假设你关注了一位每天更新好几期的创作者，以前你得天天手动翻主页，还要记住看到第几个。现在只要在配置里打开：

increase: post: true database: true

工具会对照数据库记录，只下载"上次之后新增"的作品。每天跑一次命令，几十秒就完成，既不会漏更，也不用重复下载老视频。这套逻辑同样适用于点赞列表、合集的追更。

数据采集三件套：热搜榜、关键词搜索、评论采集。想做选题参考或内容分析？两条命令就够：

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

热搜榜会导出当天前 30 条热词，搜索结果以 JSONL 格式落盘，方便后续用脚本处理。想看某个视频的评论区，在配置里打开comments.enabled，每个视频旁会生成一份_comments.json，连二级回复都能带上。

直播也能录。把直播间链接丢进 link，工具就会开始录制；主播下播、网络空闲或手动中断时，已经录到的内容都会保留下来，同时生成一份_room.json快照直播间元数据。录完的 FLV 文件可以直接播放。

上图：直播录制时选择清晰度的界面。

下载完自动通知你。长任务跑完不用一直盯着终端，配置里可以接入 Bark、Telegram 或 Webhook，下载成功或失败都会主动推送到你的手机，特别适合夜里挂机批量下载。下载过程的并发数、重试次数也都能调，默认 5 个线程、失败按 1 秒/2 秒/5 秒指数退避重试，省心。

两种真实用法：个人收藏本地化和创作者素材库

光讲功能容易记不住，我说两个身边真实发生过的用法。

用法一：把"喜欢"全部搬回本地。有个朋友手机里存了上千个"点赞过"的视频，换手机时缓存全没了。他做了一次性搬家：把链接换成自己的收藏页地址https://www.douyin.com/user/self?showTab=favorite_collection，mode 设为 collect，一次跑完，所有收藏过的作品全部落盘。注意收藏夹模式需要单独使用，不能和 post、like 等模式混在一组配置里。

用法二：建一个分类素材库。如果你做短视频，需要持续收集某个领域的素材，可以同时下载作者主页的作品、合集和音乐原声，再用start_time/end_time限定时间段，只收集特定时期的作品。配合前面的增量下载，你的素材库会跟着创作者同步更新，却几乎不用重复劳动。批量下载时，工具会实时显示进度和任务状态，下到一半断网了也不怕，重跑会自动跳过已完成的文件。

上图：桌面版界面，左侧功能导航，右侧粘贴链接即可开始下载。

不习惯命令行操作的朋友，还可以试试项目同源的桌面版客户端（内测中），粘贴链接、看进度、同步关注列表都是图形化操作，门槛更低。

上图：批量下载时的进度输出，逐条显示任务状态。

踩坑实录：这些问题我提前帮你趟平了

用这个工具小半年，我把最常见的几个坑整理成经验谈，你遇到时可以直接对照。

"想重下却总是被跳过"，和"明明下过却又下一遍"，其实是同一个坑。这个工具靠"数据库记录 + 本地文件"双重判断是否已下载。想重新下载某个作品，必须同时删掉本地对应文件夹和数据库里的记录（例如sqlite3 dy_downloader.db "DELETE FROM aweme WHERE aweme_id='xxx';"），只删一边都会和你的预期相反。
"只能抓到 20 条作品"不是 bug，是翻页风控。把配置里的browser_fallback.enabled打开，工具会自动启动浏览器滚动翻页；弹窗出现后手动完成一次验证就行，不要立刻关掉窗口。
Cookie 失效后，搜索可能静默返回 0 条。如果怀疑登录态过期，直接重跑python -m tools.cookie_fetcher --config config.yml。新版本还内置了自动重登机制：检测到抖音返回"请先登录"时，会引导你重新登录并自动重试一次原命令，省掉不少手动排查。
直播录制如果源是 HLS 协议，只会保存 playlist 文件，需要再用 ffmpeg 转成可播放的视频；FLV 源则可以直接播放，选源时注意区分。
并发数不是越大越好。默认 5 个线程、每秒限速 2 个请求，是经过平衡的保守值。盲目调高线程数反而更容易触发风控，得不偿失。