抖音下载器: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 就是干这个的:把主页链接填进配置文件,视频、图文、合集、原声音乐就能批量无水印下载,默认 5 并发、SQLite 去重和指数退避重试都已配好。桌面版 Douzy 还在内测,命令行版现在就能用,10 分钟内可以跑通第一条下载。
项目速览:10 秒判断值不值得装
| 维度 | 说明 |
|---|---|
| 解决的问题 | 单条视频手动录屏、主页作品逐条收藏、重复下载浪费空间 |
| 支持的内容 | 视频、图文、合集、音乐(原声)、主页批量(post/like/mix/music)、账号收藏夹、直播录制、评论采集 |
| 依赖的环境 | Python 3.8+,macOS / Linux / Windows;浏览器兜底可选装 Playwright;提供 Dockerfile |
| 内置能力 | SQLite 去重、指数退避重试(1s/2s/5s)、默认 2 请求/秒限速、Content-Length 完整性校验 |
只存几条视频的话,前两行就够了;要做竞品分析或数据采集,内置的去重与增量下载才真正值得装。下面场景截图来自桌面版 Douzy,它与命令行共用同一套后端,行为一致。
快速上手:三步完成首次下载
1. 安装依赖
git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt2. 配置并获取 Cookie
cp config.example.yml config.yml打开config.yml,至少填三项:link(视频或主页链接)、path(保存目录)、mode(如 post)。抖音访问内容需要 Cookie,最快的方式是自动获取:在终端执行python -m tools.cookie_fetcher --config config.yml,浏览器弹出后扫码登录,回到终端按 Enter,Cookie 会自动写回配置文件。会话管理机制可看 认证模块。
3. 首次运行
python run.py -c config.yml程序按配置开始下载,Rich 进度条实时显示解析、排队与下载阶段,不完整的文件会自动比对大小并重新下载。
场景化功能:四种最常用法
单链接无水印下载:视频、图文、合集都走通
把单条链接贴进link,工具自动解析 v.douyin.com 短链,挑选无水印源,默认取最高码率档位。
link: - https://www.douyin.com/video/7604129988555574538得到的是./Downloaded/下的视频文件;想要封面或音乐,把cover: true/music: true打开即可。
批量下载创作者主页作品
主页链接加post模式,number.post: 0表示全量,写50则只取最近 50 条。
link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx mode: [post] number: {post: 50}完成后文件按Downloaded/{作者}/post/{date}_{title}_{id}/归类,任务列表能查到每位作者的下载条数,失败项单独重试。like/mix/music 各自策略的实现在 下载策略目录。
归档自己账号的收藏夹与收藏合集
基于当前登录账号,collect下载收藏夹里全部作品,collectmix下载收藏合集,不用逐条复制链接。
link: - https://www.douyin.com/user/self?showTab=favorite_collection mode: [collect]注意 collect/collectmix 只能单独使用、不能与 post/like 混用,且只对 Cookie 对应的账号生效。
关注博主后只下新作品
increase: {post: true}配合database: true,下载前会先比对 SQLite 记录,跳过已下过的作品。
increase: {post: true} database: true每周跑一次,上千条作品的主页几分钟下完新增部分;post/like/mix 跨模式遇到同一个 aweme_id 也会自动去重,不重复占空间。
进阶调优:最可能改的 3 个参数
thread: 8:并发数,默认 5。100Mbps 宽带建议 8-12,别超过 16,限速更容易触发风控。filename_template: "{date}_{title}_{id}":文件与目录命名模板,支持 {author}/{mode}/{month} 等变量;模板里必须留 {id} 防重名覆盖。notifications:配置 bark / telegram / webhook 后,任务结束自动把成功或失败推到手机,适合跑长任务时不用守在终端。
想看目录结构、命名与去重的具体实现,可看 文件管理模块。
避坑指南:四个高频问题
只下载了 20 条左右就停了
现象:批量任务停在 20-40 条不再继续。原因:抖音翻页风控,接口提前截断列表。解决:配置browser_fallback.enabled: true,提前装好pip install playwright并执行python -m playwright install chromium,弹窗出现时手动过完验证码,别急着关窗口。
下载突然全部失败
现象:之前能下,突然条条报错。原因:Cookie 失效或账号被临时风控。解决:重跑python -m tools.cookie_fetcher --config config.yml重新扫码,再执行原任务。
视频文件损坏播放不了
现象:文件生成了但播到一半断开。原因:网络中断导致文件不完整。解决:工具会按 Content-Length 自动清理不完整文件并重试;仍失败就调低thread,并检查proxy是否指向可用代理。
同样的作品又下了一遍
现象:重跑任务时老作品被重新下载。原因:去重依赖数据库,database: false或库被手工删除后记录就丢了。解决:保持database: true,不要手动删 dy_downloader.db。
适合谁用
douyin-downloader 把翻页、去重、重试都封装成了默认值,你只管贴链接。它适合个人素材收集者、做竞品分析的创作者,以及需要批量社交数据的研究者。更多配置项和参数说明见仓库 中文 README,遇到问题欢迎提 Issue 一起讨论。
【免费下载链接】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),仅供参考