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 是一个用 Python 编写的开源抖音批量下载工具：命令行加一份 YAML 配置文件，就能完成单条视频、图文图集、合集、音乐原声的去水印下载，作者主页支持全量备份，直播录制与评论抓取也在覆盖范围内。它适合想收藏视频的普通用户、要建素材库的创作者，以及做内容分析的研究者。

30 秒速览

截图来自同后端的桌面版 Douzy（内测中），与命令行版能力一致。

🔍 上手前搞懂三件事

这个工具到底是什么

一个运行在终端里的 Python 开源下载器：读取配置、通过接口抓取内容、写入本地文件，并实时展示进度条。另有一个同后端的桌面版 Douzy（内测中），文中截图均出自它。

不懂代码能不能用

能。完整流程是「装依赖 → 改配置 → 跑一条命令」，全程不需要编程知识，你只需要会粘贴链接和指定存放位置。

上手前需要准备什么

两样：Python 3.8+ 环境（macOS / Linux / Windows 均可），以及一份有效的抖音登录 Cookie。工具自带自动化获取命令，按提示在浏览器登录一次即可。

🚀 10 分钟跑通第一个下载任务

工具会自动识别链接类型：v.douyin.com短链、/video/、/note/、/collection/、/music/、/user/以及live.douyin.com都能直接处理，多个链接写入配置后会逐个处理并自动去重。

第一步：拉取代码与依赖

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

你会看到：pip 依次安装 aiohttp、rich、pyyaml 等依赖，无报错即环境就绪。

第二步：准备配置文件

cp config.example.yml config.yml

你会看到：生成一份带全量参数注释的 config.yml。把它改成最小配置（各参数含义见 config.example.yml）：

link: - https://www.douyin.com/video/7604129988555574538 path: ./Downloaded/ mode: - post thread: 5 database: true

第三步：一步获取登录态（Cookie）

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

你会看到：弹出浏览器窗口，登录抖音后回到终端按回车，Cookie 自动写入 config.yml，无需手动复制粘贴。

第四步：运行并验证

python run.py -c config.yml

你会看到：Rich 进度条实时刷新任务状态，跑完后文件落进Downloaded/目录。

下载结果会按「作者名 / 内容类型 / 日期_标题_aweme_id」自动归档，视频、封面、音乐与 JSON 元数据同目录存放。

📦 作者主页全量备份：从单条到批量

把link里的单条视频换成作者主页，并将number.post设为 0（0 = 不限量），即可一次性归档该博主的全部作品：

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

还可以同时勾选like（点赞）、mix（合集）、music（原声）模式；链接指向合集时会拉取合集内全部作品。跨模式下同一作品不会重复下载：去重依赖 SQLite 数据库 + 本地文件双重判断，中断后重跑同一条命令，已完成的作品自动跳过、不重复劳动。配合start_time/end_time还能只取某时间段的作品。

✨ 它还能做什么：直播录制、评论抓取与增量备份

直播录制：把live.douyin.com/{room_id}的直播间链接写入link，即可获取直播流并录制为 FLV，主播下播或手动中断时已录数据完整保留。适合整场留存长内容。

评论采集：开启comments.enabled: true后，每个作品旁会生成*_comments.json，可选是否抓取二级回复。输出为 JSON，便于导入表格或数据库做评论分析。

增量备份：设置increase.post: true（需开启 database），只拉取新增作品，旧内容不再重复请求，配合时间过滤更省流量。适合定期追踪固定博主，桌面版还能同步关注作者并标记新作品。

🛠️ 问题速查：常见现象与解决办法

一句话结论

• 如果你想把几条抖音视频无水印存下来，一条命令就够，画质自动挑选高码率。
• 如果你想归档一整个账号的作品，用作者主页 +number: 0全量备份。
• 如果你想长期建素材库，增量备份 + 时间过滤，新作品自动入库。
• 如果你还需要直播或评论数据，它也能扩展到同一套流程里。

douyin-downloader 是目前覆盖抖音批量下载场景较完整的开源项目之一，值得放进工具箱。合规提醒：请仅在合法合规范围内使用，尊重原作者版权，下载内容勿用于违规用途；若平台接口策略变化导致功能失效，重新获取 Cookie 并查看 中文 README 通常即可解决。

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