抖音批量下载工具 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-downloaderdouyin-downloader 是一款开源的抖音批量下载工具支持视频、图文、合集、音乐与收藏夹的无水印批量下载并用 SQLite 去重、增量更新、浏览器兜底等机制解决重复下载、命名混乱、翻页被限三大难题。它把下载从一次次手工操作变成一条可重复执行的命令无论你是内容创作者、研究者还是普通用户都能在几分钟内上手。一个看似简单、却花掉一整天的任务先讲一件真事。朋友运营一个美食探店账号某天接到需求把一位对标博主的全部作品整理成内部素材库要求无水印、按发布时间排序、不能有重复。她最初的想法很朴素——打开抖音网页版一条条保存。结果两个小时过去只存下二十几条还遇到了三个麻烦页面往下滚着滚着就被要求验证保存下来的视频带着水印文件名是一串乱码根本分不清哪条是哪条。按这个速度处理完那位博主的几百条作品大约需要一整天还得有人在旁边盯着。她后来换了个思路把下载这件事交给程序人只负责下命令和验收结果。这就是这篇文章的主角——开源工具 douyin-downloader 的用法。下面我们就沿着她那次任务的完整过程一步步看它是怎么把一整天的工作压缩成一条命令 十几分钟等待的。动手之前先看清这个工具能下载什么很多下载工具看起来功能很多真上手才发现一堆限制。douyin-downloader 的能力边界很清晰你把什么样的链接交给它它就执行什么样的任务。它内置了一套链接解析模块能自动识别以下内容类型链接类型典型链接下载内容单条视频/video/{aweme_id}无水印 MP4单条图文/note/{note_id}图集中的全部图片单个合集/collection/{mix_id}合集内所有作品单个音乐/music/{music_id}原声音乐文件用户主页/user/{sec_uid}按模式批量下载我的收藏夹/user/self?showTabfavorite_collection收藏的作品或合集直播间live.douyin.com/{room_id}直播录制FLV/HLS分享短链v.douyin.com/xxxx/自动解析后再下载其中用户主页是使用频率最高的入口因为它能一次覆盖一个博主的所有内容。工具为主页定义了多种下载模式post博主发布的所有作品like博主点赞过的作品mix博主创建的所有合集music博主用过的原声音乐collect / collectmix当前登录账号收藏夹里的作品 / 合集对你来说这意味着不需要记一堆命令只要把从抖音复制的链接粘进去工具自己会判断这是视频、图文还是合集然后走对应的下载流程。10 分钟跑通第一次抖音视频下载弄清楚能力边界后下一步是让它真正跑起来。整个过程只需要三步熟练后十分钟内可以完成。第一步克隆项目并安装依赖项目需要 Python 3.8 以上的环境在终端执行git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt如果你希望使用自动获取 Cookie 或浏览器兜底功能再补装 Playwright 并下载 Chromium 内核pip install playwright python -m playwright install chromium第二步准备 Cookie抖音接口需要登录凭证这是整个工具唯一绕不开的手工环节好在它也提供了自动化方案。推荐方式——自动获取python -m tools.cookie_fetcher --config config.yml命令会弹出浏览器窗口你登录一次抖音回到终端按回车Cookie 就被自动写进配置文件。备选方式——手动粘贴如果自动获取失败可以从浏览器开发者工具里复制 Cookie 字符串填入配置文件的cookies段。两种方式效果相同选顺手的那种即可。第三步写一份最小配置并运行创建一个config.yml内容精简到不能再精简link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx # 博主主页链接 path: ./Downloaded/ mode: - post # 下载发布的作品 number: post: 50 # 只下载最近 50 条0 表示全部 thread: 5 # 5 个并发下载 retry_times: 3 # 失败自动重试 3 次 database: true # 开启 SQLite 去重然后运行python run.py -c config.yml你会看到类似下面的画面工具先拉取作品列表再按并发数逐条下载实时显示进度、跳过已存在的文件最后给出成功数与用时统计。第一张图就是它运行时的真实样子。批量下载的真正门槛不重复、可追溯、有据可查任务进行到这里朋友发现批量下载其实有比下载更麻烦的问题博主今天发 3 条、明天发 2 条素材库要长期维护每次都全量重下很快就会有一堆重复文件而文件一旦多起来找一条特定视频就像大海捞针。douyin-downloader 对这一层的处理是它区别于脚本小子作品的关键第一重保障是去重。工具内置了 SQLite 数据库每下载一条作品都会记录它的唯一 ID、保存路径和下载时间同时它还会扫描本地文件名。双重检查之下同一个视频无论你在post、like还是mix模式里遇到多少次都只会下载一次。第二重保障是增量。配置里把increase.post设为true下次运行时就只下载上次之后新发布的作品适合长期盯一个博主的场景increase: post: true database: true # 增量模式依赖数据库记录第三重保障是资产完整。每条作品下载下来不只是孤零零一个视频文件而是整套数字资产2024-02-07_作品标题_aweme_id/ ├── 2024-02-07_作品标题_aweme_id.mp4 # 无水印视频 ├── 2024-02-07_作品标题_aweme_id_cover.jpg # 封面 ├── 2024-02-07_作品标题_aweme_id_music.mp3 # 原声音乐 ├── 2024-02-07_作品标题_aweme_id_avatar.jpg # 作者头像 └── 2024-02-07_作品标题_aweme_id_data.json # 完整元数据文件名里的日期取自作品发布时间而不是下载时间标题清晰可读按日期前缀自然排序。下载目录里还会生成一份download_manifest.jsonl清单每行一条 JSON记录每条作品的日期、标题、标签、文件路径——这份清单本身就是一个小型索引配合 SQLite 数据库日后想做筛选、统计、迁移都很方便。对你来说这意味着第一次批量下载完成的不只是几百个文件而是一个以后每次更新只花几分钟的素材库。想重新下载某条作品也只需要删除对应记录再重跑一次。当翻页被风控拦下浏览器兜底与重试机制批量下载进行到一半朋友遇到了那个所有抖音采集工具都会撞上的坎只抓到了 20 条作品就停了。这是平台翻页风控的典型表现——API 允许你翻几页之后就不再返回数据。douyin-downloader 的应对方案是降级不投降当 API 分页受限时自动启动浏览器兜底模式。配置默认就带好了browser_fallback: enabled: true headless: false # 非无头模式浏览器窗口会真实弹出 max_scrolls: 240 # 最多滚动 240 次拉取更多作品 idle_rounds: 8 wait_timeout_seconds: 600浏览器弹出后它会模拟真人滚动页面把作品 ID 一个个抓下来再回到 API 通道补全详情。如果遇到验证码窗口会停在原地等你手动完成验证——不要急着关掉窗口验证通过后工具会自动继续。在稳定性这件事上工具还做了另外两手准备指数退避重试下载失败后按 1 秒、2 秒、5 秒的间隔自动重试默认重试 3 次配合默认 5 线程并发与 2 请求/秒的速率限制既快又不至于触发风控完整性校验下载时会比对 Content-Length文件不完整就自动清理并重新下载避免留下看着能播、实际损坏的残次品。对你来说这意味着遇到风控、断网、文件损坏这些意外工具大多能自己消化你不需要守在屏幕前当人肉看门狗。把下载升级成流水线搜索、热搜、评论与接口化素材库建起来之后任务的性质变了——从存下某个人变成持续采集某一类内容。这时候 douyin-downloader 的几个旁支功能开始派上用场。按关键词找素材。想给选题储备一批相关视频一行命令直接按关键词搜索并导出结果python run.py --search 猫咪 --search-max 100 -p ./Downloaded抓取热搜榜。运营团队想了解今天什么话题在涨执行--hot-board 30就能把热搜榜快照导出成 JSONL 文件适合做每日存档。采集评论区。研究类需求常常要连评论一起分析。在配置里打开comments.enabled每个作品旁边会多生成一份*_comments.json还能选择是否带上每条评论的二级回复。开放成服务。如果你想把下载能力集成进自己的系统工具可以以 REST API 模式运行pip install fastapi uvicorn python run.py --serve --serve-port 8000然后通过POST /api/v1/download提交链接、GET /api/v1/jobs/{job_id}查询进度。任务跑完还能通过 Bark、Telegram 或 Webhook 推送通知到你的手机或群机器人适合夜里挂着下载、白天起来验收的工作流。连直播也能录。遇到需要保留的直播活动把直播间链接放进配置link: - https://live.douyin.com/123456789 live: max_duration_seconds: 3600 # 0 表示录到主播下播 idle_timeout_seconds: 30录制的 FLV 文件保存在Downloaded/{作者}/live/下主播下播或手动中断时已经录到的内容都会保留下来。对于视频本身如果开启了转写功能transcript.enabled: true还会在下载后自动生成文字稿方便做内容检索。对你来说这意味着这个工具不只是下载器而是一套可以组合的内容采集流水线——搜索、抓取、下载、转写、通知每个环节都能单独开关。不想敲命令行桌面版把一切变成可视化如果你平时不碰终端或者想让团队成员一起使用项目的桌面版客户端Douzy提供了更直观的入口。它基于同一套后端把上面讲到的能力全部搬到了图形界面里粘贴链接即刻开始把抖音链接粘进输入框选好内容类型点一下就开始下载任务中心每个下载任务独立显示状态、数量和耗时失败的任务可以直接看事件日志定位原因作品档案用 SQLite 数据库管理全部下载历史可以按作者、标题关键词、发布时间筛选支持批量导出和删除个性化设置作者目录命名昵称 / sec_uid / 昵称uid、文件命名模板都可在界面上配置。命令行版与桌面版各有所长命令行适合脚本化、定时任务和服务器部署桌面版适合日常使用和多人协作。两者共享同一套下载与去重逻辑数据可以无缝衔接。收尾把效率放在合规的框架里回到开头那个任务。朋友最后花了大约十几分钟完成配置跑了两次命令几百条作品就整整齐齐地躺在素材库里——按作者分目录、按日期命名、数据库里有完整记录下次更新只需要几分钟。如果你也想复现这个流程上手路径很直接克隆项目并安装依赖git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader然后pip install -r requirements.txt用python -m tools.cookie_fetcher --config config.yml获取 Cookie填一份最小配置运行python run.py -c config.yml从下载第一条视频开始体验。最后说一句重要的话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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考