douyin-downloader: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 是一个开源的抖音无水印批量下载工具。视频、图集、合集、原声音乐都能批量存到本地,单条链接和整个主页都支持。看完这篇,你会知道装环境、配 Cookie、发链接这 3 步怎么做。
先看清楚它能干什么
| 能力 | 说明 |
|---|---|
| 无水印下载 | 视频、图集、短链自动展开 |
| 主页批量抓取 | post / like / mix / music 4 种模式 |
| 筛选控制 | start_time / end_time 时间过滤,number 数量上限 |
| 去重与重试 | SQLite 数据库 + 本地文件双重比对 |
| 附加采集 | 评论 JSON、直播录制、热搜榜导出 |
偏好图形界面的话,项目还有一个同源桌面端 Douzy,粘贴链接点检测就能下载。
从 0 到跑通:装依赖、配 Cookie、发第一条链接
整个安装过程只有 3 条命令。
拉代码并装依赖:
git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader pip install -r requirements.txt第一条把项目复制到当前目录,第二条装好全部第三方库,等进度条走完即可。
生成配置文件,然后扫码登录:
cp config.example.yml config.yml python -m tools.cookie_fetcher --config config.yml第一条把示例配置复制成自己的 config.yml;第二条会打开一个浏览器窗口,你扫码登录抖音,回到终端按回车,Cookie 就自动保存好了,不用手抄任何字符串。
用一条视频链接验证环境:
python run.py -c config.yml -u "https://www.douyin.com/video/7604129988555574538"工具会自动解析链接、挑无水印源、按最高码率下载。命令行上能看到进度条和保存路径,跑完后在Downloaded/目录下看到无水印视频、封面图和一份 JSON 元数据,就算通了。
3 个最实用的批量场景
搬空一个博主的主页
当你在追一位创作者,想把 ta 发布过的作品全存下来时,这样配:
link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx mode: [post] number: post: 0 start_time: "2026-01-01"post: 0表示不限数量,全量抓取;start_time加上时间过滤,比如只拉今年发布的。跑完后你会得到按"日期_标题"命名的文件夹,每条作品一个目录,里面是无水印视频、封面、元数据。
长期跟踪一个主页
当你隔三差五回来补一次更新,把increase里的post保持true就行。第二次运行时,工具会自动跳过已下载过的作品,只补新增内容——不用删库,不用手动挑哪条新哪条旧。
攒一批素材做研究
想顺手把评论也留下,在配置里把comments.enabled打开,跑完每个作品会多一个*_comments.json文件,方便后续做内容分析。
用久了才在意的 3 个细节
- 双重去重:SQLite 数据库加本地文件比对,同一条作品从单链接、主页、合集任何入口进来都只落盘一次。
- 指数退避重试:瞬时失败按 1 秒、2 秒、5 秒自动重试 3 次,不用人盯着。
- 文件完整性检查:下完比对文件大小,发现"半截"文件会自动清理重下,不留坏文件。
- 浏览器兜底:API 翻页受限时自动打开浏览器继续抓,遇到验证码你人工过一下即可。
跑不通?3 步定位问题
先查 Cookie 是否过期——大概率是登录态失效,重新跑一次python -m tools.cookie_fetcher --config config.yml就行。再查链接是否有效,浏览器里能打开才算数。最后看并发:默认 5 个线程,网络不稳时把thread调到 2~3 试试;还不行就换个入口,单链接卡住时改用主页批量模式。
完整配置项和更多命令可以翻 config.example.yml。现在就装上跑第一条链接试试,下载内容仅用于个人学习和研究,尊重创作者版权,遵守平台规则。
【免费下载链接】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),仅供参考