抖音批量下载完整指南：从单视频到用户主页一键采集的实操手册

【免费下载链接】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 智能去重和多线程并发三件套，能把你从这种重复劳动里彻底解放出来。

手动下载到底输在哪里

先说几个你大概率踩过的坑，看看是否对号入座：

• 效率是硬伤：一个视频手动保存要十几秒，50 个作品就是 10 分钟起步，中间还不能走神。
• 水印破坏素材：官方 App 下载的视频自带抖音水印和账号标识，用在正经项目里显得很不专业。
• 重命名全靠手：下载的文件都是乱码编号，之后想按日期、作者找素材，简直大海捞针。
• 重复下载浪费空间：今天下完明天再检查一遍，硬盘里堆满了同一批视频。
• 网络中断就前功尽弃：下到一半断网，一切从头再来，没有任何断点续传的概念。

这些痛点单独看都不致命，凑在一起就是灾难。而工具要解决的，恰恰就是这一整套流程。

它解决问题的思路：一条自动化的"内容搬运流水线"

你可以把 douyin-downloader 想象成一条工厂流水线：链接输入口 → 类型识别器 → 下载执行单元 → 归档与去重中心。

流水线最前端接收你丢进来的任意抖音链接（短链、视频页、用户主页、合集、音乐页都行），中间的识别器判断内容属于哪种类型并调用对应的下载策略，多个执行单元并行开工，最后由归档中心按"作者/日期/标题"自动命名存放，同时把每一条下载记录写进 SQLite 数据库。下一次再跑同一个链接，数据库直接告诉你"这个下过了，跳过"。整条流水线里最麻烦的环节——去水印、翻页、重试、去重——全部自动完成，你只需要负责丢链接和收结果。

5 分钟上手：安装、配置、首次运行

第一步：克隆仓库并安装依赖

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

三条命令完成克隆和依赖安装，依赖主要是aiohttp（异步网络请求）、rich（漂亮的命令行进度界面）、pyyaml（读取配置文件）这几个库。

你可能会遇到：pip安装速度慢，建议加上-i https://pypi.tuna.tsinghua.edu.cn/simple使用国内镜像源；如果提示缺playwright，再单独执行playwright install chromium即可。

第二步：准备 Cookie（最关键的一步）

抖音接口需要登录态，项目提供了两种拿 Cookie 的方式：

# 方式一：自动获取，会打开浏览器让你扫码登录 python cookie_extractor.py # 方式二：手动粘贴浏览器里的 Cookie 字符串

Cookie 是抖音用来识别你身份的一组认证信息，相当于"通行证"。自动获取方式会调用 Playwright 打开真实浏览器，你扫码登录后它会自动提取并写入配置，全程不用手动复制粘贴。

你可能会遇到：浏览器没被自动拉起。先执行playwright install chromium安装浏览器内核，再重试。

第三步：跑一个最小配置

把链接填进config.yml的link列表，然后执行：

python run.py -c config.yml

如果配置正确，你会看到带进度条的下载界面，作品按"作者/发布模式/日期_标题"的目录结构落盘，结束后命令行还会打印一份汇总统计：成功几个、失败几个、跳过几个重复文件。

你可能会遇到：提示Config file not found。默认读取根目录的config.yml，把仓库里的config.example.yml复制一份改名即可。

四个核心功能逐个拆解

① 单视频 / 图集下载：一行命令拿到无水印原片

它能解决什么：收藏夹里看到一条好视频，想存下来做素材，官方 App 存下来的带水印。

怎么用：

python run.py -u "https://v.douyin.com/xxxxx/" -c config.yml

短链会被自动解析成完整链接，再提取出作品 ID 进行下载。

效果长什么样：视频、封面图、背景音乐、原始 JSON 数据会一起存进以"日期_标题"命名的文件夹。想关掉某些附带内容，把配置文件里的music: true、cover: true改成false就行。对于图文作品（/note/链接）同样支持，每张图会按序号保存。

② 用户主页批量下载：整个账号一键搬空

它能解决什么：做竞品分析、追更某个创作者，需要把他主页的全部作品批量拿下来。

怎么用：把link改成用户主页地址，同时设置下载模式：

link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx mode: - post # 发布的作品 # - like # 喜欢的作品（需要登录态） # - mix # 用户的合集 number: post: 50 # 只下最近 50 个

效果长什么样：程序自动翻页拉取作品列表，多线程并发下载。加一行increase: post: true还能开启增量模式——下次再跑，数据库里已存在的作品直接跳过，只下载新增内容，完美适配"每天追更"的场景。

③ 合集与音乐（原声）下载：按系列和 BGM 组织素材

它能解决什么：创作者发布的系列教程是分合集管理的，直接下载主页会打乱顺序；而同一首 BGM 下的所有作品，是做音乐趋势分析的最佳样本。

怎么用：把合集链接（/collection/或/mix/）或音乐链接（/music/）放进link，工具会自动识别类型，无需额外参数。

效果长什么样：合集下载后按合集名建立文件夹，音乐模式则按"音乐名_音乐ID"归档，每一条作品都保留完整的元数据 JSON，方便后续用程序批量分析。

④ 浏览器兜底：API 失效时自动切换策略

它能解决什么：抖音接口偶尔会调整或限流，纯 API 方式拉取可能翻页翻不动。

怎么用：无需手动干预。项目内置了三层策略——API 请求优先，失败时自动重试（指数退避），仍然失败则启动浏览器模拟人工滚动页面采集数据。这套逻辑在apiproxy/douyin/strategies/目录下以策略模式实现，你可以在config.example.yml里调整兜底参数，比如max_scrolls（最大滚动次数）、headless（是否无头模式）。

效果长什么样：你几乎感知不到切换过程，只见日志里多出一行"使用浏览器兜底采集"，下载任务继续跑，成功率大幅提升。此外，把链接换成live.douyin.com/房间号还能录制直播，配合清晰度选择，功能覆盖相当完整。

进阶排雷：新手最容易踩的 5 个坑

坑 1：Cookie 填错还硬跑把cookies: auto当摆设，或粘贴时多了引号、空格。避坑：先用cookie_extractor.py自动获取；手动粘贴时只保留key=value; key2=value2;形式，前后不要留空格。

坑 2：增量模式没开数据库increase增量去重依赖 SQLite，如果你把database: false关了，增量自然失效，下次全量重下。避坑：想用增量和去重，务必保持database: true（默认开启）。

坑 3：命名模板撞车filename_template里如果不含{id}，不同作品可能重名互相覆盖。避坑：保持默认的"{date}_{title}_{id}"格式，或者自定义时强制带上{id}。

坑 4：线程数盲目拉高个人电脑上把thread调到 20，结果 CPU 满载、请求被封。避坑：家用环境 3~5 个线程足够，服务器再考虑调高；同时配合rate_limit控制请求频率，降低被封风险。

坑 5：报错只看不搜遇到LoginRequiredError就以为工具坏了。避坑：这个报错几乎都是登录态过期，重新运行cookie_extractor.py更新 Cookie 即可；新版还支持自动检测失效并引导重新登录，跑在后台也建议开启通知配置，失败时推送消息提醒。

值得记住的三件事

最后总结三点，帮你少走弯路：

🎯入口分流：只下单个视频用最短命令快速搞定；批量采集用户主页、合集、音乐，用配置文件驱动更省心。

🔧配置即武器：thread、retry_times、rate_limit这几个参数决定了你的下载速度和存活率，根据网络环境动态调整。

🔄让它自己跑：开启increase增量 + 数据库去重后，这个工具就不再是"一次性下载器"，而是可以长期挂着的素材采集引擎，每天自动补齐新增内容。

把重复劳动交给代码，把时间留给创作。现在就去克隆仓库，从下载你的第一条无水印视频开始，体验一次"全自动搬运"的畅快。🚀

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