抖音批量下载终极指南：从0到1搭建你的视频采集流水线

抖音批量下载终极指南：从0到1搭建你的视频采集流水线

【免费下载链接】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 去重与浏览器兜底。接下来，我将带你从零开始，把它打造成属于你自己的"视频采集流水线"。

先看效果：一次配置，持续解放双手

用一句话概括 douyin-downloader 的定位：它像一条自动分拣流水线，你只需把链接丢进入口，它会自己完成解析、去水印、挑选最高清、归档命名、去重记录这一整条链路，最终把整整齐齐的作品目录交到你手上。

图：下载完成后自动生成的目录结构，每个作品独立成文件夹，日期前缀便于按发布时间检索

它的核心能力可以从这张速览表中看出：

能力	说明
单条下载	视频/video/{id}、图文/note/{id}、合集/collection/{id}、音乐/music/{id}
主页批量	支持post（作品）/like（点赞）/mix（合集）/music（音乐）四种模式
画质与去水印	自动挑选无水印源，并按码率数组自动选最高清
断点保护	失败指数退避重试（1s、2s、5s），并发数与限速均可调
防重复	SQLite 数据库 + 本地文件双重去重，支持增量下载
进阶能力	直播录制、评论采集、热搜榜、关键词搜索、REST API、完成通知

新手路径：5分钟跑通你的第一个下载任务

对于只想"下载几条视频"的普通用户，整个过程只需要三步。

第一步：获取项目并安装依赖

确保本机有 Python 3.8 或更高版本，然后执行：

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

第二步：准备配置与 Cookie

复制一份示例配置作为你的工作配置：

cp config.example.yml config.yml

接下来是唯一需要一点耐心的环节——获取 Cookie。推荐用项目自带的自动获取工具，它会打开浏览器让你登录抖音，登录完成后回到终端按 Enter，程序会自动把 Cookie 写入配置：

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

小提示：Cookie 是访问抖音接口的"通行证"。如果你只需要下载很少的公开作品，可以先用上面的方式获取一次；当遇到接口报错或翻页受限时，重新执行这条命令刷新 Cookie 即可。

第三步：填入链接，一键运行

编辑config.yml，把link换成你想下载的内容，然后运行：

python run.py -c config.yml

比如下载单个视频，配置可以精简成这样：

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

图：命令行实时展示下载配置、逐项进度与最终统计，成功/失败一目了然

不想改配置文件？也可以直接在命令行追加参数，效果等价：

python run.py -c config.yml \ -u "https://www.douyin.com/video/7604129988555574538" \ -t 8 \ -p ./Downloaded

到这里，你的第一条视频已经下载成功了。

高手路径：把作者主页变成你的素材库

如果说单条下载只是开胃菜，那么作者主页批量下载才是 douyin-downloader 真正的主菜。很多剪辑号、素材号使用者每天的工作就是抓取若干博主的作品，用这个功能能省下 90% 的重复操作。

四种模式自由切换

在配置里指定作者主页链接，再用mode选择要抓的内容：

link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx mode: - post # 博主发布的作品 - like # 博主点赞过的作品 - mix # 博主创建的合集 - music # 博主用过的原声音乐 number: post: 50 # 作品拉取 50 条，0 表示全量 like: 0 mix: 0 music: 0

四种模式可以同时开启，而且跨模式自动去重——同一个作品 ID 不会在不同模式下被重复下载，避免你的硬盘被同一份文件塞满。

图：批量下载时每个作品独立进度条，100% 完成即落盘归档

用增量与时间过滤实现"追更"

如果只想下载某个博主最近发布的新作品，开启增量模式即可，工具会依据数据库记录自动跳过已下载内容：

increase: post: true database: true # 增量模式依赖数据库记录

如果只想保留某个时间段的素材，用时间过滤：

start_time: "2025-01-01" end_time: "2025-12-31"

性能调优参数对照

根据设备性能，可以按这张表调整参数：

参数	作用	入门配置	高性能配置
thread	并发下载数	2-4	8-16
retry_times	失败重试次数	3	5
number.post	单次拉取上限	20	0（全量）
progress.quiet_logs	进度静默模式	true	true

隐藏技能：直播、评论、热搜、通知一站搞定

当你熟悉了基础与批量下载之后，douyin-downloader 还藏着不少能让你眼前一亮的高级玩法。

直播录制：主播下播也不怕

支持对直播房间进行录制，选择清晰度后生成下载链接，主播下播或网络中断时已录制的数据会被完整保留：

link: - https://live.douyin.com/123456789 live: max_duration_seconds: 0 # 0 表示录到主播下播 idle_timeout_seconds: 30

图：直播录制功能会解析直播间并让用户选择清晰度，录制结果自动保存

评论采集：为分析提供一手数据

开启评论采集后，每个作品会额外生成一份*_comments.json，支持二级回复，适合做舆情分析与内容调研：

comments: enabled: true include_replies: false max_comments: 500

热搜榜与关键词搜索

两条命令即可导出抖音热搜榜快照或关键词搜索结果，落盘为 JSONL 文件，方便后续做数据分析：

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

下载完成通知：不用一直盯着终端

支持 Bark / Telegram / Webhook 推送，下载完成或失败时第一时间通知你，适合跑大批量任务时"人走开、任务继续"的场景：

notifications: enabled: true on_success: true on_failure: true providers: - type: bark url: https://api.day.app/YOUR_DEVICE_KEY

REST API：把下载能力接进你自己的系统

如果你懂一点后端，还可以用--serve --serve-port 8000把工具跑成服务，通过 HTTP 接口提交下载任务、查询任务状态，方便接入自己的自动化工作流：

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

避坑指南：四个高频问题一次说清

根据社区使用反馈，新手最常遇到的四个问题及解法如下：

1. 只能抓到 20 条作品？这是翻页风控的典型现象。确保browser_fallback.enabled: true且headless: false，浏览器弹窗出现后手动完成验证，不要立刻关掉窗口。
2. Cookie 失效了？重新执行python -m tools.cookie_fetcher --config config.yml刷新即可。
3. 进度条疯狂刷屏？保持progress.quiet_logs: true，调试时再临时加-v查看详细日志。
4. 想重新下载某条作品？程序通过"数据库记录 + 本地文件"双重判断去重，需要同时删除对应本地文件夹与数据库记录，具体命令可参考项目 README 的"重新下载"章节。

重要提醒：本项目仅用于技术研究、学习交流与个人数据管理，请在合法合规的前提下使用，尊重原创作者的版权与平台规则。

从今天开始，把时间还给创作

技术工具的意义，从来不是让你变得更忙碌，而是把重复劳动交给机器，让你把精力留给真正有价值的事。用 douyin-downloader 搭建起你的视频采集流水线之后，不妨用下面这份清单自测一下：

• 一条链接从粘贴到落盘，是否在几分钟内完成？
• 博主主页的上百条作品，是否一次命令全部归档？
• 重复下载是否被自动拦截，硬盘不再塞满冗余文件？
• 直播、评论、热搜这些进阶能力，是否已经用上？

如果答案都是"是"，恭喜你，你已经从"手动搬运工"升级成了"流水线调度员"。现在就动手 clone 项目，跑通你的第一个下载任务吧——你会发现，效率倍增的感觉，真的很上瘾。⚡

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