抖音批量下载工具 douyin-downloader：3 步跑通批量下载，附增量更新与避坑指南

抖音批量下载工具 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（抖音批量下载工具）就是干这个的：粘贴链接，自动把用户主页、合集、音乐批量下成无水印文件，带进度展示、失败重试和重复下载检测。

先看能力边界：douyin-downloader 能批量下载什么

它不做什么，先说清楚：收藏夹模式（collect / collectmix）只支持当前登录 Cookie 对应的账号，且必须单独使用；like / mix / music 模式主要依赖接口正常翻页，遇到限制时只有 post 有浏览器兜底。下载内容请限定在个人收藏用途。

最短上手路径：3 步完成抖音批量下载第一次运行

第 1 步：装好运行环境

目标是拿到代码并装依赖。完成后目录里应有DouYinCommand.py、downloader.py等文件：

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

第 2 步：一键获取凭证 Cookie

Cookie 是抖音服务端发的"通行证"，没有它，工具连作品列表都读不到。跑一条命令，浏览器弹出后正常登录抖音即可：

python cookie_extractor.py

判断标准：登录完成后终端提示 Cookie 写入成功。不方便走自动流程的话，也可以用get_cookies_manual.py手动粘贴 Cookie。

第 3 步：把链接填进配置，第一次下载

把要下载的视频或主页链接粘贴到link字段，然后运行 V1 稳定版：

cp config.example.yml config.yml python DouYinCommand.py

判断标准：当前目录出现Downloaded/文件夹，终端打印下载统计（成功数、用时、保存位置）。想直接下载整个用户主页，可以用 V2 增强版：python downloader.py -u "https://www.douyin.com/user/xxxxx"，加--auto-cookie还能顺带自动取 Cookie。

按需调优：时间筛选、增量更新、选择性下载

只取某个时间段的作品

解决"合集里只想要去年那一季"的问题。link填主页地址，再限定日期范围：

start_time: "2024-06-01" end_time: "2024-08-31"

重复运行不重复下载

解决"每周都想同步一次这个博主"的问题。开启数据库记录和增量开关，已下载过的条目会自动跳过：

increase: post: true database: true

注意本地那个 SQLite 数据库文件别删，去重信息就存在里面。

只要视频，不要附加文件

解决"磁盘不够用"的问题。三个开关关掉，磁盘里就只有视频本身：

music: false cover: false json: false

🎬 另外，link填https://live.douyin.com/房间号时会自动进入直播录制，配live.max_duration_seconds: 3600可以限制最长录制时长。

避坑指南：抖音批量下载常见问题与解法

⚠️ 以下四个问题出现频率最高，都按"现象 → 原因 → 解法"给你拆开。

1. 只下前 20 条就停了原因：接口翻页触发了平台限制。解法：开启浏览器兜底（browser_fallback.enabled: true），在弹出的浏览器窗口里手动过一次验证码，工具会接着往下抓。

2. 下载慢或大量失败原因：并发太高被限流，或网络不稳。解法：把thread: 5降到 3 左右；网络受限就配proxy: "http://127.0.0.1:7890"。

3. 提示 Cookie 失效或无权限原因：Cookie 有时效，过期后接口直接拒。解法：重新跑一次python cookie_extractor.py刷新即可。

4. 第二次运行又在重复下载原因：去重没生效。解法：确认database: true，且保留上次的本地数据库文件；首次运行没有记录属正常，第二次起才会跳过已存在的。

设计思路与使用边界

项目按职责拆成几块：URL 解析（core/url_parser.py）负责识别链接类型，下载工厂（core/downloader_factory.py）负责调度，storage/下的文件管理与数据库模块负责落盘和去重，改哪块看路径就知道去哪找。可靠性上走的是双保险：接口优先、浏览器兜底；失败按指数退避重试（1s / 2s / 5s），下载完还会比对 Content-Length，发现文件不完整自动清理重下。

边界也说清楚：只用于个人学习收藏，不要拿下载内容做二次传播或商业用途；Cookie 等同登录凭证，含 Cookie 的配置文件不要外传；批量跑的时候适当压低并发，别对平台造成压力。

从一条链接开始

把链接贴进config.yml跑一遍python DouYinCommand.py，第一次批量下载就跑通了；更多参数（命名模板、并发、通知推送等）可以直接看USAGE.md和douyin-downloader/config.example.yml里的注释。🖥️ 不想碰命令行的话，同仓库还基于同一套后端做了桌面客户端 Douzy，粘链接、看进度都在图形界面里完成，截图在douyin-downloader/img/desktop/目录。🎯

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