抖音批量下载实用指南：开源工具 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 这个开源工具想解决的问题——把抖音批量下载、去水印、整理归档，压缩成一条命令的事。

它不是一个只会"下载"的脚本。视频、图文、合集、音乐、收藏夹都能处理，作者主页可以一次拉全，下载记录落在 SQLite 里，翻页被风控时还能自动唤起浏览器兜底。下面按我第一次上手时的真实路径，把它怎么用、用在哪里、边界在哪，一次说清楚。

第一次跑通，先别急着谈批量

环境依赖其实只有两步

项目要求 Python 3.8 以上，依赖安装很简单：

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

如果你打算启用"浏览器兜底"或自动获取 Cookie，再多装一个 Playwright 和浏览器内核：

pip install playwright python -m playwright install chromium

把 Cookie 交给工具，而不是自己抄

Cookie 是访问抖音数据接口的"门票"，也是很多同类工具最容易劝退人的一步。这个项目提供了自动获取方式：

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

命令执行后会弹出浏览器，你登录一次抖音，回到终端按回车，程序就把 Cookie 字段自动写进配置了。相比从开发者工具里手工复制一串长字符串，这条路省心得多——而且以后 Cookie 失效，重跑这条命令即可。

先下载一条视频，验证整条链路

批量之前，我强烈建议先拿一条视频跑通全流程。最小配置长这样：

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

运行：

python run.py -c config.yml

第一次跑通时你会注意到几件小事：工具默认挑选无水印且码率最高的视频源，下载完成后在同一目录里留下了封面图、原声音乐、作者头像，还有一份 JSON 格式的完整元数据。这一步的意义是验证配置无误，别急着把链接列表填满——后面批量时你只会改动其中几行。

批量这一步，决定这个工具值不值得留

一个作者主页，四种下载模式

把链接换成作者主页，模式就能自由组合。post是发布作品，like是点赞内容，mix是合集，music是原声文件：

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

number里的数字是每个模式的上限，0 表示全量拉取。四种模式可以同时开，不同模式之间会按作品 ID 自动去重，同一个视频不会因为你既下了作品又下了合集而重复下载。

不会重复下载：数据库与文件的双重检查

项目用 SQLite 记录每一条下载历史，同时扫描本地文件名里的作品 ID 做二次校验。两层都命中才会跳过，所以中断后重跑不会重下已完成的文件。真正好用的是增量模式：

increase: post: true database: true

开启后，每次只补下载作者新增的作品，适合长期跟进某个博主的场景。博主今天发一条，你明天跑一次，几秒钟就收工。

并发、重试与限速，交给配置而不是脚本

批量下载最怕的是"下到一半挂掉"和"太快被平台盯上"。项目把这两件事都做成了配置项：thread控制并发数（默认 5），retry_times控制失败重试次数（按 1 秒、2 秒、5 秒指数退避），内置的速率限制默认每秒 2 个请求，下载完整性校验发现文件不完整时会自动清理并重试。你不需要自己写任何调度逻辑。

下载完不是终点，产出物的管理才是

命名与目录，从第一天就定好

批量下载最容易失控的是文件命名。项目支持模板化命名，常用变量有日期、标题、作者、ID 等：

filename_template: "{date}_{title}_{id}" folder_template: "{date}_{title}_{id}" author_dir: "nickname_uid" folderstyle: true

作者目录支持三种策略：nickname直观但重名会合并，sec_uid稳定唯一但不直观，nickname_uid两者兼顾，重度使用者推荐。文件名的日期前缀取自作品本身的发布时间，而不是下载时间，归档后按时间检索非常顺手。

附带产出：评论、转写与完成通知

下载只是起点，这个工具的"附加产出"更值得说：

评论采集：开启后每个作品会额外生成一份评论 JSON，可以拉取二级回复，适合做舆情或内容分析；
视频转写：可选接入 OpenAI Transcriptions API，为视频生成文字稿，音频素材直接变成可检索的文本；
完成通知：下载结束推送到 Bark、Telegram 或 Webhook，长任务跑完不用一直盯着终端。

想接入自己的系统：REST API 服务模式

项目可以不以命令行方式运行，而是作为一个后台服务：

pip install fastapi uvicorn python run.py --serve --serve-port 8000

启动后通过POST /api/v1/download提交链接，返回任务 ID，再轮询/api/v1/jobs/{job_id}查询状态。把下载能力封装成接口，等于给团队或自己的其他工具预留了集成点。

顺手还能抓热搜榜和关键词

两个附加命令对内容选题特别有用，结果会导出成 JSONL：

python run.py --hot-board 30 -p ./Downloaded python run.py --search "猫咪" --search-max 100 -p ./Downloaded

前者拉当前热搜榜，后者按关键词搜索作品，适合做素材收集和趋势观察。

使用之前，先看清它的边界

如实说，这个工具有几个已知限制，提前知道能少走弯路：

浏览器兜底目前只对post模式做了完整验证，like、mix、music主要依赖接口正常分页；
收藏夹模式（collect/collectmix）只能单独使用，不能和post等模式混跑，且只支持当前登录账号的内容；
翻页风控：只抓到 20 条作品时，通常是触发了翻页限制，需要开启browser_fallback并在弹出的浏览器里手动完成验证，不要急着关窗口；
直播录制标注为实验性，HLS 源只保存播放列表文件，需要 ffmpeg 自行后处理。

另外必须提醒的是合规问题。这类工具的正确用法是管理自己的内容、备份自己有权使用的素材、用于学习研究；不要用于搬运他人版权内容或任何商业侵权用途。接口策略随时可能调整，功能失效属于正常技术风险，请把"尊重平台规则"当作使用前提。

想要图形界面？同源桌面版 Douzy

如果你不习惯命令行，项目还提供了一个基于同一套后端开发的桌面客户端 Douzy（内测中）：粘贴链接即可开始下载，支持同步关注列表、可视化任务管理，还能在作品档案里按条件筛选历史记录。命令行负责深度和自动化，桌面版负责直观，底层逻辑完全一致，数据也可以共用。

你可以从这里开始

一个相对顺手的上手路径是这样的：

克隆项目，安装依赖和 Playwright；
用cookie_fetcher自动获取一次 Cookie；
拿一条视频链接跑通最小配置；
换成作者主页，打开需要的模式和增量开关；
按需启用评论、转写或通知，让工具替你盯着后续。

工具能替你省下的是重复劳动，需要你自己把握的是用它的方式和边界。把繁琐的下载、命名、归档交给 douyin-downloader，把时间留给你真正想做的事——这就是它最大的价值。

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

企业官网建设流程全解析