从6小时到15分钟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 这类工具做抖音批量下载——手动逐条保存 500 条视频大约要 6 小时按每条 40 秒估算而它 15 分钟内就能跑完拿到的还是无水印原画。douyin-downloader 是一个开源、免费、跨平台macOS / Linux / Windows的抖音下载工具。它把复制链接 → 粘贴 → 自动下载 → 自动归档整条链路自动化你需要做的只有一件事把链接丢给它。今天这篇文章就带你把它的全部能力摸一遍并亲自动手完成第一次下载。 一句话定位它是什么你需不需要它一句话说清一个把抖音链接变成无水印视频 图集 合集 原声音乐本地文件的开源命令行工具。先别急着装花 10 秒做个自测看看你是哪类用户☐内容创作者需要批量收集竞品视频、同题材素材做参考☐研究者需要按话题或作者采集视频样本做内容分析☐运营人员需要把某个博主、某个话题下的内容整理成素材库☐普通收藏党看到好视频想无水印备份不想每次手动另存只要勾中任意一项这篇文章就值得读完。 能力全景图douyin-downloader 能下载什么先看一张内容类型总表每一项我都附了一句它解决了什么方便你对照自己的需求内容类型链接特征它解决了什么单个视频/video/xxxx看到一条喜欢的直接无水印存下来图文图集/note/xxxx多图内容完整落盘一张不丢合集/collection/xxxx整个合集一键搬回家不用逐条点音乐原声/music/xxxx保存热门 BGM 的原声文件作者主页/user/xxxx抖音博主作品批量下载一个链接带走全部收藏夹/user/self备份你收藏过的所有内容直播间live.douyin.com/xxx实时录制主播下播自动收工再看四个核心能力理解它们能让你的下载体验完全不同 智能去重—— 每个作品在 SQLite 数据库里都有唯一记录重复跑任务只下载新增内容。简单来说就像图书馆的借阅记录不会重复登记同一本书你的硬盘也不会存两遍同样的视频。 完整元数据—— 每个作品不只是一个 mp4还包括封面、原声音乐、作者头像和一份 JSON 详情文件。做研究、剪素材、二次创作数据都够用。相关实现可参考douyin-downloader/storage/database.py与douyin-downloader/storage/metadata_handler.py。️ 浏览器兜底—— 当 API 翻页被限流时工具会自动唤起浏览器模拟滚动采集并留出窗口让你手动过验证码。相当于 API 大门关了还有一扇人肉通行的侧门。 直播录制—— 支持 FLV/HLS 流录制网络中断或主播下播时已录制的数据都会保留下来。除此之外还有评论采集、下载完成通知Bark / Telegram / Webhook、AI 视频转写等可选功能配置项都写在config.example.yml里用到了再打开。上面是 douyin-downloader 在终端里跑批量下载的画面每个任务一根进度条完成即标注 100%。 douyin-downloader 使用教程一位新手的第一次下载下面我用第一人称带你走一遍完整流程。我照着这个流程从零跑通全程大约 20 分钟你也一样。第 1 步把项目拿下来# 克隆仓库并安装依赖需要 Python 3.8 git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt如果想用自动获取 Cookie和浏览器兜底再多装一个浏览器驱动# 安装 playwright用于自动登录取 Cookie 和翻页兜底 pip install playwright python -m playwright install chromium第 2 步写一份最小配置# 复制官方模板再按需修改 cp config.example.yml config.yml我的目标是下载某个博主最近 30 条作品于是把配置改成了这样link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx # 换成你要下载的博主主页链接 path: ./Downloaded/ # 下载文件存放目录 mode: - post # post主页作品还有 like/mix/music/collect number: post: 30 # 只下最近 30 条0 表示不限制 thread: 5 # 5 个并发下载数字越大越快但别贪多 retry_times: 3 # 失败自动重试 3 次 database: true # 打开 SQLite 去重重复跑不会重复下这段配置已经覆盖 90% 的日常场景。thread和retry_times是速度与稳定的平衡杆后面避坑清单里会细说。第 3 步搞定 Cookie新手最容易卡的一步抖音对未登录请求的风控很严没有 Cookie大量请求会被直接拒绝。最省事的方式是让工具帮你自动获取# 自动打开浏览器扫码登录后回到终端按回车Cookie 自动写入配置 python -m tools.cookie_fetcher --config config.yml第一次跑这步会有点紧张别慌按提示扫码登录回到终端敲一下回车即可程序会把 Cookie 写进config.yml。第 4 步运行并验证抖音视频无水印下载结果# 读取 config.yml开始批量下载 python run.py -c config.yml跑完之后去Downloaded/目录看看成果。工具已经帮你把文件归档得清清楚楚Downloaded/ └── 博主昵称/ └── post/ └── 2024-02-07_作品标题_aweme_id/ ├── 视频.mp4 # 无水印原画 ├── 封面.jpg ├── 原声.mp3 ├── 头像.jpg └── 元数据.json # 完整结构化信息下载完成后作品按作者 → 类型 → 日期_标题_ID自动归档一眼就能找到。顺带一提Downloaded/里还会生成一份download_manifest.jsonl每行是一条作品的下载记录日期、ID、作者、标签、文件路径相当于一份机器可读的下载清单后续想统计、检索都方便。⚠️ 避坑清单抖音批量下载新手最容易踩的 5 个坑这些坑我全踩过直接给你错误做法 → 正确做法 → 背后原理三段式比逐个排查日志高效得多。坑 1不配 Cookie 直接跑❌ 错误做法clone 完直接python run.py结果大面积报错。✅ 正确做法先跑python -m tools.cookie_fetcher --config config.yml完成认证。 背后原理Cookie 是通往抖音 API 的门禁卡未登录请求命中风控的概率极高。坑 2number 不设以为会自动全量下载❌ 错误做法只写mode: [post]跑完发现只下了 1 条。✅ 正确做法明确写number.post: 30想全量就写 0。 背后原理number是下载条数上限默认值偏保守防止你无意间拉爆一个超大账号属于工具的安全默认。坑 3翻页风控导致只抓到 20 条❌ 错误做法browser_fallback.headless: true页面被限流了也毫无察觉。✅ 正确做法确保browser_fallback.enabled: true、headless: false浏览器弹窗出现后手动完成验证再继续。 背后原理批量翻页最容易触发风控浏览器兜底是API 走不通时的备用通道人工过验证码是最后一道保险。坑 4下载失败几条就以为工具坏了❌ 错误做法看到红色 error 就 CtrlC 推倒重来。✅ 正确做法让它跑完retry_times会自动指数退避重试1s/2s/5s再配合database: true第二次运行只会补齐缺失项。 背后原理单个文件失败会记录在案不完整文件会按 Content-Length 校验后自动清理重下整体任务不受影响。坑 5文件名模板导致文件互相覆盖❌ 错误做法filename_template: {title}标题相同的作品互相覆盖悄悄丢数据。✅ 正确做法模板里务必保留{id}例如{date}_{title}_{id}。 背后原理aweme_id是作品唯一标识文件名里没有它就无法保证不重名。 进阶玩法从抖音合集下载到抖音直播录制基础流程跑通之后这几个进阶场景能帮你把工具用到顺手的程度。如果你要建教学资料库→ 用comments.enabled: true顺带采集评论用--search 关键词 --search-max 100按话题搜索再用start_time/end_time圈定时间范围批量攒素材又快又齐。如果你要做抖音合集下载→ 直接把合集链接填进link例如/collection/xxxx或/mix/xxxx工具会按顺序把合集内所有作品一次性搬完不需要手动逐条翻页。如果你要录一场直播→ 把链接换成live.douyin.com/{房间号}再在配置里加一段livelive: max_duration_seconds: 3600 # 0 表示录到主播下播 idle_timeout_seconds: 30 # 30 秒无数据视为断流这就是抖音直播录制的全部配置主播下播后录制自动收尾数据完整保留。如果你想把下载接进自己的系统→ 用python run.py --serve --serve-port 8000启动 REST API 服务模式需要pip install fastapi uvicorn让其他程序通过接口提交下载任务适合做自动化流水线。另外基于同一套后端打造的桌面版 Douzy 正在内测提供任务中心、关注同步、作品档案等可视化操作图形界面党可以留意项目 Releases 的动态。桌面版任务中心多个下载任务的状态、数量、时间一目了然适合日常高频使用。✅ 现在轮到你动手了如果你觉得这工具好像有用别急着收藏直接做这三步克隆git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader配置复制config.example.yml填上你的链接和下载条数试跑先下 3 条验证流程确认无误后再放大到全量过程中遇到问题去项目 Issues 区提问或者翻README.zh-CN.md的说明如果你有改进想法也欢迎提交代码和文档开源项目最需要的就是使用者的真实反馈。最后补一句负责任的话请在合法合规前提下使用这个工具只下载你拥有下载权限的内容尊重原作者与平台规则。工具解决的是怎么下载的效率问题而下载什么的决定权始终在你手里。——收藏夹里躺着一百个稍后再看的你是时候把它们都清空了。【免费下载链接】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），仅供参考