抖音下载器还能这么用？把喜欢的视频、合集和直播回放一次搬回家

抖音下载器还能这么用？把喜欢的视频、合集和直播回放一次搬回家

【免费下载链接】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（抖音下载器）就是一个能帮你把抖音内容"搬回家"的开源工具：视频、图集、合集、音乐原声、直播回放，甚至收藏夹，都可以批量下载到本地，并且自动去水印、去重、断点续传。

它到底是做什么的？一句话：你把抖音链接丢给它，它把对应的内容原样下载到你电脑里。就像搬家时请的搬运工——你指指哪个柜子，它负责完整无损地搬到新家，还会按房间帮你摆好。至于"柜子"放在哪、怎么命名、要不要把重复的家具扔掉，都可以在配置文件里说了算。

从零开始：跟着走一遍就装上

把仓库克隆到本地，进入目录后安装依赖：

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

接下来需要一份配置文件。项目提供了模板，直接复制一份：

cp config.example.yml config.yml

然后做一次登录认证。抖音的部分内容需要登录态，工具内置了扫码登录脚本，运行后终端会显示二维码，用抖音 App 扫一下、按回车，Cookie 会自动写进配置：

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

到这里准备工作就完成了。相比折腾浏览器插件或者在线解析网站，这套流程把"登录"做成了扫码一步到位，对新手友好得多。

第一次下载：一条链接就够了

在 config.yml 里，把想下载的内容链接填进link，再告诉它保存到哪里：

link: - https://www.douyin.com/video/7604129988555574538 path: ./抖音内容库/ thread: 5 retry_times: 3

然后运行：

python run.py -c config.yml

看命令行输出就知道发生了什么：工具先解析链接拿到无水印视频源，再以默认 5 个并发线程下载，实时显示进度条。下载过程中它还会顺手做两件小事：一是用 SQLite 数据库记录历史，下次遇到同一文件直接跳过；二是下载完做完整性校验，发现文件不完整就自动清理重试。这些都集中在storage/file_manager.py里实现，你不需要懂细节，只要知道"重复的不会再来一遍、坏掉的会重下"就够了。

视频、图集、合集、音乐原声都走同一条路，把链接换成/note/xxx、/collection/xxx、/music/xxx即可。短链也支持，直接把抖音分享出来的v.douyin.com链接丢进去，工具会自动解析出真实地址。

批量下载：把整个主页搬回家

单条下载只是开胃菜，这个工具真正好用的是批量场景——比如你关注了一位教程博主，想把 ta 的历史作品全保存下来。把链接换成用户主页，再加一个mode参数指定要下载哪部分内容：

link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx path: ./抖音内容库/ mode: - post # 发布的作品 # - like # 点赞过的内容 # - mix # 合集 # - music # 用过的音乐 # - collect # 收藏夹

core/user_modes/目录对应了每种模式的实现：post 下载用户发布的所有作品，like 抓取点赞列表，mix 处理合集，music 收集原声，collect 针对登录账号的收藏夹。配合number参数还能限制条数，比如只取最近 100 条。

批量下载的画面很有满足感，进度条一个接一个刷满：

下载完打开保存目录，文件已经按日期自动排好：

直播回放：错过也能补上

直播内容最怕错过就没了。工具对live.douyin.com的直播间链接做了专门支持，进入后会自动识别直播间信息，列出可用的清晰度（比如 FULL_HD、SD1、SD2），按需选择一个开始录制。FLV 格式录完即可直接播放；即使主播中途下播，已录制部分也会保留下来，不会白录：

如果你是命令行用不惯，项目还提供了一个桌面版客户端（Douzy），粘贴链接、选内容类型、点下载，全程不用敲命令：

进阶玩法：把下载调教成想要的样子

用顺手之后，可以慢慢调参数获得更好的体验：

# 只下载某个时间段的内容 start_time: "2024-01-01" end_time: "2024-12-31" # 并发和重试：网速快就调高，不稳定就调低 thread: 8 retry_times: 5 # 省空间：不要音乐和封面 music: false cover: false json: false

还有几个隐藏能力值得一试：--search "关键词"可以按关键词搜索作品并导出结果；--hot-board能拉取抖音热搜榜；下载完成后还能通过 Bark、Telegram 或 Webhook 推送完成通知，适合挂机批量下载时"完事了提醒我"。

当 API 接口限制翻页时，工具会自动切换到浏览器兜底模式（browser_fallback.enabled: true），用真实浏览器滚动页面继续抓取，遇到验证码还会留出人工处理的窗口。这一手对"某天接口抽风"的情况非常实用。

高频问题：踩过坑的人都在问

Q：运行时报需要登录 / Cookie 失效怎么办？A：抖音的登录态有时效，重新跑一次扫码即可：

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

Q：下载速度慢，怎么提速？A：先看网络情况。网速好的话把thread调到 8~10；如果在海外，可以配一个代理proxy: "http://127.0.0.1:7890"，通常立竿见影。

Q：某些主页作品总有几个下不下来？A：大概率是翻页被限制。确认browser_fallback.enabled: true且安装了浏览器内核（先pip install playwright，再python -m playwright install chromium），让工具走浏览器兜底。

Q：硬盘不够用怎么办？A：把music、cover、json都关掉，只留视频本体；再配合数据库去重，避免重复文件反复占空间。

最后说两句

从一个"收藏即拥有"的执念开始，到把整个博主主页、直播回放都安稳存进本地，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