一次把收藏搬回家：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 这个开源批量下载工具从第一行命令到把整个主页作品和回放存进本地前后不到一个下午。这篇文章就记录这次完整的上手过程包括踩过的坑希望能帮你少走弯路。我为什么开始找下载工具事情的起因很具体。一位讲摄影技巧的博主半年发了六十多条作品我想在旅行前把讲构图的那几期反复看另一位主播每周一次的技术分享直播散场就再也点不进去了。手动方案都不行录屏糊、画质有损直播回放则根本等不到——平台只保留几天过期即删。我需要的是能把链接扔进去、自动把内容按作者整理到本地的东西。在项目仓库翻到一个叫 douyin-downloader 的工具说明里写着视频、图集、合集、音乐、直播回放、主页批量下载几乎覆盖了我全部需求。第一次跑通从克隆到第一个视频落地安装比想象中简单。克隆仓库、装依赖两条命令git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt唯一多一步的是身份认证。抖音接口需要登录态工具提供了自动获取方式运行后会自动打开浏览器你手动登录一次回到终端按回车Cookie 就写好了python tools/cookie_fetcher.py --config config.yml然后是第一条下载命令。我把想收藏的单个视频链接直接传进去python run.py -c config.yml -u https://www.douyin.com/video/7234567890123456789终端里出现了进度条逐项显示解析链接、创建下载器、执行下载最后落到本地的是一个不带水印、自动挑了最高画质的 mp4 文件旁边的 JSON 里还带着标题、作者、发布时间这些元数据。把一条变成一批主页批量下载的关键配置单个视频没问题后我开始处理真正的大头——那位摄影博主的主页。批量下载抖音视频的技巧其实就在配置文件里link指向主页地址mode决定抓哪几类内容number控制各类型数量。link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx path: ./我的收藏/ mode: - post # 发布的作品 - like # 点赞过的作品 - mix # 合集 number: post: 60 like: 20运行后下载器会按作者建目录内部再按类型分文件夹作品、合集、音乐各归各位不会混在一起。我加了thread: 5让并发下载几十条作品十几分钟就全部落地最后终端会汇总一行统计总作品数、成功数、失败数、跳过数。直播回放保存方法一次差点错过直播的教训真正让我觉得这个工具值得的是直播回放保存方法。上周主播临时加了一场新机上手直播我全程在外只来得及把直播间链接复制下来。回来一试直接把live.douyin.com的链接填进link就能录live: max_duration_seconds: 0 # 0 一直录到主播下播 chunk_size: 65536 idle_timeout_seconds: 30程序会先解析出直播间的清晰度选项再生成 FLV 下载链接。整场直播录了一个多小时主播下播后工具自动保留已录数据没有因为断流丢片段。对追更技术分享、公开课这类内容的人来说这条功能等于给直播上了保险——错过直播不再意味着错过内容。下载到一半踩的坑Cookie 失效、翻页限制和重复下载批量下载进行到第三天问题陆续冒出来这里把对策一并记下。Cookie 失效。抖音登录态有时效某天运行命令进度条走到一半报登录态失效。好在工具检测到后会自动重新打开浏览器让你登录更新完 Cookie 自动重试不用手动改任何配置。如果环境不支持自动弹窗重跑一次python tools/cookie_fetcher.py即可。翻页限制。主页作品超过 20 条时API 分页可能被卡住。配置里的browser_fallback就是干这个的——API 翻不动时自动启动浏览器继续滚动抓取必要时可以人工过一下验证码。我的 60 条作品里有 40 多条是靠它补齐的。重复下载。增量更新最容易踩的坑是重复。工具内置 SQLite 去重database: true同一个作品二次运行会直接跳过配合增量配置后续只需抓新增内容increase: post: true like: true文件名也会按模板生成我用的{date}_{title}_{id}让每个文件都带日期和唯一标识配合按作者建目录的规则时间久了也不会乱。锦上添花通知、评论采集和 API 服务稳定跑通后我又翻配置发现了几个顺手的功能。下载完成后可以推送到 Bark 或 Telegram长任务挂在后台手机收个通知就知道跑完了。需要分析视频评论区反馈时可以开评论采集每个作品会额外生成一份*_comments.json。命令行也藏着两个小工具--hot-board 30拉取抖音热搜榜--search 关键词按关键词搜索并导出 JSONL做内容选题参考很方便。想集成到自己的系统里还能以 REST API 服务模式运行python run.py --serve --serve-port 8000对不习惯命令行的朋友项目还有一个同后端的桌面版 Douzy粘贴链接、同步关注列表、实时看下载进度都在图形界面里完成内测阶段可以留意 Releases 页面。半年用下来的一点心得现在我的本地库已经攒了几百条作品和十几场直播回放全部按作者和类型分好了目录。这个工具解决的是内容随手就能存下来这件事——单个视频、整页作品、合集、音乐、直播回放一条链接丢进去剩下的交给它。它适合这些人想离线反复看视频的学习型用户要系统整理某个作者全部作品的收藏爱好者以及需要定期备份直播内容的人。上手门槛不高配置最复杂的地方也就是一个 YAML 文件。想深入了解的可以看仓库里的USAGE.md使用说明、config.example.yml配置注释核心逻辑在core/目录下载器的工厂、直播录制、评论采集这些模块都按职责分好了文件读起来不算难。内容下载下来还是建议用于个人学习收藏别拿去二次传播。工具只是把手怎么用在自己。【免费下载链接】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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考