douyin-downloader:4步搞定抖音无水印批量下载,自动归档保存作者主页
【免费下载链接】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
你是不是也这样:看到一条好视频、一个博主整页主页都想存下来,可 App 不让保存,录屏画质差还有水印,手动一条条点又累又慢。douyin-downloader 是一款免费开源的抖音批量下载工具,直接从服务器拿到无水印高清视频,还能一次抓下作者主页、合集与音乐,自动分好文件夹,带进度条和重试。
📊 项目能力全景:抖音无水印下载、增量下载等核心能力一览
一句话先说清楚:它不是录屏工具,也不是帮你剥水印的镜像站,而是直接和抖音服务器对话的下载器。你最关心的五件事,都在这张表里:
| 核心能力 | 它能帮你做什么 |
|---|---|
| 无水印高清下载 | 自动选无水印源,从码率阶梯里挑最高档,还能探测原画 |
| 作者主页批量下载 | 贴一个主页链接,作品、点赞、合集、音乐批量入库,跨模式自动去重 |
| 增量下载 + 双重去重 | SQLite 记录和本地文件双重核对,重跑只抓新作品,不重复劳动 |
| 浏览器兜底 | API 翻页被风控拒掉时自动拉起浏览器,人工过一下验证就继续 |
| 进度、重试、完整性校验 | 进度条实时可见,失败指数退避重试,下载不完整的文件自动清理重下 |
基于同一套后端的 Douzy 桌面版(内测中):粘贴链接即识别,一键开始
🛠️ 环境搭建与首次运行:作者主页批量下载四步走
从一台干净的机器到第一批作品落地,一共四步。你只需要准备一个已登录的抖音账号,剩下照做就行。
1. 克隆仓库并安装依赖
这一步装好 Python 3.8+ 环境的核心依赖;想开启浏览器兜底的话,顺手装上 Playwright 和 Chromium 内核。
git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt pip install playwright && python -m playwright install chromium2. Cookie 自动获取一键配置
抖音接口要求登录态,但不用你去浏览器开发者工具里手动翻 Cookie:先复制一份配置模板,再跑内置抓取工具,它会自动打开浏览器,你扫码登录后回终端按 Enter 就写进配置了。注意:跳过这步,后面请求会一路 403,或者只能抓到寥寥几条。
cp config.example.yml config.yml python -m tools.cookie_fetcher --config config.yml3. 写配置文件:贴链接
把link换成想抓的主页地址;number.post: 1表示先试 1 条,跑通之后改成 0 就是全量。
link: - https://www.douyin.com/user/你的主页链接 path: ./Downloaded/ mode: - post number: post: 14. 跑第一次批量下载
回车后泡杯茶,进度条实时可见,失败的会自动重试,最多 3 次。
python run.py -c config.yml🚀 进阶玩法与自动化技巧:增量下载与时间筛选
跑通只是入门,这三个技巧能让它从"能用的工具"变成"自动长内容的资产库"。
增量下载:定时重跑,只抓新作品
用在长期跟踪某个博主、每周补新作品的场景。配置里加两行,程序靠 SQLite 记录加本地文件双重核对,跳过的都算数,直接挂个定时任务就行。效果:重复跑只下新内容,零手动去重。
increase: post: true时间筛选:精准圈定一段时间的内容
只想要某个窗口期内发布的内容,比如最近半年的素材。加两行配置,翻页到边界自动截断,不浪费请求。效果:和增量配合就是"时间窗口 + 新内容"双重过滤,长期抓取非常稳。
start_time: "2026-01-01" end_time: "2026-06-30"REST API 服务模式:用 HTTP 触发下载
有网站或自动化管线,想从 HTTP 触发下载时用。跑python run.py --serve --serve-port 8000(需装 fastapi + uvicorn),别的系统往/api/v1/downloadPOST 一个链接就能拿到 job_id 再查状态,参考REST 服务入口。效果:下载变成服务,不用再登机器手动敲脚本。
任务中心(桌面版截图):每个任务的状态一目了然,失败项可单独重试
🎯 典型用户画像:谁用得最爽?
不同人从它身上薅到的价值不一样,挑三类最典型的说:
个人效率党:把单个创作者的主页全部归档
要解决的问题:怕博主断更或作品被删,又不想一条条手动存。
- 场景 1:把整个主页批量存下来,按日期和作者自动归类,秒级翻找。
- 场景 2:打开
json: true连元数据一起存,之后按点赞数、评论数二次筛选。 推荐组合:mode: [post]+increase.post: true,每周定时跑。
内容创作者:搭一个无水印素材库
要解决的问题:二创需要无水印参考片,还要顺手存下 BGM 原声。
- 场景 1:抓对标博主的高画质作品,
video_quality: original尽量拿原片。 - 场景 2:打开
music: true把背景音乐提出来存成 MP3,直接进素材库。 推荐组合:post+mix多模式(自动去重)+ 时间筛选圈定区间。
数据分析师:批量导出搜索与热搜数据
要解决的问题:需要话题级数据,手动复制不现实。
- 场景 1:一条命令导出热搜榜前 30 名快照,落成 JSONL 进时序库。
- 场景 2:按关键词搜作品列表导出,直接喂给分析脚本。 推荐组合:
--hot-board/--search命令行参数,免配置即开即用。
桌面版"收藏与喜欢"工作台:当前账号收藏视频与喜欢作品可批量入库
⚠️ 踩坑速查表:Cookie 失效、只抓 20 条等高频问题
前两周最容易撞的坑都在这张表里,先对照再动手:
| 现象 | 大概率原因 | 一句话解法 |
|---|---|---|
| 只抓到 20 条就断了 | 翻页触发风控 | 保持browser_fallback开启且headless: false,弹窗出来手动过验证 |
| 大量 403 / 作品取不到 | Cookie 失效 | 重跑Cookie 自动获取工具刷新登录态 |
| 进度条日志刷屏 | 进度阶段日志未静默 | 保持progress.quiet_logs: true,调试时再临时加-v |
| 文件不完整 / 损坏 | 下载途中网络中断 | 程序按 Content-Length 比对自动清理重试,等等就好 |
补充一句:2026-08 起抖音对部分接口陆续收紧风控,一些下载场景目前要靠浏览器兜底硬扛,记得盯项目更新。
性能方面两条小建议:
- 网络不稳时把
thread从 5 降到 3、retry_times提到 5,先求稳再求快。 - 批量下载前留足磁盘空间,长任务开着
progress.quiet_logs,终端干净一半。
📁 输出产物与目录结构:无水印下载自动按作者日期分类
跑完不需要你整理文件,命名和归类都是程序内置规则,典型结构长这样:
Downloaded/ ├── download_manifest.jsonl # 下载清单 └── 作者A/ └── post/ └── 2026-08-01_作品标题_aweme_id/ ├── ...mp4 # 无水印视频 ├── ..._cover.jpg # 封面 └── ..._data.json # 元数据- 文件夹名默认
{date}_{title}_{id},可用filename_template自定义,带上{id}就不会重名 - 作者目录默认用昵称,重度用户换
author_dir: nickname_uid,防止博主改名把目录劈成两半 music: true、cover: true这类开关控制要不要存附带产物,默认只存视频本体download_manifest.jsonl记录全部已下载条目,方便对账和增量核对
🤝 合规提醒与下一步:开始你的第一次无水印批量下载
朋友间的几句话,不端着:
- 去水印的内容版权归原作者,自己存档可以,拿去商用转发就别了
- 建议用在个人学习、研究和管理自己的数据上,别批量抓别人的隐私内容
- 平台风控隔三差五升级,个别接口失效是正常技术风险,跟项目更新走
趁热把手动起来:
- 克隆仓库,
pip install -r requirements.txt装完依赖 - 一键脚本取好 Cookie
- 把
config.yml里的link换成一个想抓的主页 - 先用
number.post: 1试跑一条,确认链路通 - 打开终端,执行
python run.py -c config.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),仅供参考