抖音下载器终极指南：从直播回放到作者主页批量下载，一个开源工具全搞定

【免费下载链接】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 的完整上手指南就是为你准备的。

douyin-downloader 是一款完全免费、开源的抖音下载器，它把视频、图文、合集、音乐、直播回放这些零散的下载需求，统一收进了一个命令行工具里。它既能单独抓取某一条作品，也能一口气把作者主页的作品、点赞、合集、原声音乐全部拉下来，还自带去水印、最高清晰度挑选、数据库去重和浏览器兜底等实用能力。接下来，我会以一个新手的视角，带你从安装配置一路走到进阶玩法，把这款工具真正用起来。

先聊聊：那些让人头疼的抖音保存难题

抖音的内容生态很丰富，但也带来了几个"保存难题"，相信你或多或少遇到过：

• 直播"看过即焚"。知识分享、演出、赛事，直播时没赶上，结束后就真的没了，连回放入口都找不到。
• 手动下载太累。遇到喜欢的博主，几十上百条作品，靠手一个个点开、保存，既慢又容易漏。
• 水印和清晰度。网上很多保存方式带水印，或者画质被压缩，观感大打折扣。
• 文件一团乱麻。下载下来的文件命名随意，散落在各个文件夹，想找一条之前存过的视频比大海捞针还难。
• 重复劳动。隔一阵子想更新某个博主的新内容，又得把旧的重下一遍，白白浪费流量和磁盘空间。

这些痛点单独看都不算致命，但叠加在一起就很影响体验。douyin-downloader 的定位，就是把这些零散的"保存需求"统一成一个可以反复使用的自动化流程。

为什么是它：几个让人愿意长期用的理由

在同类工具里，douyin-downloader 有几点做得比较扎实：

一是免费开源，功能全。项目代码完全公开，你可以放心使用，也能自己研究实现细节（核心逻辑都在douyin-downloader/core/目录下）。单视频、图文笔记、合集、音乐、作者主页批量下载、收藏夹抓取、直播录制、评论采集、热搜榜与关键词搜索……覆盖面相当广。

二是默认就为你省事。它自带去水印机制，自动优先选择无水印的视频源；同时会读取视频的码率信息，自动挑选最高清的一档，不用你手动对比。

三是防重复机制成熟。下载记录会写入 SQLite 数据库（默认dy_downloader.db），配合本地文件双重去重，同一个作品无论通过哪种模式触发，都不会被重复下载；开启增量模式后，重跑一次只会拉取新增内容。

四是失败兜底做得好。网络抖动、接口限流都是常态，它内置了指数退避重试（1 秒、2 秒、5 秒）和下载完整性校验——文件大小对不上就自动清理重下。万一 API 翻页被限制，还可以启动浏览器兜底，配合人工过验证码继续抓取。

一句话总结：它把"下载"这件小事，打磨成了"稳定、省心、不重复"的标准流程。

三条命令，十分钟跑通第一次下载

上手真的不难，核心就三步：拿代码、做认证、开始下载。

第一步：拉取项目并装好依赖

先把项目克隆到本地：

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，又繁琐又容易出错。这个项目提供了一个自动化脚本，运行后会自动打开浏览器让你扫码登录，登录完成回到终端按一下回车，程序就把认证信息写进配置了：

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

对新手来说，这一步几乎是无感的。

第三步：发起你的第一次下载

先复制一份配置模板并稍作修改：

cp config.example.yml config.yml

然后在config.yml里填上你想下载的内容链接。最简单的配置大概长这样：

link: - https://www.douyin.com/video/1234567890123456789 path: ./Downloaded/

最后运行：

python run.py -c config.yml

看到终端里出现进度条和下载记录，你的第一个下载任务就成功了。如果想临时指定别的链接或目录，也可以直接加参数覆盖，比如python run.py -c config.yml -u "https://www.douyin.com/video/xxx" -t 8 -p ./Downloaded。

进阶玩法：把"批量下载"这件事玩出花来

跑通单条下载之后，真正体现工具价值的是批量场景。这一节讲几个高频玩法。

玩法一：一个链接，打包作者主页的四种内容

遇到宝藏博主想整站收藏？把用户主页链接放进配置，再声明要抓取的模式即可：

link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx mode: - post # 发布的作品 - like # 点赞过的作品 - mix # 合集 - music # 原声音乐 number: post: 50 like: 20

下载完成后，程序会按作者建好分类目录，作品、点赞、合集、音乐各归其位，整理起来一目了然：

Downloaded/ └── 作者昵称_sec_uid/ ├── post/ ├── like/ ├── mix/ └── music/

如果你收藏夹里存了不少好东西，也可以把链接换成/user/self?showTab=favorite_collection，配合collect/collectmix模式，把当前账号收藏的作品和合集一并抓下来。

玩法二：直播录制，错过也能完整补课

直播内容是很多人的刚需。在配置里加入直播链接，工具就会用 FLV 或 HLS 两种方式录制，主播下播、网络空闲或手动中断时，已经录下的字节都会自动保留，不会功亏一篑：

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

录好的文件会放在Downloaded/{作者}/live/目录，并附带一份直播间元数据快照，方便日后回溯。需要提醒的是，HLS 源目前只保存 playlist 文件，需要配合 ffmpeg 二次处理才能得到可播放的视频。

玩法三：评论采集与热搜搜索，素材研究两不误

想做内容分析？开启评论采集后，每个作品都会额外生成一份*_comments.json，把用户反馈结构化地保存下来：

comments: enabled: true include_replies: false max_comments: 0 # 0 表示不设上限

想快速了解抖音当前的热点？命令行直接拉热搜榜或按关键词搜索，结果会导出为 JSONL，方便后续处理：

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

玩法四：增量下载，重跑一遍只补新的

这是很多老用户最爱的一个设计。开启增量模式后，第二次运行同样的配置，只会下载数据库里没有的新作品，老内容直接跳过，既省流量又省时间：

increase: post: true like: true mix: true music: true database: true

配合时间过滤（start_time/end_time），还能把下载范围精确锁定在某段时间内发布的内容，比如"只抓今年发的"。

玩法五：文件命名和完成通知，按你的习惯来

默认的命名规则用起来很舒服，但你完全可以改成自己的风格：

filename_template: "{date}_{title}_{id}" author_dir: "nickname_uid"

下载完成想第一时间知道结果？可以接上 Bark、Telegram 或 Webhook 通知，任务结束手机就响：

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

上手前必须知道的几个坑

任何工具都有边界，提前了解能少走弯路：

为什么只下到 20 条就停了？这是抖音的翻页限制。请确认浏览器兜底功能已开启（browser_fallback.enabled: true），翻页受限时程序会自动拉起浏览器，遇到验证码手动过一下，耐心等它跑完即可。

Cookie 失效怎么处理？重新运行一次自动获取命令python -m tools.cookie_fetcher --config config.yml就好，全程不到一分钟。

下载速度不理想？先试试调高并发数（thread，默认 5，别一次拉太高容易被限流），再挑网络空闲时段跑，需要的话还可以配置proxy走代理。

收藏夹模式有哪些限制？collect/collectmix只能配合当前登录的账号使用，而且必须单独运行，不能和post/like混在一个任务里。

文件都存到哪里了？默认在配置里path指定的目录，每个作者一个独立文件夹，找不到就先去这里翻一翻。

从今天开始，搭建属于你的抖音内容库

看到这里，相信你已经对 douyin-downloader 有了完整的认识：它用一套简洁的配置，把单条保存、批量抓取、直播录制、评论分析和增量更新这些需求统一了起来，省下的是反复手动操作的碎片时间，换来的是一个干净、可检索的个人内容库。

如果你正需要一个趁手的抖音下载工具，现在就可以动手：

1. 克隆项目，装好依赖；
2. 用自动化脚本完成认证；
3. 从一条视频开始，跑通你的第一个下载任务；
4. 再逐步加上批量、增量、直播这些高级玩法。

最后想认真提醒一句：工具是为了方便个人学习、整理和备份，请遵守平台的使用规则，尊重创作者的版权，不要将下载内容用于商业用途或二次传播。把好东西用在正道上，科技才能真正为你带来便利。🚀

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