抖音批量下载 5 分钟上手:用免费开源工具跑通视频、合集与音乐的去水印保存
【免费下载链接】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 是一款免费开源的抖音批量下载工具。粘贴一个主页链接,就能把这位创作者发布的作品、点赞、合集、音乐一次性批量保存下来,默认带进度展示、失败重试和自动去重。适合内容创作者、运营,以及任何想把抖音内容归档到本地的用户。
能力速览:它能帮你做什么
先别背功能。对照你的需求看这张表就够了:
| 你的场景 | 它能做什么 |
|---|---|
| 单个视频 / 图文 / 合集 / 音乐链接 | 无水印下载,自动挑最高码率 |
| 保存整个创作者主页 | post作品、like点赞、mix合集、music音乐,可组合 |
| 保存当前账号收藏夹 | collect/collectmix,需单独使用 |
| v.douyin.com 短链 | 自动解析,不用手填长链接 |
| 录制直播 | FLV/HLS,主播下播时保留已录数据 |
| 抓评论区 | 输出*_comments.json,二级回复可选 |
| 热搜 / 关键词搜索 | 导出 JSONL,方便二次加工 |
下载过程都支持 SQLite 去重、增量抓取、并发与失败重试;完成后还能通过 Bark、Telegram 或 Webhook 推送通知。
桌面端也单独留了收藏与喜欢面板,一键同步当前账号的收藏合集和喜欢列表,支持批量下载。
🚀 最快上手:三步开始下载
整个过程不超过 5 分钟。
第一步,拿到代码并装依赖
git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt想用浏览器兜底的话,再补一步装 Chromium:
pip install playwright python -m playwright install chromium第二步,取 Cookie
python -m tools.cookie_fetcher --config config.yml会弹出浏览器。登录抖音后回到终端按 Enter,Cookie 就自动写进配置了。当然也可以手动改config.yml。
第三步,写配置并运行
复制示例配置,只动三处:
cp config.example.yml config.ymllink: - "https://www.douyin.com/user/目标用户ID" path: "./Downloaded/" mode: - post然后:
python run.py -c config.yml作品开始一条条存进Downloaded/。
🔍 亮点深挖:它和其他下载工具差在哪
很多抖音下载工具能抓单条链接,但它有三处不一样。
浏览器兜底:翻页受限时自动开浏览器
"只能抓到 20 条"通常是翻页风控造成的。它检测到翻页被限制时,会拉一个真实浏览器,留给人工过验证码:
browser_fallback: enabled: true headless: false # 显示窗口,方便你手动过验证 max_scrolls: 240 idle_rounds: 8这让它的成功率比纯 API 工具高出一截。
双重去重 + 增量:不重存、不重下
判断"要不要跳过"靠数据库记录和本地文件双重检查;再开增量模式,第二次起只下新作品:
database: true increase: post: true配成每周定时任务时,第二周只补新发布的作品,不浪费流量。
结构化保存:一个作品一个文件夹
文件按"作者 → 模式 → 作品"自动归档,每个作品目录下视频、封面、音乐、元数据、评论放在一起,不用再去翻文件名:
Downloaded/ └── 作者名/ └── post/ └── 2024-01-15_作品标题_aweme_id/ ├── video.mp4 ├── cover.jpg ├── music.mp3 ├── metadata.json └── comments.json一次真实任务:我的一次完整保存流程
用一个真实需求把流程串起来:存下某位创作者的全部作品,顺手把他收藏的合集也抓下来。
粘贴链接开始。桌面版里直接把抖音主页链接贴进去,下载按钮就在旁边,不用先写配置:
命令行党则把主页链接填进link,mode设post,number.post: 0表示不限量。
下载途中看进度。任务中心把所有下载任务列在一起,成功、失败数一目了然,还能一键打开输出目录,不用一直盯着终端:
跑完后收结果。文件已按作品分好类,同目录下的download_manifest.jsonl记录了这一轮下载清单,方便核对和二次加工。
🛠️ 调优与排坑:常见现象和解法
不用通读配置。遇到问题时查对应行就行:
| 现象 | 解决 |
|---|---|
| 只能抓到 20 条 | 开browser_fallback.enabled: true且headless: false,浏览器弹窗后手动过验证,别立刻关窗口 |
| Cookie 失效 | 重新执行python -m tools.cookie_fetcher --config config.yml |
| 进度条反复刷屏 | 默认保持progress.quiet_logs: true,调试时再加--show-warnings |
| 下载太慢 | 把thread调到 3–5,避开高峰,或在proxy里配代理 |
| 存储空间不够 | 开增量模式只下新内容,也可调低下载质量 |
| transcript 没生成 | 查transcript.enabled: true、是否视频(图文不转写)、密钥是否有效 |
几个常用调优项,列在这方便随手改:
thread: 5 # 并发数,建议 3–5 retry_times: 3 # 失败重试次数 start_time: "2024-01-01" # 只下指定时间后的作品 end_time: "2024-12-31" # 只下指定时间前的作品 music: true # 同时下背景音乐 cover: true # 同时下封面技术内幕:它为什么稳(选读)
不深究也能看懂分工:
core/ 核心下载引擎(API 客户端与各下载器策略) control/ 队列、限速(默认 2 请求/秒)、重试(指数退避) storage/ SQLite 去重 + 文件管理 utils/ 签名算法(xbogus/abogus)、日志、通知稳定靠三件事:指数退避重试,失败后等待逐渐变长,避免对同一接口硬刚;完整性校验,按Content-Length比对,文件不完整就自动清掉重下;双重去重,数据库加本地文件,双重防重存。细节可以看 核心引擎源码 和 存储模块。
横向选择:哪个方案适合你
| 能力 | 命令行版 | 桌面版(Douzy) |
|---|---|---|
| 安装复杂度 | 中等 | 简单 |
| 配置灵活性 | 高 | 中 |
| 界面 | 命令行 | 图形界面 |
| 实时进度 | 支持 | 支持 |
| 关注列表同步 | 不支持 | 支持 |
| 任务管理 | 基础 | 高级 |
| 适合谁 | 技术用户、定时任务、脚本集成 | 所有用户,尤其新手 |
做定时任务、想接脚本,命令行最灵活;不想碰终端,桌面版粘贴链接就能开始下。关注列表同步是桌面版的独占能力:
🎯 收口:开始批量保存
Douyin Downloader 一句话价值:你给链接,它负责抓下来、去重、归档。免费开源,也会随平台变化持续更新。直接跑:
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 python run.py -c config.yml -u "你的抖音主页链接"代码完全开放可查,遇到问题或想提功能,走项目 Issues 反馈即可。项目定位为技术研究、学习与个人归档,请保持合规使用。
【免费下载链接】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),仅供参考