📌 项目地址: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 被风控卡得越来越紧,桌面版大概率是这个项目接下来的主线。
用之前想清楚的两件事
账号安全。 下载收藏夹和点赞需要自己账号的登录态,把它交给第三方工具,值不值自己判断。
接口风险。 项目依赖抖音的非公开接口,接口一变功能就临时失效。这个问题无解,只能接受。
备份自己的内容没问题,下载别人的作品再传播,边界自己把握。