抖音批量下载工具实战指南：去水印保存视频、图文与直播回放

抖音批量下载工具实战指南：去水印保存视频、图文与直播回放

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

凌晨一点半，我刷到一位博主预告"这条直播回放只保留24小时"。点进去看完，心里只有一个念头：把它留下来。打开网页录屏工具，要么画质糊成一团，要么成品顶上压着晃眼的水印。翻遍收藏夹里的下载脚本，不是失效就是只支持单条视频。直到朋友推给我 douyin-downloader——一个开源抖音批量下载工具，能去水印、保住原画，还能把作者主页、合集、音乐乃至直播回放整批搬进本地硬盘。这篇文章就围绕它，讲清"为什么需要、怎么上手、能挖多深"。

一、为什么手动保存这条路，早晚走不通

先坦白一件事：几乎每个重度抖音用户，都经历过"想留留不住"的时刻。

• 录屏：手机录屏只能录当前播放画面，分辨率跟着设备走，切后台就断。
• 第三方网页工具：多数带水印，画质被二次压缩，还经常突然失效。
• 手动一个个保存：遇到几百条作品的作者主页，点鼠标点到手酸，下载完文件名还全是乱码。

douyin-downloader 把这条路彻底改写了：它直接解析视频源地址，自动挑选无水印、码率最高的版本；批量任务用 5 个线程并发下载（可调），失败自动重试 3 次；下载结果按"作者名/作品类型"自动归档。同样是保存一百个视频，手动要一晚上，它跑完可能只需要一首歌的时间。

二、十分钟跑通你的第一次下载

整个上手过程只有四步，不需要懂代码，跟着敲就行。

第一步：把项目拉下来

git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader

第二步：安装依赖

pip install -r requirements.txt

第三步：自动获取登录凭证

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

命令会自动弹出浏览器，登录一次抖音账号，回到终端按一下回车，Cookie 就自动写进配置了，不用再手动从浏览器开发者工具里翻。

第四步：运行

python run.py -c config.yml

就这么简单。首次运行时建议先复制一份最小配置：

link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx # 替换成目标博主主页 mode: - post number: post: 10 thread: 5 database: true

把link换成你想下载的视频链接或作者主页，number.post控制下载条数，跑一次就能看到效果。

三、核心能力拆解：它到底能替你省多少事

工具的价值不在功能清单有多长，而在于每个功能是不是真的解决了一个具体场景。

3.1 一条链接，五种内容形态通吃

多数下载工具只认视频链接，遇到图文就傻眼。douyin-downloader 对链接类型做了完整覆盖：

• 单个视频：/video/{id}
• 单篇图文：/note/{id}或/gallery/{id}
• 单个合集：/collection/{id}
• 单首音乐：/music/{id}（优先原声文件，缺失时回退到该音乐下首条作品）
• 短链也能自动解析：https://v.douyin.com/...这类分享口令直接粘贴即可

也就是说，你在抖音里看到什么内容，把链接丢进来，剩下的交给它。

3.2 作者主页批量下载：一次拿下全部作品

这是最有价值的一个场景。把博主主页链接放进link，然后通过mode声明要抓取的内容：

link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx mode: - post # 发布的作品 - like # 点过的赞 - mix # 合集 - music # 用过的原声 number: post: 0 # 0 表示全量

number设为 0 就是全量抓取，不设上限。多个模式之间还会自动去重——同一个作品既出现在"发布"又出现在"点赞"里，只会下载一次。下面的截图就是典型的批量下载过程，视频、音乐、封面逐项推进，进度一目了然。

3.3 直播回放：错过再久的直播也能留档

直播是很多人的刚需场景。工具支持把live.douyin.com/{房间号}直接作为下载源，录制 FLV 或 HLS 流，录制过程中随时中断都会保留已录制的数据，主播下播也会自动收尾，并生成包含直播间标题、在线人数等信息的元数据快照。

link: - https://live.douyin.com/123456789 live: max_duration_seconds: 3600 # 最长录 1 小时，0 表示录到主播下播

对自媒体从业者来说，这相当于一个免费的直播素材归档器；对普通用户而言，则是把"看过即忘"的直播变成可反复回看的本地资料。

3.4 增量下载 + 数据库去重：重复运行不制造垃圾

批量下载工具最容易踩的坑是"跑第二次又把所有东西下一遍"。这个工具的解法是数据库 + 本地文件双重去重：每条作品的aweme_id都会记入 SQLite，下次运行自动跳过已存在的文件。

increase: post: true database: true

开启增量模式后，它只抓取新增内容。很适合长期跟踪某个博主：每周跑一次，把本周的新作品收进本地库，不重复、不遗漏。

四、进阶玩法：把下载器变成内容管理中枢

当基础下载满足不了你时，它还有几招"隐藏技能"。

采集评论：给指定作品生成独立的_comments.json，支持二级回复，适合做用户反馈分析和舆情观察：

comments: enabled: true include_replies: false max_comments: 500

热搜榜与关键词搜索：不需要知道具体链接，也能批量发现内容：

python run.py --hot-board 30 # 抓取抖音热搜榜前 30 python run.py --search "猫咪" --search-max 100 # 关键词搜索

结果以 JSONL 格式落盘，方便后续二次处理。

完成通知推送：支持 Bark、Telegram、Webhook（企业微信/飞书/钉钉的机器人地址同样可用），长任务跑完手机立刻收到提醒。

REST API 服务模式：安装fastapi和uvicorn后，python run.py --serve --serve-port 8000就能把下载能力暴露成 HTTP 接口，提交{"url": "..."}即可创建任务，适合嵌入到自己的自动化流程里。

作品档案管理：桌面版（Douzy）把下载历史做成了可视化档案，可以按作者、标题关键词、发布时间筛选，管理几千条历史下载记录也不费劲。

五、避坑清单：这些坑我替你踩过了

坑一：只能抓到 20 条作品。这是抖音翻页风控的典型表现，不是工具坏了。检查配置里browser_fallback.enabled是否为true，并把headless设为false；浏览器弹出后手动完成验证，别急着关窗口，等它自己翻完页。

坑二：Cookie 失效导致接口报错。抖音的 Cookie 有有效期，失效后重跑一次python -m tools.cookie_fetcher --config config.yml即可，全程自动，不用手动改配置。

坑三：想重新下载某个作品却发现被跳过。这是双重去重机制在起作用——需要同时删掉本地文件目录和数据库里的记录：

sqlite3 dy_downloader.db "DELETE FROM aweme WHERE aweme_id = '<aweme_id>';"

坑四：进度条刷屏影响阅读。配置里默认开启了progress.quiet_logs: true，会静默大部分进度日志；排查问题时再临时加-v参数输出详细日志即可。

坑五：直播是 HLS 源时只有播放列表文件。FLV 录制结果可直接播放，HLS 源需要先用 ffmpeg 做一次后处理，属正常现象，别以为下载失败了。

六、写在最后

回看开头那个深夜场景：如今再遇到"只保留 24 小时"的直播回放，我只需要复制链接、敲一条命令，几分钟后本地硬盘就多了一份可永久回看的原画存档。从单条视频、图文、合集、音乐，到作者主页全量、直播录制、评论采集、热搜追踪，douyin-downloader 把"保存抖音内容"这件事从手工劳动变成了自动化流水线，配合增量下载和 SQLite 去重，长期维护一个私人内容资料库的成本几乎为零。

建议你从最小的任务开始：粘贴一条视频链接跑通流程，再尝试批量下载一个作者主页，最后按需打开直播录制或评论采集。工具给你效率，但边界要自己守住——请仅将下载内容用于个人学习与素材管理，尊重创作者版权，遵守平台规则。合理使用，才能让这份便利长久存在。

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