抖音批量下载工具完整教程（30分钟上手）-三亩地-编程学习日记

抖音批量下载工具完整教程（30分钟上手）

【免费下载链接】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 数据库自动去重。这篇文章按一次完整的上手旅程来写——装环境、拿 Cookie、跑通第一条链接，再解锁批量下载、增量维护、直播录制等进阶玩法，每一步都会讲清"为什么这么做、做完能看到什么"。

一、你可能会遇到的三个"保存难题"

先说实话：短视频平台并没有提供"一键存到本地"的按钮。想收藏内容的人通常只有三条路——网页录屏（糊且麻烦）、在线解析站（要扫码、限速、还怕弹广告）、自己写脚本（门槛太高）。如果你只是想稳定、批量地把喜欢的内容留在本地，那比起每次现找现用，一个配置好就能长期复用的工具要省心得多。

这就是 douyin-downloader 存在的理由：一套配置，长期使用。它不靠网页爬虫硬刚，而是走抖音官方接口，拿到无水印、尽可能高清晰的视频源，下载完自动按"日期+标题+ID"整理成文件夹。接下来就按流程走一遍。

二、准备阶段：三件事，十分钟

1. 把代码拉回本地

git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader/douyin-downloader # 进入 V2.0 主程序目录 pip install -r requirements.txt

这三行分别在做：从 GitCode 拉取项目 → 进入主程序目录 → 安装运行所需的全部依赖。装完先放着，后面的每条命令都用这套环境。

2. 🔑 配置 Cookie：访问抖音接口的"身份证"

抖音接口要求请求携带登录态，Cookie 就是这把钥匙。项目提供了自动获取方式，推荐第一次用它：

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

这条命令会弹出浏览器带你登录抖音，登录完成后回到终端按一下回车，Cookie 就被自动写进配置了，全程不用手动复制。如果你习惯手动方式也行：在浏览器里登录抖音，打开开发者工具复制 Cookie 字段，填进配置文件的cookies段即可。

3. 生成一份自己的配置

cp config.example.yml config.yml

配置文件是后续所有操作的"总控台"，最常用的是这几个字段：

link：要下载的链接列表
mode：下载模式（post 作品 / like 点赞 / mix 合集 / music 音乐）
path：文件保存目录
thread：并发下载数，默认 5

三、🎯 第一次下载：一条链接换回一个完整文件夹

环境就绪后，先拿单个作品练手。把下面的链接换成你想保存的那个视频或图集：

python run.py -c config.yml -u "https://www.douyin.com/video/示例作品ID"

-c指定刚才生成的配置文件；-u表示追加一条待下载链接，可以重复出现（一次传 3 条链接就传 3 次-u）。命令跑起来后，终端会显示实时进度：正在解析链接、并发拉取文件、逐条统计成功与跳过情况，全程不用盯着代码，看进度条就够了。

下载完成后，去path指向的目录看一眼：每个作品一个文件夹，名字是"发布日期_作品标题_作品ID"，里面躺着视频本体、封面图、背景音乐，以及一份完整的 JSON 元数据（发布时间、作者信息等）。也就是说，一次下载带回了作品的全部周边，后续整理、检索都不缺资料。

四、📦 批量任务：把一位博主的整个主页搬回家

单条链接只是开胃菜。这个工具真正高频的场景是：喜欢的博主更新勤快，或者担心账号哪天删作品，想一次性把主页内容全部留档。这时建议用配置文件而不是命令行：

link: - https://www.douyin.com/user/MS4wLjABAAAA你的sec_uid mode: - post - like - mix - music number: post: 0 # 0 表示不限数量，全量下载 like: 0 mix: 0 music: 0 thread: 8 path: ./Downloaded

解释一下这些配置在做什么：link填博主主页地址；mode决定抓取哪些内容——发布过的作品、点赞过的作品、参与过的合集、使用过的原声；number控制每个模式最多下载多少条，写 0 就是"有多少要多少"；thread是并发数，网络好可以调到 8~10，带宽紧张就降回 3~5。

跑起来之后，终端会连续刷出批量下载进度条，每个文件的保存状态一目了然（见下图）。如果中途断网或某个文件失败，项目自带指数退避重试（1 秒、2 秒、5 秒递增），不完整的文件会被检测出来自动清理并重下，不用你全程盯着。

五、下载之后：文件如何长成"整齐的样子"

批量任务动辄几十上百个作品，如果文件名是乱码，等于白下。这个工具用两套机制把结果整理好：

目录与命名：默认按"作者名 / 模式 / 日期_标题_ID"分层存放，日期取的是作品发布时间而不是下载时间，方便按时间线回顾。同一作品还会顺带保存封面、音乐、头像与元数据 JSON。

去重与增量：保持database: true（默认开启），每个作品的 ID 会写进 SQLite 数据库；再次运行相同任务时，已存在的文件会显示"跳过已存在"，不会重复占用磁盘。长期追更的用户再叠加一行配置：

increase: post: true

从此每次只下载"新增的作品"，第二次运行就相当于一次轻量同步，之前下过的全部自动跳过。下图是典型的下载结果目录：文件夹按时间排列、命名可读、视频缩略图直接可见，想找任何一个历史作品都是秒级定位。

六、⚡ 三个进阶玩法：直播、评论、通知

录下一场直播

在配置里把链接换成直播间地址，并启用 live 段：

link: - https://live.douyin.com/273940655995 live: max_duration_seconds: 0 # 0 = 录到主播下播

运行后工具会解析出直播间信息，并给出可选清晰度（FULL_HD 高清、SD 流畅），选定后开始录制 FLV 流；主播下播或中途 Ctrl+C 时，已经录到的部分会自动保留为正式文件，不会因为中断而白录。

顺手采集评论

做内容分析的人会用上评论采集：在配置里开启comments.enabled，每次下载作品时会同步抓取评论（可选二级回复），以独立的*_comments.json文件保存在作品旁，方便后续做文本分析。

下载完成自动通知

批量任务可能跑很久，不用干等。在配置里填一个 Bark / Telegram / Webhook 地址，任务结束（成功或失败）后会自动推送一条消息。你可以先去忙别的，回来收结果就行。

七、❓ 读者最常问的 5 个问题

1. 下载速度很慢，怎么提上去？先看网络，再调thread。带宽好就逐步升到 10 左右；速度上不去还频繁失败，就降回 3~5，并避开晚间高峰。记住一个原则：稳定优先于速度。

2. 任务总是失败，是被平台限制了吗？大概率是 Cookie 失效或链接过期。先重新跑一次python -m tools.cookie_fetcher --config config.yml刷新身份凭证，再确认链接在浏览器里能正常打开。工具默认每秒最多 2 个请求，这本身就是为降低触发限制设计的。

3. 重复下载会浪费空间吗？不会。保持database: true，同一作品第二次会被自动跳过；想长期追更某个博主，再加上increase.post: true，以后每次只补新增。

4. 下载时弹出浏览器和验证码怎么办？这是浏览器兜底机制在工作——接口翻页受限时，工具会启动真实浏览器，给你留出人工过验证码的时间。只要在窗口里完成验证，它会自动继续任务，不用重跑。

5. 直播录制太占空间，怎么控制？用live.max_duration_seconds设上限（比如 3600 表示录 1 小时），或提前确认保存目录的剩余空间。录完的 FLV 可以直接播放，想压缩体积再用转码工具处理即可。

收个尾

从第一条链接到整个主页的备份，douyin-downloader 把"保存喜欢的内容"拆成了安装、配置、下载三步，之后便是长期复用的日常：增量同步新作品、录制感兴趣的主播、下载完成自动通知。下一次刷到舍不得删的作品时，不用再纠结"以后会不会找不回来"——拉一条命令，它就已经安安静静躺在你的硬盘里了。

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

日记详情

抖音批量下载工具完整教程（30分钟上手）