短视频批量下载实战用 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 要解决的——一款开源的抖音批量下载工具支持视频、图文、合集、音乐原声的无水印下载也能一次抓取作者主页、点赞列表和收藏夹。配置一次之后每次运行都能自动把新增内容归档到本地配合 SQLite 数据库去重绝不重复占用硬盘。这篇文章不打算罗列枯燥的功能清单而是从一次真实的使用流程讲起带你从零跑通再逐步把工具调教成适合自己的私人内容库。第一站30 分钟跑通第一次批量下载先把项目拿到本地。假设你已经装好 Python 3.8 或更高版本git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt随后复制一份配置模板开始定制cp config.example.yml config.yml配置文件骨架在config.example.yml里写得很清楚。想要下载某个作者主页的全部作品最小配置其实只有几行link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx mode: - post number: post: 0 # 0 表示不限数量全部下载 path: ./Downloaded/mode决定抓取哪些内容post是主页作品like是作者点赞过的内容mix是合集music是背景音乐。number控制每种模式下的数量上限。下一步是让程序拿到你的登录态。推荐用内置的引导工具自动获取 Cookiepython -m tools.cookie_fetcher --config config.yml浏览器弹出后登录抖音回到终端按一下回车Cookie 会自动写进配置。最后运行python run.py -c config.yml进度条会实时展示每个任务的下载状态。第一次跑完Downloaded/目录下就已经按作者、按作品建好了完整的文件夹结构无水印视频、封面、音乐、JSON 元数据整整齐齐地躺在各自的位置。第二站先弄清楚它的能力边界很多工具的问题不是功能太少而是你不知道它到底能干什么。这里用一张表把 douyin-downloader 的主要能力梳理清楚内容形态支持方式说明单个视频 / 图文直接粘贴链接自动识别 /video/、/note/、/gallery/ 路径单个合集 / 音乐直接粘贴链接音乐优先取原声文件缺失时回退到该音乐下首条作品作者主页批量下载用户主页链接 mode支持 post / like / mix / music 四种模式自己的收藏夹/user/self 链接 collect需要当前登录账号的 Cookie直播录制live.douyin.com 链接FLV/HLS主播下播保留已录数据评论采集comments 配置段输出 *_comments.json可选二级回复热搜榜 / 关键词搜索--hot-board / --search结果导出为 JSONL方便后续分析下载质量方面程序会基于video.bit_rate数组自动挑选最高码率的无水印视频源对追求画质的朋友很关键。核心实现集中在douyin-downloader/core/目录想深入研究的可以从downloader_base.py读起。第三站让归档目录井井有条默认配置已经能把文件按作者 → 作品 → 各类资源组织好但如果内容量很大建议花两分钟调整命名规则。filename_template和folder_template支持一组占位变量{id}作品唯一 ID、{title}标题、{author}昵称、{date}发布日期、{type}内容类型等。模板中至少保留{id}否则两个同名标题可能互相覆盖。filename_template: {date}_{title}_{id} folder_template: {date}_{title}_{id} author_dir: nickname_uid # 昵称_用户ID直观且唯一 folderstyle: true # 每个作品一个独立子目录author_dir有三个档位nickname最直观但重名会合并sec_uid稳定唯一但不直观nickname_uid两者兼顾适合长期使用的重度用户。改好之后你会得到一个类似这样的归档结构Downloaded/ └── 创作者名_MS4wLjABAAAAxxx/ └── post/ └── 2024-06-15_舞蹈教学_123456789/ ├── video.mp4 ├── cover.jpg ├── music.mp3 └── data.json如果只想保留某段时间的内容start_time和end_time两个配置项可以按YYYY-MM-DD格式过滤适合做年度回顾或数据研究时只取特定区间。第四站增量下载技巧让重复劳动归零用过下载工具的人都有体会最烦的不是第一次下载而是第二次运行——如果每次都把已下载的内容再下一遍既慢又费空间。douyin-downloader 的去重是双保险一方面把下载记录写进 SQLite默认dy_downloader.db另一方面扫描本地文件名中的aweme_id。数据库和本地文件双重比对只要一方命中就跳过。在此基础上开启增量下载只处理新作品increase: post: true like: true mix: true music: true database: true配合定时任务比如 crontab 每天凌晨跑一次你就能拥有一个持续更新的内容库——每次只下载新增的几条硬盘和流量都省到了。想达到只下载新增内容的效果increase与database必须同时开启。第五站常见失败场景的解决方案工具用久了难免踩坑下面三个是出现频率最高的一并给出对策。只抓到 20 条作品就停了。这是翻页风控的典型表现。确保browser_fallback开启enabled: true、headless: false浏览器窗口弹出时手动完成验证不要立刻关掉窗口。Cookie 过期导致抓取失败。重新运行一次python -m tools.cookie_fetcher --config config.yml即可刷新。建议每周检查一次特别是高频下载的用户。下载的文件不完整。程序会对 Content-Length 做完整性校验不完整的文件会被自动清理并重试如果频繁出现先检查网络稳定性或者调低thread并发数、调高retry_times重试次数。第六站把下载升级成自动化流水线命令行手动运行只是起点。douyin-downloader 还提供了几条通往自动化的路径REST API 服务。安装fastapi与uvicorn后用python run.py --serve --serve-port 8000启动就能通过 HTTP 提交下载任务、查询任务状态和下载历史方便接入自己的脚本或运维系统。完成通知推送。配置notifications段支持 Bark、Telegram 和 Webhook。企业微信、飞书、钉钉的机器人地址也可以直接复用 Webhook 类型下载完成或失败时即时收到消息适合批量跑任务又不想一直盯着终端的人。直播与语音转写。粘贴live.douyin.com/{room_id}链接可直接录制直播transcript段开启后视频下载完会调用 OpenAI Transcriptions API 生成字幕文本对做内容整理的用户非常实用。从一次下载开始搭建自己的内容库回看整个流程douyin-downloader 的价值其实不在下载本身而在于把这件事做成了可持续的系统第一次全量归档之后增量更新去重机制保证硬盘不被浪费命名模板保证内容随时可检索。建议你的第一步别贪多先拿一个自己最常看的作者主页试跑一次post模式确认流程跑通后再逐步打开合集、音乐、评论采集这些高级选项。配置稳定之后再考虑用定时任务或 REST API 把它变成无人值守的流水线。无论你是想整理收藏的普通用户、需要素材库的内容创作者还是做内容研究的数据分析师这套流程都值得花半小时体验一次。需要提醒的是下载内容请仅用于个人学习与研究尊重创作者的劳动成果。【免费下载链接】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），仅供参考