抖音批量下载工具实测：5分钟把整个博主主页搬回本地，无水印还支持合集与直播-平芜编程栈

抖音批量下载工具实测：5分钟把整个博主主页搬回本地，无水印还支持合集与直播

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

你有没有过这样的经历：深夜刷到一个特别对胃口的博主，想把他过去一年的作品都存下来慢慢看，结果录屏带着水印、在线解析网站把画质压成马赛克、手动一个一个保存又累到怀疑人生。如果你正被这类"想收藏却存不下来"的问题困扰，这篇文章要介绍的开源抖音批量下载工具，可能会成为你手机相册之外的第二收藏夹。

一个周五晚上的真实经历

上周五，我在抖音上发现一位做老电影解说的博主，他的合集内容横跨三年，足足两百多个作品。我当时的想法很简单：全部下载，通勤路上离线看。

于是我先试了录屏——画质勉强能看，但片头片尾的抖音Logo和水印让我瞬间没了兴致；又试了网页端解析工具，下载下来发现分辨率缩水严重，解说字幕都糊了。折腾两个小时，最终只成功存下三条视频。那种挫败感，相信每个想批量保存内容的人都懂。

后来我找到这个叫 douyin-downloader 的开源工具，情况完全不一样：不需要逐条复制链接，把一个博主主页的地址丢进去，两百多个作品在几分钟内自动落盘，无水印、原画质，连封面和原声都一起带回来了。

先弄清楚：它能做什么，不能做什么

动笔之前，先把边界讲清楚，免得你期望落空。

这个工具本质上是一个命令行程序，覆盖了抖音内容下载的几乎所有常见形态：

单条内容：视频、图文（note/gallery）、单个合集、单条音乐，直接给链接即可
批量场景：用户主页的作品、喜欢列表、合集、音乐，一键打包下载
特殊能力：直播录制、评论采集、热搜榜与关键词搜索，甚至还能以 REST API 服务模式对外提供下载能力

它不做什么？它不会帮你去除那些本就不该去除的版权边界，下载内容请仅用于个人学习、素材整理等合理用途。另外它依赖抖音的接口，接口变动时部分功能可能短暂失效，这是所有同类工具的共性，使用时平常心对待就好。

项目仓库里除了命令行版本，还有一套基于同一后端的桌面客户端 Douzy，可以粘贴链接、同步关注列表、可视化查看任务进度，目前处于内测期。命令行用户不必担心，下面的教程完全基于稳定可用的命令行版本。

五步下载你的第一条视频

整个过程比想象中简单，我按实际操作的顺序一步步讲。

第一步：把代码拿到本地

git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader

第二步：装好依赖

Python 3.8 以上环境即可，运行：

pip install -r requirements.txt

如果想用"自动获取 Cookie"或浏览器兜底功能，再多装一个 Playwright：

pip install playwright python -m playwright install chromium

这里有个容易忽略的坑：不装 Playwright 也能跑通大部分下载，但配置里的cookies: auto会失效，只能手动粘贴 Cookie。建议一步到位装好。

第三步：解决登录凭证问题

抖音的大部分内容需要登录态才能访问，Cookie 就是那把钥匙。最省事的做法是运行项目自带的脚本，它会打开浏览器让你扫码登录，登录成功后自动把 Cookie 抓取保存下来：

python cookie_extractor.py

如果你已经有现成的 Cookie，也可以直接写进配置文件，下面会提到。

第四步：填一份最简配置

cp config.example.yml config.yml

打开config.yml，核心就三块：要下载的链接、保存位置、Cookie。一个能跑的最小配置长这样：

# 支持多个链接，视频、图文或主页都可以 link: - https://v.douyin.com/你的短链/ # 保存目录 path: ./Downloaded/ # 附加资源：音乐、封面、元数据JSON music: true cover: true json: true # Cookie 三选一：auto 自动获取 / 整串字符串 / 键值对 cookies: auto

第五步：跑起来

python DouYinCommand.py

命令运行后，控制台会先解析链接、校验 Cookie，然后开始下载。第一次跑通时那种"原来可以这么简单"的感觉，值得你亲自体验一下。

把整个博主主页"搬"到本地

单条下载只是开胃菜，这个工具真正让人上瘾的是主页批量下载。

操作上没有任何额外门槛，把link换成用户主页地址即可：

link: - https://www.douyin.com/user/某位博主的sec_uid

但下载什么、下载多少，值得花十秒钟想清楚，因为它通过mode参数控制：

post：博主发布的作品，默认选项
like：博主公开的"喜欢"列表
mix：博主创建的所有合集
music：博主用过的音乐原声

比如我只想要某个创作者近半年的作品，同时把他做的合集也收进来，配置可以写成：

mode: - post - mix number: post: 100 # 作品最多取100个，0表示全部 mix: 5 # 合集最多取5个

下载时控制台会实时刷新进度，正在抓取第几个、当前速度多少、哪个文件已跳过都一目了然；文件按"日期+标题"自动建文件夹，视频、封面、原声分门别类存放，配合 JSON 元数据，找起来非常顺手。

关于线程数，默认 5 条并发是个稳妥的起点。网速一般就保持默认，宽带充裕可以调到 8~10，但别贪多——并发太高容易触发抖音的风控，反而拖慢整体速度。工具内置了重试机制（默认 3 次、指数退避），网络抖动时它会自己扛一阵子，你不用守在屏幕前。

进阶玩法：合集、原声与直播

主页批量下载跑顺之后，你会想解锁更多玩法，这三个场景我觉得最实用。

把整个合集端走

遇到那种按主题整理的精品合集，直接贴合集链接就能整体下载，断点续传也内置了——下载过的文件会跳过，不会重复劳动。如果你是做剪辑的，靠这个功能收集整套素材库，效率比手动逐条保存高出一个量级。

单独要一首原声

看到一条视频的 BGM 特别有感觉，只想把这首原声拿到手？贴音乐链接，工具会优先抓取原始音频文件，实在拿不到才回退到该音乐下第一条作品的音轨。收藏夹里的音乐也能按music模式整体拉取。

录下正在进行的直播

把直播间的链接丢进去，工具会解析出清晰度选项（比如 FULL_HD、SD）和流地址，录制过程中即使主播下播，已经录下的数据也会保留下来。注意一点：HLS 来源只保存播放列表文件，需要自己用 ffmpeg 做后处理；FLV 来源则可以直接播放，优先选 FLV 更省事。

避坑指南：我替你踩过的那些坑

实话实说，这个工具不是零门槛的魔法，几个高频问题提前告诉你，能省下不少折腾时间。

Cookie 过期是最常见的"下载失败"原因。抖音的登录态会周期性失效，症状是主页能打开但下载总是失败或只返回空数据。解法很朴素：重新跑一遍cookie_extractor.py更新 Cookie。数据库和文件双重去重机制对"重复下载"免疫，但救不了过期的 Cookie。

collect（收藏夹）模式有限制。它只支持当前登录账号自己的收藏夹，而且必须单独使用，不能和post/like混在同一个任务里。把这两条记在脑子里，能少看两页报错信息。

浏览器兜底功能不是万能的。当接口翻页受限时，工具会拉起浏览器人工过验证码，但这个兜底目前只在post模式经过完整验证，like/mix/music主要依赖 API 正常分页。遇到接口抽风，与其反复重试，不如换个时段再跑。

两个入口，按需选择。项目根目录同时存在DouYinCommand.py和downloader.py两个入口：前者定位是稳定省心，配置简单、适合新手；后者功能更全（增量下载、直播、搜索、API 服务等），但选项多，上手曲线陡一点。我的建议是：第一次接触先用前者把流程跑通，有进阶需求再切到后者，不必一上来就被一堆参数吓到。