抖音批量下载工具 douyin-downloader 使用指南：去水印、抓合集、录直播一次搞定

抖音批量下载工具 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」，很可能就是那个能帮你省下无数个深夜的答案。

这是一个真正"为实用而生"的开源工具：不是花架子，而是把下载这件事做到了"扔链接就走"的程度。

一句话认识它：它凭什么值得一试

一句话定位：douyin-downloader 是一个开源的抖音下载工具，支持视频、图文、合集、音乐、收藏夹等内容类型，也能一键批量下载整个博主主页，并且默认自带进度展示、失败重试、数据库去重和浏览器兜底。

记住这两个记忆点就够了：

• 🎯去水印 + 自动挑最高画质：优先抓无水印源，再基于码率信息自动选择最高清的版本，不用再手动一个个比画质。
• 🛡️失败了不慌：翻页被风控时自动切到浏览器模拟模式，下载中断会自动重试，还有完整性校验兜底，成功率有保障。

它到底解决了我的哪些麻烦？

与其背功能清单，不如看看它把哪些"老问题"变成了"不是问题"。

麻烦一：存下来的视频永远带着水印

在线解析网站解出来的视频，画质缩水、水印糊脸是家常便饭。douyin-downloader 的策略很直接：无水印优先——只要接口能拿到无水印源就绝不将就，再根据视频的码率数组自动挑出最高清的版本。下载时还会顺手把封面、原声音乐、作者头像、JSON 元数据一并存好，一个作品就是一份完整的"数字档案"。

cover: true # 保存封面图 music: true # 保存原声音乐 avatar: true # 保存作者头像 json: true # 保存元数据 JSON

这段配置的意思是：每个视频不再只是一条孤零零的 mp4，而是"视频 + 封面 + 音乐 + 头像 + 元数据"整套打包，之后想做二次剪辑或内容分析都有素材可用。

麻烦二：手动一个个保存，存到怀疑人生

博主主页有 200 条作品，传统做法是逐条点开、等待加载、右键另存为。而它支持把整个主页链接丢进去，一次搞定：

link: - https://www.douyin.com/user/这里填博主的sec_uid mode: - post # 下载全部作品 - like # 顺便下载他的点赞内容 number: post: 100 # 0 表示不限数量，全量下载

白话解释：link填博主主页地址，mode选要下载哪些内容（作品、点赞、合集、音乐都支持），number控制下载条数。随手复制的短链（v.douyin.com/xxx）也会自动解析，分享链接直接能用，不用手动还原。

麻烦三：硬盘里堆满了"未命名_01.mp4"

下载多了最头疼的就是文件管理。它用双重去重（SQLite 数据库记录 + 本地文件识别）保证同一个视频不会被重复下载；每个作品还会自动建立目录，找什么都清清楚楚：

命名规则还能按需自定义，模板里至少保留{id}避免重名覆盖：

folderstyle: true # 每个作品单独建子目录 filename_template: "{date}_{title}_{id}" # 支持 date/author/title/id 等变量 author_dir: "nickname_uid" # 作者目录用"昵称_ID"，直观又唯一

麻烦四：翻两页就被平台风控拦下

批量抓取最怕的就是"第 20 条之后就抓不动了"。它的应对方案是浏览器兜底：API 翻页受限时，自动启动浏览器模拟真实操作，还可以手动过验证码。

browser_fallback: enabled: true # 开启兜底能力 headless: false # 非无头模式，方便人工验证

配合默认的指数退避重试（1 秒、2 秒、5 秒递增）和下载完整性校验（比对文件大小，不完整的自动清理重下），单条失败基本不影响整体进度，这也是它能保持高成功率的原因。

三步跑起来：从空文件夹到第一批视频

不用纠结太多配置，跟着做就行。

第一步：把项目装到本地

git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt

如果之后想用浏览器兜底或自动获取 Cookie，再补一句：

pip install playwright python -m playwright install chromium

第二步：复制配置并填上你的链接

cp config.example.yml config.yml

然后打开config.yml，把link换成你想下载的视频或博主主页，保存即可。项目根目录的config.example.yml就是现成的模板，每个选项都带中文注释，照着改就行。

第三步：获取 Cookie，运行

python -m tools.cookie_fetcher --config config.yml # 登录抖音，自动写入 Cookie python run.py -c config.yml # 开始下载

第一次运行后，你就能看到实时进度条和成功/失败统计，效果跟下面这张图一样：

只想下载单个视频？命令行直接追加就行，不用改配置：

python run.py -c config.yml -u "https://www.douyin.com/video/7604129988555574538"

用之前 vs 用之后：一张表看懂差距

新手最容易踩的 4 个坑

坑 1：只抓到了 20 条作品就停了

• 原因：翻页触发了平台风控。
• 解决：确认browser_fallback.enabled: true且headless: false；浏览器弹出后手动完成验证，别急着关窗口。

坑 2：跑着跑着突然报 Cookie 失效

• 原因：登录态过期了。
• 解决：重新执行python -m tools.cookie_fetcher --config config.yml，登录后回车，程序会自动写回配置。

坑 3：收藏夹模式直接报错

• 原因：collect/collectmix只能单独使用，不能和post/like/mix混在一起。
• 解决：收藏夹下载单独跑一次，且只针对当前登录的账号生效。

坑 4：直播录完只有一个 .m3u8 文件

• 原因：直播源是 HLS 时，工具只保存了播放列表文件。
• 解决：改用 FLV 源录制（可直接播放），或用 ffmpeg 对 playlist 做后处理转成成片。

玩熟了之后，还有这些高阶姿势

• 增量追更：开启increase.post: true，配合数据库记录，下次运行只下载新作品，适合每天跟进博主更新。
• 完成通知：下载结束推送到 Bark / Telegram / 企业微信 Webhook，跑完安心去睡觉。
• 热搜与搜索：python run.py --hot-board 30拉热搜榜，python run.py --search "猫咪"按关键词抓作品，结果直接落成 JSONL，方便二次分析。
• 评论采集：打开comments.enabled，每个作品会额外生成一份*_comments.json，做舆情分析很省事。
• 视频转写：配置 OpenAI 转写接口，自动把视频语音转成文字稿，适合内容创作者沉淀文案。
• REST API 模式：先pip install fastapi uvicorn，再python run.py --serve --serve-port 8000，就能以服务方式接入你自己的系统。
• 桌面版 Douzy：同一套后端包装成的图形界面，粘贴链接即刻下载、可视化跟踪任务，目前正在内测：

写在最后：三步开启你的高效下载

回到开头那个深夜——如果你也曾为保存视频发愁，现在可以这样开始：

1. 按上面的三步安装并跑通第一个下载任务；
2. 把常用链接写进config.yml，配上喜欢的命名模板和去重开关；
3. 需要追更就打开增量下载，想省心就接上 Bark 或 Webhook 通知。

最后提醒一句：工具只是工具，请在尊重创作者版权、遵守平台规则与法律法规的前提下使用，下载内容仅用于个人学习、备份或研究。让 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