告别逐条另存为:douyin-downloader 抖音批量下载,3 步搬空博主主页
2026/8/20 7:59:18 网站建设 项目流程

告别逐条另存为:douyin-downloader 抖音批量下载,3 步搬空博主主页

【免费下载链接】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 就是为解决这个麻烦而生的抖音批量下载工具——去水印、自动挑最高清,一条链接就能把视频、图集、合集、音乐统统搬到本地。这篇文章不堆概念,只讲一件事:你今晚就能用它把自己的收藏夹搬进硬盘。

收藏夹里躺着几百条视频,你还在手动逐个保存吗

先做个自我诊断:你有没有在评论区求过"求原视频"?有没有为了存一个教程,录屏再裁剪?有没有面对博主主页的上百条作品,打算一条条点开、另存、重命名?

这些动作的共同点是:一次只能处理一条,把时间全花在了重复劳动上。手动下载一条视频要 1 分钟,一百条就是 100 分钟;而用工具批量跑,一百条通常几分钟内完成,差距接近一个数量级。工具能做的还不只是"下载"——它把解析、去水印、挑清晰度、去重、归档这一整条流水线都替你接管了,你只需要把链接交给它。

一条链接能搬什么:先看清它支持的全部内容类型

动手之前,值得花 30 秒搞明白它的能力边界,因为"什么都能下"和"知道具体怎么下"是两回事。

内容类型链接长这样说明
单个视频/video/{id}最常见的单条作品
图文/note/{id}/gallery/{id}图片+文字,图集整体保存
合集/collection/{id}/mix/{id}一键把整个合集排队下完
音乐/music/{id}优先取原声文件
博主主页/user/{sec_uid}配合post / like / mix / music四种模式批量下载
收藏夹/user/self?showTab=favorite_collection下载你自己账号收藏过的作品和合集
直播live.douyin.com/{room_id}实验性直播录制,FLV/HLS
短链https://v.douyin.com/...自动解析,复制分享文案里的链接就能用

值得多说一句:v.douyin.com这类短链会被自动解析成完整地址,所以你在抖音里点"复制链接"得到的分享短链,直接丢进去就行,不用手动还原。

3 分钟跑通第一条下载:环境、Cookie、命令三步走

第一步是装依赖并准备好 Cookie。首次使用只需要跑这几条命令,程序会打开浏览器让你登录一次抖音,回车后自动把凭据写进配置文件:

git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader/douyin-downloader pip install -r requirements.txt python -m tools.cookie_fetcher --config config.yml

第二步,复制一份配置文件并按需修改:

cp config.example.yml config.yml

第三步,运行你的第一条下载命令。拿单个视频举例,追加参数会覆盖配置里的默认值,非常直观:

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

命令行会立刻给出反馈:当前进度、成功数量、保存路径,全程实时可见。⚡

跑通第一条命令后,你能在终端里实时看到进度条、成功数量与保存路径。

进阶用法:合集、音乐、直播、评论、热搜一次讲清

如果你要搬的不是单条视频,而是整个博主主页,把链接换成主页地址,再在配置里声明模式即可。下面这份配置的意思是:下载这位博主发布过的全部作品和全部点赞作品,number: 0代表不限量:

link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx mode: - post - like number: post: 0 like: 0

合集场景更省心——把合集链接填进去,它会自动拉取合集下所有作品逐条排队下载,不需要你手动翻页。💡

合集模式下每条作品排队下载,全部 100% 后统一归档,中途断网也会自动重试。

除了下载,还有几个"附赠"能力值得留意:

  • 直播录制:传入直播间地址即可开始录制,主播下播时已录制的字节会被保留,不会白录。
  • 评论采集:开启后每个作品旁边会多出一份*_comments.json,适合做舆情和选题分析。
  • 热搜与搜索--hot-board拉取热搜榜,--search "关键词"按关键词搜作品,结果都导出为 JSONL,方便二次处理。
  • 完成通知:下载完可以推送到 Bark、Telegram 或企业微信/飞书/钉钉机器人,挂机下载也不怕错过。
  • REST API 服务--serve --serve-port 8000把下载器变成服务,前端或其他程序可以直接提交任务。

直播录制会先展示直播间信息与可选清晰度,再把流保存到本地,适合记录重要直播。

下载稳不稳:去水印、自动挑最高清、去重这些细节有多硬核

批量下载最怕两件事:下到带水印的低清版,以及重复下载浪费时间。这两件事,它都替你处理了。🛡️

  • 无水印优先:会自动选择无水印的视频源,不用你事后二次加工。
  • 最高清自动挑选:基于video.bit_rate数组自动挑选最高码率,视频和实况图都生效。
  • 双重去重:SQLite 数据库 + 本地文件双重校验,同一个作品在 post、like、mix、music 不同模式下也不会重复下载。
  • 断点重试:失败自动指数退避重试(1s、2s、5s),并发数默认 5、速率限制默认每秒 2 个请求,避免被风控。
  • 完整性校验:下载后比对 Content-Length,文件不完整会自动清理并重新下载,杜绝"下完了却打不开"。
  • 浏览器兜底:当 API 翻页受限时,会自动拉起浏览器模拟滚动,还可以人工过验证码,提高大批量下载的完成率。

下载后的归档方式也很有章法:每个作品独立成一个以"日期_标题"命名的文件夹,视频、封面、音乐、元数据各归其位,找素材时一眼就能定位。

清晰的命名与目录结构,让几百个作品的素材库不至于变成"下载一时爽,找素材火葬场"。

最容易踩的 4 个坑,以及对应的解决办法

工具再顺手,也有几个新手必踩的坑,提前告诉你,能省下半小时排查时间。⚠️

  1. Cookie 失效导致下载失败:抖音的 Cookie 有时效,报错后别急着怀疑工具坏了,重新跑一遍python -m tools.cookie_fetcher --config config.yml即可。
  2. 收藏夹模式不能和其他模式混用collect/collectmix只能单独使用,不能和post/like等写在同一份 mode 里,否则会报错。
  3. HLS 直播源只保存 playlist:如果直播间只提供 HLS 源,程序只保存播放列表文件,需要配合 ffmpeg 做后处理;FLV 源则可以直接播放。
  4. 浏览器兜底不是开箱即用:想用浏览器兜底功能,需要额外执行pip install playwrightpython -m playwright install chromium,首次运行会弹出浏览器窗口,属正常现象。

现在就去复制一条链接,今晚把素材库建起来

回到开头那个问题:你收藏夹里那些"再也没打开"的视频,其实都是潜在的素材、选题和灵感。与其继续让它们躺在收藏夹里吃灰,不如花 3 分钟装上 douyin-downloader,把第一条链接丢进去试试——当进度条第一次跑满、文件夹里出现带标题的清晰视频时,你会理解为什么说"抖音批量下载"这六个字本身就是生产力。🚀

如果你不想碰命令行,项目还有一款基于同一套后端的桌面版客户端 Douzy,粘贴链接即可开始下载,同步关注列表、可视化跟踪进度,适合把工具交给不太懂命令行的同事或家人。

桌面版与命令行共用同一套下载后端,不熟悉终端的用户也能轻松上手。

今晚的行动清单很简单:克隆仓库 → 配好 Cookie → 粘贴一条你最喜欢的视频链接 → 跑起来。三分钟后你会发现,原来批量保存抖音内容可以这么省心。

进阶读者可以继续阅读仓库内的 README.zh-CN.md 和 USAGE.md,或直接翻看 cli/main.py 的命令行实现,把更多参数玩出花样。

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

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询