抖音批量下载完整教程：如何用 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

douyin-downloader 是一个开源的抖音批量下载工具：支持单条视频、图集、合集、音乐与账号收藏夹的无水印下载，内置 SQLite 去重、浏览器兜底与直播录制，适合个人数据备份与素材收集的用户。

📋 核心功能清单

先用一张表过一遍这个抖音下载器能做什么。全部能力由一个 YAML 配置文件驱动，无需写代码：

文件默认按Downloaded/作者名/模式/日期_标题_aweme_id/组织，视频、封面、音乐、JSON 元数据同目录存放，另生成download_manifest.jsonl清单，便于后续检索。

同一套后端还提供桌面版 Douzy（内测中，从项目 Releases 页获取）：粘贴链接开下、同步关注列表、在任务中心管理多链接队列。

🚀 安装到首次运行：从依赖到第一次下载

1. 安装依赖

Python 3.9+ 环境，三条命令：

git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt

需要浏览器兜底或自动取 Cookie 时再装：

pip install playwright python -m playwright install chromium

2. 写配置

把 config.example.yml 复制为config.yml，改成最小配置即可：

link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx path: ./Downloaded/ mode: - post number: post: 50 thread: 5 database: true

number为各模式的数量上限，0表示全量；更多字段含义见 README.zh-CN.md 的"关键配置项"。

3. 获取 Cookie

多数批量任务需要有效 Cookie。推荐用项目自带的自动脚本 tools/cookie_fetcher.py：

python -m tools.cookie_fetcher --config config.yml

在弹出的浏览器里登录抖音，回终端按 Enter，Cookie 会自动写回配置。

4. 第一次下载

python run.py -c config.yml

常用命令行参数：

🎯 典型场景：批量下载任务怎么写

场景一：博主内容归档

需求：把某博主的全部教程和合集存档，之后定期补新。

操作：number写 0 表示全量，加上music可顺带保存其使用过的原声：

link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx mode: - post - mix - music number: post: 0 mix: 0 music: 0

效果：作品按post/mix/music子目录归类，文件名用作品发布日期 + 标题 + ID（非下载时间）。同一配置重跑时配合increase增量开关，只拉取新发布的内容。

场景二：账号收藏夹批量保存

需求：把自己账号里的收藏作品、收藏合集备份下来。

操作：collect/collectmix只认当前 Cookie 对应账号，且必须单独使用，不能与post/like/mix/music混用：

link: - https://www.douyin.com/user/self?showTab=favorite_collection mode: - collect number: collect: 0

效果：收藏内容进入collect/目录。桌面版里可以直接在"收藏与喜欢"页查看当前账号的收藏视频、收藏合集与喜欢列表，逐项发起下载。

场景三：直播录制（实验性）

需求：录一场重要的直播，不想手动切换录屏。

操作：链接指向直播间即可：

link: - https://live.douyin.com/123456789 live: max_duration_seconds: 3600 # 0 = 录到主播下播

效果：FLV 文件与*_room.json房间快照保存在Downloaded/作者名/live/；主播下播、网络空闲或 Ctrl+C 中断时，已录制的字节都会保留。

🔧 进阶配置与常见坑

长期使用值得调整的几个开关：

• 增量下载：increase.post: true（like/mix/music 同理），必须同时database: true；
• 时间过滤：start_time/end_time（YYYY-MM-DD），只拉取区间内发布的作品；
• 画质控制：video_quality: original会探测原片（每条作品多一次探测请求），highest是默认档，也可指定1080p等；
• 完成通知：notifications.providers配 Bark / Telegram / Webhook（企业微信、飞书、钉钉 bot 均可），单个通道失败不阻塞下载；
• 评论采集：comments.enabled: true后每个作品生成*_comments.json，include_replies决定是否拉二级回复。

常见问题对照：

跑完批量任务后，可在桌面版任务中心查看每个任务的成功/失败计数，并对失败项重试：

🏗️ 模块划分与设计要点

项目按职责拆成八个包，I/O 全部走异步（aiohttp + aiosqlite），完整流程说明见 PROJECT_SUMMARY.md：

两个设计点值得一提：去重不依赖单一事实源，数据库记录与本地文件名各查一遍，任一侧都能挡住重复下载；下载过程做 Content-Length 完整性校验，残缺文件会自动清理并重试。相关设计文档见 docs/superpowers/specs/。

现在开始

如果你需要定期归档抖音内容，先用"安装到首次运行"一节的最小配置跑通一条链接，再按实际需求叠加增量、时间过滤与通知推送即可。请仅将本工具用于个人备份与学习交流，下载自己有权或已获授权的内容，遵守平台规则与当地法规；项目遵循 MIT License。

【免费下载链接】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