抖音批量下载怎么用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 这个开源项目推给我——一个主打抖音批量下载的命令行工具能抓作者主页、自动去水印、自动去重。当晚我花四十分钟跑通第二天早上两百条视频已经整整齐齐躺在文件夹里封面、音乐、作者头像一件不少。这就是我想认真写一篇使用记录的原因它不算复杂但第一次接触的人很容易在几个小地方卡住。下面按我自己的上手顺序来讲。它到底解决什么问题不是又一个下载器而是替你管好下载市面上能下抖音视频的东西不少但多数只解决单条问题。我把用过的方式放在一起对比过方式单条下载批量下载去水印附带元数据重复管理官方 App支持不支持不支持弱无在线解析站支持不支持多数支持无无douyin-downloader支持支持支持完整双层去重单条下载是一次性的活儿批量下载是反复出现的活儿。真正拉开差距的是后面几列一次抓一个博主主页的几百条作品、每条作品自动配好封面、原声和 JSON 元数据、第二次运行只下载新增内容——这些才是批量场景里每天都会遇到的麻烦。一个可以量化的对比估算手动操作时一条视频从打开、等待、保存到关闭大约要 25~30 秒100 条就是 40 分钟以上而且全程不能走神用这个工具默认 5 线程并发、失败自动重试同批内容通常几分钟到十几分钟就能跑完具体看网络情况。它不是快十倍的魔法而是把人工守着点这件事彻底省掉了。第一次跑通跟着做十分钟拿到第一段无水印视频先说结论整个流程是克隆 → 装依赖 → 填配置 → 跑一次。命令行看起来有门槛但需要输入的命令其实只有几条。git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt如果之后想让工具自动帮你取 Cookie并在接口被限流时用浏览器兜底可以再装一个 Playwrightpip install playwright python -m playwright install chromium然后复制一份配置文件改两处就行cp config.example.yml config.yml打开config.yml最需要理解的是下面这几行link: - https://www.douyin.com/video/7604129988555574538 # 要下载的链接可以写很多个 path: ./Downloaded/ # 文件保存目录 thread: 5 # 同时下载几个默认 5 retry_times: 3 # 失败后自动重试次数 database: true # 开启 SQLite 去重记录接下来获取 Cookie。推荐用自带的自动方式它会打开浏览器让你登录一次抖音然后自动把凭证写进配置python -m tools.cookie_fetcher --config config.yml最后运行python run.py -c config.yml你会看到终端里先打印出下载配置然后是逐条任务的进度条——视频、封面、音乐依次落盘。第一次看到成功1/1出现在屏幕上的时候还是挺有成就感的 深入拆解两个让它不太容易下崩的设计用得越久我越觉得这个工具最值钱的地方不在能下载而在不太容易下载出错。挑两个我印象最深的设计讲。第一层双层去重像请了个图书管理员。程序同时维护两套已读记录一套是 SQLite 数据库见douyin-downloader/storage/database.py记录每个作品的唯一 ID另一套是文件系统本身——下载目录里每个文件夹的名字都带着作品 ID扫描一遍就知道哪些已经存在。这就好比图书管理员既查借阅登记本又亲自去书架上核对一遍两边都确认没有才会重新入库。你如果开了增量下载increase: post: true第二次跑就只下载新增作品几百条里只挑新的几条省时又省流量。下载完的文件会按作者/模式/日期_标题_ID分层摆放找起来一目了然。第二层浏览器兜底像随身带了把备用钥匙。抖音接口对翻页有风控纯 API 拉取时最常遇到的问题就是只能抓到 20 条。这个工具的应对方式是检测到翻页受限后自动启动一个浏览器窗口像真人一样逐页往下滚把剩余作品都找出来相关配置在douyin-downloader/config/config_loader.py里解析。走正门被拦就从侧门进去——代价是要人工配合过一下验证码但成功率明显高很多。另外还有一层保障下载完会拿文件大小和服务器返回的 Content-Length 比对发现文件不完整就自动清理重下逻辑在douyin-downloader/core/downloader_base.py。这几层叠在一起让批量跑几百条时挂着就能睡成为可能。进阶玩法三种我实际在用的组合工具装上、单条跑通只是开始。下面三个组合是我实际在用的覆盖了大部分需求。组合一博主主页全量抓取以后只下新增。追更某个更新很勤的博主时第一次全量抓之后每天只下新的link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx mode: - post - like # 同时抓作品和点赞列表 number: post: 0 # 0 表示不限制数量 like: 0 increase: post: true # 增量开关下次只下新增 like: true database: true # 增量依赖数据库记录组合二研究向的数据采集。想按关键词收集一批视频或话题数据时不用改配置直接命令行加参数python run.py --search 猫咪 --search-max 200 -p ./研究数据/结果会导出成 JSONL 文件方便后续处理。再配合下面的评论采集配置每个作品旁边会多出一份*_comments.jsoncomments: enabled: true include_replies: false # true 会额外拉每条评论的二级回复 max_comments: 500 page_size: 20组合三备份收藏夹或者录一场直播。想把当前账号收藏的内容整体备份用收藏夹模式想留档一场直播把链接换成直播间地址即可link: - https://www.douyin.com/user/self?showTabfavorite_collection mode: - collect link: - https://live.douyin.com/123456789 live: max_duration_seconds: 0 # 0 一直录到主播下播 idle_timeout_seconds: 30最常踩的三个坑外加几句实话按我自己的经历新手最容易卡在三个地方坑一只抓到 20 条就停了。这是翻页风控的典型表现不是工具坏了。确认browser_fallback.enabled: true且headless: false弹窗出现后手动完成验证别急着关窗口。坑二Cookie 失效任务全部失败。重跑一次python -m tools.cookie_fetcher --config config.yml就行这是最省事的修复方式。坑三想重新下载某个视频却被一直跳过。因为它做的是数据库 文件系统双重检查只删数据库或只删文件都不行两边要一起清README 里写得很清楚。也说说边界浏览器兜底目前主要对post模式验证得比较完整like、mix、music主要依赖 API 正常分页收藏夹模式只能配合当前登录的账号使用且不能和其他模式混跑直播的 HLS 源只保存播放列表文件需要再用 ffmpeg 处理。桌面版 Douzy 正在内测基于同一套后端把命令行这套能力换成了可视化界面任务中心、作品档案一目了然。项目采用 MIT 开源协议测试目录里放着几十个测试用例改动有保障作者在 README 里也留了交流群入口遇到问题先搜历史讨论再提问效率会高很多。说到底它只是把批量下载这件事做扎实的一把工具。收藏喜欢的博主、备份自己的收藏、给研究攒素材都请在尊重版权和平台规则的范围内使用。想试的话就从这个周末开始克隆、装依赖、贴一条链接。跑通第一单之后你会回来把剩下那两百条一起下完的。参考模块路径douyin-downloader/storage/database.pydouyin-downloader/core/downloader_base.pydouyin-downloader/config/config_loader.py【免费下载链接】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），仅供参考