免费批量下载抖音无水印视频的完整指南: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 是一款免费的抖音批量下载工具,无水印视频、图集、合集、音乐原声一次配置就能全部拿下。
douyin-downloader 是什么、适合谁
- 一个基于 Python 的开源命令行下载工具,MIT 协议,克隆即用
- 面向内容创作者、自媒体运营、数据研究者三类典型用户
- 解决三件事:无水印视频获取、主页级批量下载、重复内容不再存第二遍
- 附带进度条、失败重试、SQLite 记录,长时间任务可放心挂着跑
三步完成首次无水印下载
第一步:装好依赖(约 2 分钟)
git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader && pip install -r requirements.txt做对了长什么样:终端最后出现Successfully installed,没有红色 Traceback。
第二步:拿到抖音 Cookie(首次必须)
python cookie_extractor.py浏览器自动打开,扫码或短信登录抖音,回到终端按回车,Cookie 会自动写入配置文件。不想装浏览器的话,可以改用python get_cookies_manual.py,从浏览器开发者工具里复制整串 Cookie 粘贴进去。
做对了长什么样:终端提示保存成功,配置文件里cookies一栏不再是空值。
第三步:改两个字段,跑第一个任务
把config.example.yml复制为config.yml,只改link(放视频或主页链接)和path(保存目录),然后:
python DouYinCommand.py做对了长什么样:path目录下按作品生成子文件夹,视频为无水印 mp4,同时附带_cover.jpg封面和_data.json元数据。
能力清单:哪些下载需求被覆盖
| 下载需求 | 支持情况 | 白话说明 |
|---|---|---|
| 无水印视频源 | 支持 | 自动挑选最高码率的无水印源,视频和实况图都生效 |
| 主页作品批量 | 支持 | 发布作品 post / 点赞 like / 合集 mix / 原声 music 四种模式可叠加 |
| 短链自动解析 | 支持 | v.douyin.com分享链接直接丢进去,自动展开成正式地址 |
| 下载去重与增量 | 支持 | 数据库加本地文件双重检查,跑过的新旧作品不重复下载 |
| 浏览器兜底 | 支持 | 接口翻页被风控时自动切换浏览器抓取,可人工过验证码 |
| 进度与重试 | 支持 | Rich 进度条实时刷新,失败按 1s/2s/5s 指数退避重试 |
| 附加资源 | 支持 | 封面、音乐、头像、JSON 元数据按需保存,评论可另存 JSON |
| 直播录制 | 实验性 | 拉 FLV/HLS 流,主播下播或中断时已录内容保留 |
三个高频场景的落地配置
把某创作者发布的全部作品一次收齐
痛点:主页作品多,手动保存要几个小时,还容易漏。
link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx path: ./素材库/ music: true json: true运行python DouYinCommand.py后,每个作品一个独立文件夹,按作者名归档;中途断了再跑一次,已下载的会自动跳过。
只补新作品,旧视频不重复下
痛点:每周想更新一次同一批博主的素材,不想重下几千个旧文件。
link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx path: ./素材库/ increase: post: true保持database: true(默认开启),第二次运行时数据库里的记录会挡掉旧作品,只把新增的拉下来。
给研究数据附上元信息与评论
痛点:分析一条视频的热度,光有 mp4 不够,还要作者、时间、互动数这些字段。
在douyin-downloader/目录下新建配置:
link: - https://www.douyin.com/video/7604129988555574538 path: ./研究数据/ json: true comments: enabled: true运行python run.py -c config.yml,媒体文件旁会多出_data.json和_comments.json,点赞、评论、二级回复都在里面。
出问题时按现象快速定位
- 只能抓到 20 条作品就停→ 接口翻页触发风控 → 确认
browser_fallback.enabled: true且headless: false,弹窗出现后手动完成验证再关窗口 - 大面积提示登录失效或返回空数据→ Cookie 过期 → 重新跑
python cookie_extractor.py刷新登录态 - 同一作品被下载了两次→ 去重链路被破坏(只删了文件没删库,或反之)→ 保留
database: true,清理时本地文件夹和dy_downloader.db记录同步处理 - 进度条日志刷屏看不清→ 日志级别过高 → 配置里设
progress.quiet_logs: true,需要排查时再临时加-v
两个关键机制:去重与浏览器兜底
双重去重。程序同时查两处:SQLite 数据库里的 aweme_id 记录和保存目录里的本地文件名。两边任一命中就跳过,所以跨模式(post 和 like 抓到同一条)也不会存第二遍。对你意味着:任务可以放心重复跑,磁盘和带宽都不浪费。
浏览器兜底。接口翻页被风控时,工具自动拉起 Playwright 浏览器模拟真人滚动加载,遇到验证码就停住等你人工处理。对你意味着:长主页批量任务不会因为接口限制而半途收工,成功率不依赖单一通道。
下一步:四件事按顺序做
- 5 分钟:克隆仓库、装依赖,完成环境准备
- 10 分钟:获取 Cookie,下载第一条无水印视频验证链路
- 15 分钟:把
config.example.yml改成你自己的批量任务并跑通 - 可选:开启
increase增量模式,配合系统定时任务做自动素材更新
延伸阅读(均在仓库内):USAGE.md 使用说明、config.example.yml 配置示例、douyin-downloader/ V2 核心源码目录、apiproxy/douyin/strategies/ 接口与浏览器双策略实现。
工具只负责下载,内容请合规使用。祝素材越攒越全。✅
核心关键词:douyin-downloader 抖音批量下载|长尾关键词:抖音无水印视频下载工具,抖音用户主页批量下载,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
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考