5 分钟跑通抖音批量下载：douyin-downloader 从 1 个视频到整个主页

5 分钟跑通抖音批量下载douyin-downloader 从 1 个视频到整个主页【免费下载链接】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凌晨一点你刷到一个宝藏博主的系列视频第 17 期正好讲到最想听的部分。你想把它存下来慢慢看却发现早几期已经被作者删掉了。这种差一点就错过的懊恼每个追更过抖音的人都不陌生。而 douyin-downloader 正是为这类问题而生的开源抖音批量下载工具——去水印保存视频、图文、合集与音乐还能把博主整个主页的内容成批搬回本地。创作者的删帖、平台的限流、主页的清空随时可能让喜欢的作品变成一段记忆。与其被动等待不如主动给自己的内容爱好建一座本地档案库。这篇文章不讲空泛的功能列表只带你走一遍从零到把整个主页搬回家的完整路径。一句话认识 douyin-downloader它是一位自带记账本的搬运工用一句话概括douyin-downloader 是一个命令行驱动的抖音下载工具把视频、图文、合集、音乐、直播统一收纳到本地默认优先取无水印且码率最高的源。如果非要打个比方它像一位自带记账本的搬运工——不光把东西搬回你家还会登记每件物品的编号。下次再去同一个博主家里搬东西翻开账本就知道哪些已经搬过直接跳过绝不重复劳动。这个账本就是内置的 SQLite 数据库也正是它区别于普通录屏工具的核心。工具本身是 Python 写的源码组织得很清爽下载逻辑在douyin-downloader/core/各下载模式主页、点赞、合集、音乐分门别类放在core/user_modes/下想研究实现或二次开发都不难。首次运行四条命令先让第一个视频落盘上手的第一步永远比想象中简单。打开终端依次执行git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader/douyin-downloader pip install -r requirements.txt cp config.example.yml config.yml然后获取 Cookie 认证。抖音需要有效的登录态才能访问内容工具提供了自动方式运行后会自动拉起浏览器扫码登录后回到终端按回车Cookie 会被自动写入配置文件python -m tools.cookie_fetcher --config config.ymlCookie 只保存在你本地电脑的配置文件里不会上传到任何服务器。最后把config.yml里的link换成你想下载的第一个视频保持其余默认值link: - https://www.douyin.com/video/7604129988555574538 path: ./Downloaded/ music: true cover: true json: true执行python run.py -c config.yml一个无水印视频、它的背景音乐、封面图连同完整元数据就会落到本地。跑通这一步你就已经解锁了 90% 的功能——剩下的玩法都只是往配置里加几行。一张表看懂它到底能替你做什么你的任务工具对应能力一句话说明保存单个视频/图文/合集/音乐直接投喂链接/video、/note、/collection、/music均支持短链自动解析把某博主全部作品搬回家主页批量下载mode: post/like/mix/musicnumber: 0表示全量只想要音乐和封面做素材附加资源独立保存music、cover、avatar、json四项开关备份正在进行的直播直播录制FLV/HLS 双格式主播下播自动停止并保留已录数据避免重复下载数据库去重 增量同一作品在不同模式下也只下一份下载中断不白费完整性校验 重试文件不完整自动清理并重下指数退避重试给选题/内容找素材评论采集、热搜榜、关键词搜索评论结构化输出 JSON热搜榜落 JSONL这张表想说明一件事你不需要同时记住所有参数。用哪个功能就打开对应的配置段落其余保持默认。按场景玩不同任务各有一条最短路径场景一把某个博主的主页整个搬回来之后只追新增你关注了一个优质创作者想把全部作品存档这是最常见的需求。配置里这样写link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx mode: - post number: post: 0 # 0 表示全量想限制数量就写具体数字 increase: post: true # 增量模式只下载新增作品 database: true # 增量依赖数据库记录第一次跑全量之后每周跑一次python run.py -c config.yml它会在几秒内扫一遍主页只把新增的作品搬回来。相当于给你的追更对象做了个自动同步订阅。场景二合集与原声音乐做成可检索的素材档案如果你是做剪辑或内容创作的往往不需要完整视频只要原声和封面。直接下载单个音乐或合集即可link: - https://www.douyin.com/music/7341234567890123456 - https://www.douyin.com/collection/7341234567890123456 folderstyle: true # 每个作品一个子目录 filename_template: {date}_{title}_{id}工具会优先抓取原声文件抓不到时才回退到该音乐下的首条作品合集模式则按合集维度整批归档。配合命名模板日积月累下来就是一套按日期、标题自动排序的素材库找东西只需搜文件夹名。下载完成后目录会自动整理成这样的结构Downloaded/ └── 作者名/ └── post/ └── 2024-06-15_作品标题_aweme_id/ ├── video.mp4 # 无水印视频 ├── cover.jpg # 高清封面 ├── music.mp3 # 背景音乐 └── data.json # 完整元数据场景三错过直播录下来慢慢看遇到喜欢的博主开播但你没赶上可以把直播源交给工具录制link: - https://live.douyin.com/123456789 live: max_duration_seconds: 0 # 0 表示录到主播下播录制的 FLV 文件会保存在Downloaded/{作者}/live/下并附带直播间元数据快照。主播下播、网络空闲或你手动中断时已录制的字节都会被保留不会白录。注意 HLS 源目前只保存播放列表文件需要再用 ffmpeg 转一下。场景四评论、热搜与关键词给选题找素材做内容选题的人还可以把它当情报收集器python run.py --hot-board 30 -p ./Downloaded # 热搜榜前 30 条 python run.py --search 猫咪 --search-max 100 -p ./Downloaded # 关键词搜索结果以 JSONL 形式落到hot_board/和search/目录。想按作品抓评论做舆情分析就在配置里打开comments: enabled: true include_replies: true # 是否抓二级回复 max_comments: 500每个作品会额外生成一份*_comments.json字段结构清晰方便后续处理。如果……会怎样避坑清单与边界说明如果只抓到 20 条作品就停了会怎样这是翻页风控的典型表现。请确认配置里browser_fallback.enabled: true、headless: false。触发兜底时浏览器窗口会弹出你需要手动完成验证不要立即关掉窗口——窗口关闭得越早抓得越少。如果下载时冒出 403 或未登录会怎样Cookie 过期了。重新跑一遍python -m tools.cookie_fetcher --config config.yml即可。Cookie 通常有效期 715 天建议把它写进日历每周刷新一次。如果终端被日志刷屏会怎样默认progress.quiet_logs: true已做静默处理真要排查问题再临时加--show-warnings或-v查看详细日志。如果想下载自己的收藏夹会怎样收藏夹模式collect/collectmix只能单独使用不能和post/like混在同一份配置里而且只支持当前登录的账号。关于边界也如实说明浏览器兜底目前只对post做了完整验证like/mix/music主要依赖 API 正常分页直播的 webcast 接口属于实验性能力覆盖不全属于正常现象。工具适合个人备份、学习研究与素材整理请尊重创作者权益仅用于合法合规的用途。动手之前把这几件事放进习惯清单从一条视频开始先跑通单个链接确认环境与 Cookie 都没问题再碰批量。批量前先限数第一次拉博主主页时把number.post设为 20确认目录结构符合预期再放开。给归档留足空间视频文件不小批量下载前确认磁盘余量建议预留 50GB 以上。每周同步一次增量increase.post: true打开后定期跑一次就是最好的追更方式。善用命名模板{date}_{title}_{id}这类模板让归档可检索别用默认乱序文件名。工具能做的一句话就能概括你只负责给链接剩下的去重、重试、整理、归档它替你盯着。与其在视频被删之后懊恼不如花 5 分钟把第一座自己的抖音内容库建起来。打开终端从第一条命令开始。【免费下载链接】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），仅供参考