📌 项目地址:jiji262/douyin-downloader | ⭐ 11,302 颗星 | 🔧 Python | 📜 未标注

问题很简单

抖音客户端没有导出按钮。收藏夹里的视频,作者一删就找不回来;创作者自己想备份几年攒下的作品,也没有官方途径。

jiji262/douyin-downloader 就是干这个的。Python 写的,11302 个 Star,有中文文档(README.zh-CN.md)。

先说一个坏消息

README 顶部的警告写得明明白白:抖音的风控在 2026 年 8 月封了 CLI 下载点赞、收藏、收藏夹的路径,9 月又封了单视频、图集、合集、音乐的接口,主页作品现在只能靠浏览器回退方式。

所以这个项目的现状是:CLI 能用的范围在收缩,作者把希望押在了桌面版上。用之前先去 issue 区看看当前状态,别按半年前的教程预期。

CLI 支持的链接类型

按 URL 模式列:

  • 单条视频:/video/{aweme_id}
  • 图集:/note/{note_id} 和 /gallery/{note_id}
  • 合集:/collection/{mix_id} 和 /mix/{mix_id}
  • 音乐:/music/{music_id},优先取直接音频,取不到时回退到首个相关作品
  • 短链:v.douyin.com、v.iesdouyin.com,甚至裸域名都能解析
  • 主页批量:/user/{sec_uid},mode 支持 post、like、mix、music 四种
  • 登录后的收藏夹:/user/self?showTab=favorite_collection,mode 支持 collect 和 collectmix

批量下载的核心就是主页链接加 mode 的组合。具体安装步骤和参数说明在中文文档里,不搬运。

工程细节

这类工具的分化点不在功能列表,在于下得对不对。项目描述里明确提到的处理:

无水印优先。 自动选无水印源,省掉下载后二次去水印。

SQLite 去重。 批量任务里已下载的内容不会重复拉取。跑一个几千条视频的主页,中断后重跑,这一项能省大量流量。

重试 + 完整性校验。 失败自动重试,下载完校验文件完整性,半截文件进不了归档。

浏览器回退。 接口方式失败时自动切到浏览器方式继续。前面说的主页下载现在就靠这条路活着。

桌面版 Douzy

同一个后端之上做了个桌面应用,覆盖三个平台:

  • 抖音:视频、图集、主页、合集下载;同步关注列表、收藏夹、收藏的合集、点赞内容
  • TikTok:公共视频、图文、主页,不用登录
  • YouTube:视频、Shorts、频道、播放列表,可以只下视频、MP3 或字幕

操作方式是贴链接、加队列,任务中心能看状态、重试失败项、打开输出目录,本地有下载归档和筛选。

目前是封闭测试,构建从 Releases 页面拿。考虑到 CLI 被风控卡得越来越紧,桌面版大概率是这个项目接下来的主线。

用之前想清楚的两件事

账号安全。 下载收藏夹和点赞需要自己账号的登录态,把它交给第三方工具,值不值自己判断。

接口风险。 项目依赖抖音的非公开接口,接口一变功能就临时失效。这个问题无解,只能接受。

备份自己的内容没问题,下载别人的作品再传播,边界自己把握。

这篇文章对你有帮助吗?

发表回复