抖音采集不再靠手动：一个能去重、能排队、还能自动续命 Cookie 的开源工具

【免费下载链接】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 就是为治这种"病"而生的开源工具——它把抖音批量下载压缩成"复制链接、回车、收工"三连，单视频、用户主页、合集、音乐、直播，一律支持无水印保存。

先认清三个坑，才知道它到底解决了什么

在动手之前，先明白抖音采集为什么这么难：

坑一：接口隔三差五就变。抖音的签名校验（X-Bogus、msToken 那套）升级频繁，网上很多"一键脚本"用两天就失效，本质是单点方案扛不住变化。

坑二：重复下载是最大的浪费。用户主页隔几天抓一次，同样的视频反复下，磁盘和带宽一起白烧。

坑三：登录态说没就没。抓点赞、私密合集必须带 Cookie，而 Cookie 通常几小时到几天就过期，手动去浏览器翻新是最劝退的环节。

douyin-downloader 的思路是不赌单点，用一套组合拳把这几个坑全部填平。

五分钟跑通第一次下载

先别研究原理，把第一个视频下下来再说：

pip install -r requirements.txt python cookie_extractor.py # 首次获取登录态 python downloader.py -u "https://v.douyin.com/xxxx/" --auto-cookie

白话解释：三行命令完成"装依赖、取登录态、解析并下载"，成功后本地会多出一个按日期命名的无水印高清文件。第一次跑通你会立刻发现两个细节：视频不带水印，文件名是"日期+标题"的语义化格式，找素材再也不用靠记忆翻文件夹。

批量采集的正确姿势：把手工活变成配置活

单视频只是开胃菜，抖音用户主页批量采集才是重头戏。项目给了两条路：命令行直连，把主页链接丢给-u、用-t指定线程数，几十个作品自动排队；或者走配置文件驱动，把采集规则写进config.yml，想看作品、点赞、合集还是音乐，改一行mode就行。

下面是一份真实配置的核心片段，注意increase这个字段：

mode: [post, like] number: { post: 50, like: 30 } increase: post: true # 只下新增，历史已下过的自动跳过 retry_times: 3

白话解释：increase: true相当于给下载任务装上记忆，上次下到哪、这次就从哪接着来，配合 SQLite 里的下载历史，重复文件直接拦下。

下载过程长什么样？下图是真实跑批量任务时的界面，每个资源的进度和"跳过已存在"的去重标记都清清楚楚。

正在排队下载用户主页作品，进度、线程、去重状态一目了然

如果抓的是合集，工具会先拉取合集下全部作品清单再逐个下载，大批量时进度条会像下图的绿色长龙一样刷屏：

合集作品并行下载中，失败项会在收尾时自动重试

快问快答：新手最容易卡住的四个问题

与其翻文档，不如直接回答几个高频疑问：

Q：下载的视频到底带不带水印？A：不带。解析阶段会自动剥离水印，保留平台原始清晰度，这正是抖音视频去水印下载的核心能力。

Q：下到一半断网，是不是要重新来？A：不用。重试加断点续传会在下次运行时接着干，retry_times默认 3 次，可自行调大。

Q：用户主页几百个作品，会把机器下吐吗？A：线程数可调，个人电脑给 2~3，服务器给 8，配合限速参数就能在速度和风控之间找到平衡。

Q：Cookie 失效了怎么办？A：这是最容易踩的坑，也是项目做得最细的地方，下面单独说。

原理拆解：它凭什么能"一直能用"

策略模式，接口挂了自动换路。项目把下载逻辑抽象成多套策略，API 通道失效就自动降级到浏览器模拟，重试策略还会按指数退避等待。核心骨架只有三行：

class APIStrategy(IDownloadStrategy): ... class BrowserStrategy(IDownloadStrategy): ... class RetryStrategy(IDownloadStrategy): ...

白话解释：三种策略实现同一个接口，运行时按接口状态动态切换，就像导航发现主路拥堵会自动换备选路线，成功率因此能长期稳住。

Cookie 管理，登录态自己续命。项目内置过期检测与自动刷新：检测到 Cookie 失效，自动触发浏览器重新登录并取回新凭证，把"抖音Cookie登录失效"这个老大难问题降到最低。想深挖实现的同学，可以从apiproxy/douyin/auth/目录顺着读。

SQLite 去重，给下载装上长期记忆。每次下载的 video_id 都会写进本地数据库，下次遇到相同 ID 直接跳过，重复抓取从此变成纯增量同步；下载历史的查询与筛选也都基于这张表，config.yml里的database: true控制它的开关。

从个人工具到团队流水线

采集规模上来以后，这套工具还能再进一步：配合系统定时任务，每天自动抓取指定账号的新作品，素材库保持"常看常新"；项目还自带轻量 REST 服务，--serve启动后就能把下载能力暴露成接口，供内部系统或自动化平台调用；连直播也能接，命令行里选好清晰度即可录屏存档。

直播流解析出多档清晰度，选号即可开始录制

下载回来的内容会自动按"日期+标题"分目录归档，长期下来就是一套规整的个人素材库：

下载完成的文件自动归档，语义化命名让检索不再依赖记忆

从手工搬运，到自动采集

说到底，douyin-downloader 解决的不只是"下载"这个动作，而是把"采集—去重—归档"整条链路变成可配置、可重复、可自动化的流水线。对个人创作者，它省下的是每天几小时的机械劳动；对团队，它把竞品监控、选题调研变成每天定时跑一遍的例行任务。

记住三个关键实践：🎯先配好 Cookie 再谈批量：登录态是一切的基础，优先用自动获取或浏览器导出的真实 Cookie 🔧增量模式务必打开：increase: true配合数据库去重，重复采集从此零成本 🔄按场景调线程数：个人机器 2~3 线程，服务器再上 8，速度和风控两头都要顾

现在就去git clone https://gitcode.com/GitHub_Trending/do/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