抖音批量下载完整指南:douyin-downloader 免费教程
【免费下载链接】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 提供抖音批量下载、去水印、自动重试与 SQLite 去重,免费开源。想象你要收集 30 个博主的作品,跟着这篇批量下载教程,5 分钟跑通全流程。
桌面版 Douzy 工作台:粘贴链接即可开始下载,支持多链接队列管理
🎯 速览核心能力:抖音批量下载能替你干哪些活
这一节回答:它到底能替你干哪些活。
- 批量下载视频、图集、合集与原声音乐
- 自动挑无水印源和最高码率,默认去水印
- 数据库 + 本地文件双重去重,重跑不重复
- 失败自动重试,按 1/2/5 秒指数退避
- 翻页被风控时弹浏览器兜底,人工过验证
- 增量模式只抓新作品,支持按时间过滤
| 对比维度 | 手动操作 | douyin-downloader |
|---|---|---|
| 50 条作品耗时 | 约 3 小时 | 约 15 分钟 |
| 去水印处理 | × | √ |
| 重复下载检查 | 肉眼核对 | 数据库自动 |
| 失败重试 | 手动再来 | 自动 3 次 |
🚀 手把手跑通抖音批量下载全流程(装→配→跑→看)
这一节解决:从 0 到第一条视频落地,一共敲哪几条命令。
装:把项目拿下来,装好依赖。
git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip3 install -r requirements.txt cp config.example.yml config.yml依赖装完没有红色报错,这一步就算成功。
配:把配置改成你自己的链接,再抓一次登录态。编辑config.yml,最小配置长这样:
link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx # 换成博主主页链接 path: ./Downloaded/ mode: [post] thread: 5然后一键配置 Cookie 登录态(会弹出浏览器):
python -m tools.cookie_fetcher --config config.yml扫码登录后回到终端按 Enter,Cookie 自动写回 config.yml,看到写入提示即成功。
跑:一条命令开始下载。
python run.py -c config.yml任务中心实时显示每个批量下载任务的成功、失败与跳过数量
看结果:终端出现=== Overall Summary ===和成功 X / 失败 0 / 跳过 0就是跑完了。去Downloaded/作者名/post/下看文件,每个作品一个以发布日期命名的文件夹,里面是视频、封面和元数据。
🔧 3 个真实场景的批量下载配置模板
这一节给你 3 份可以直接抄的配置,对应最常用的三类用法。
音乐创作者收集原声素材
只想要背景音乐、不想要视频,把music打开、video关掉即可,元数据也顺手存下:
link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx mode: [music] music: true video: false json: truemode: [music]表示只抓该博主使用过的音乐,优先取原声文件。json: true会在旁边存一份作品 JSON,方便后期按标题、作者检索。改number下对应项可以限制只取前 N 条。
运营团队批量导出博主作品
需要按时间段圈定范围时,用start_time卡住起点,number.post控制条数:
link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx mode: [post, like] number: post: 50 start_time: "2026-01-01" thread: 5start_time格式固定为YYYY-MM-DD,只下载这个日期之后发布的作品;填end_time可以封顶。同一博主的 post 和 like 模式自动跨模式去重,同一条作品不会下两遍。
自媒体运营同步关注的新作品
把increase.post打开,程序只抓新发布的作品,旧的直接跳过:
link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx mode: [post] increase: post: true database: true增量判断依赖 SQLite 记录,所以database必须保持true。配合系统定时任务每天跑一次,就是一份每日素材更新器。
📊 实测数据与边界:先看耗时再调并发
这一节用数字说话:多大的任务、花多少时间。
| 样本规模 | 测试环境 | 参考耗时(5 并发) |
|---|---|---|
| 30 条作品 | 100Mbps 宽带 | ≈ 12 分钟 |
| 100 条作品 | 100Mbps 宽带 | ≈ 38 分钟 |
| 重复跑同一博主 | 任意网络 | 0 条重下 |
以上为家庭宽带的估算值,默认限速 2 请求/秒,弱网或触发风控翻页时耗时会明显拉长,请自行留余量。
🔍 看一眼底层:3 个关键模块各管什么
这一节只给想排查问题或动手改代码的人,30 秒扫一眼即可。
- 命令行主流程:读配置、调度下载、最后打印成败汇总。
- SQLite 去重库:记录每个已下作品,重复任务靠它跳过。
- Cookie 自动抓取:弹浏览器登录一次,登录态自动写回配置文件。
🛠️ 踩坑自救:5 个高频异常的处理步骤
这一节收集了 5 个最常被问到的报错,照着步骤来。
Q:下载刚开始就报错,提示登录态失效(Cookie 过期)
- 重跑
python -m tools.cookie_fetcher --config config.yml - 扫码登录后回到终端按 Enter
- 确认 Cookie 已写回 config.yml
- 重新执行下载命令
Q:只抓到 20 条作品就停了(翻页风控)
- 检查
browser_fallback.enabled: true - 检查
browser_fallback.headless: false - 浏览器弹出后手动完成滑块验证
- 别急着关窗口,等它自动采集完
Q:卡在某个文件上超时不动
- 换个网络空闲时段再试
thread: 3把并发调低- 确认
retry_times: 3启用重试 - 必要时在
proxy配置代理地址
Q:进度条疯狂刷日志,看不清内容
- 确认
progress.quiet_logs: true(默认开启) - 调试时临时加
-v参数看详细日志 - 长期运行别留 verbose 模式
Q:想重下某条作品,却被判为已下载跳过
- 删掉文件名里含该 aweme_id 的本地文件
- 删掉数据库里的对应记录:
sqlite3 dy_downloader.db "DELETE FROM aweme WHERE aweme_id = '你的aweme_id';"- 再跑一次,文件缺失就会触发重下
✅ 接下来你可以做的 3 件事
这一节给 3 个小动作,照着做就能榨出更多价值。
- 把
number.post改成 0,跑一次全量下载 - 打开
music: true,顺带存下原声 - 给项目点 Star,盯 release 页拿更新
跑完记得备份一下下载目录,素材在本地才踏实。
【免费下载链接】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),仅供参考