抖音批量下载工具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

凌晨一点，剪辑师小陈还趴在电脑前逐个保存抖音素材。他刚接了一个美食博主的合集拆解任务，20多个视频，复制链接、切换网页、手动解析、挨个重命名，折腾两小时还漏掉了两个。如果你也经历过这种"下载两小时，剪辑五分钟"的尴尬，这篇指南就是为你写的。

认识douyin-downloader：一个命令搞定抖音内容抓取

douyin-downloader 是一款开源的抖音批量下载工具，也是一套完整的抖音内容管理方案。它由开源社区持续维护，同时提供命令行工具和桌面客户端 Douzy（内测中）两种形态，桌面版还集成了关注列表同步、任务中心、作品档案等管理能力，已登录账号就能直接操作。

它的核心能力可以浓缩成一句话：粘贴链接，自动识别内容类型，按你选择的模式批量下载，并自动完成去水印、去重、重命名和归档。支持的链接类型包括：

• 单条视频、图文（/video/、/note/）、短链自动解析
• 单个合集、单首音乐（/collection/、/music/）
• 作者主页批量下载（作品、点赞、合集、音乐四种模式）
• 自己账号的收藏夹（collect/collectmix）
• 直播间录制（live.douyin.com/{房间号}）

极速上手：4步跑通你的第一次抖音无水印下载

整个上手过程不需要写一行代码，按下面四步操作即可。

第1步：拉取项目并安装依赖

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

第一条命令把项目下载到本地，第三条安装全部运行依赖。网络受限时可加-i https://pypi.tuna.tsinghua.edu.cn/simple走国内镜像。

第2步：获取登录Cookie（推荐自动方式）

python -m tools.cookie_fetcher --config config.yml

这条命令会自动打开浏览器引导你登录抖音，登录完成后回到终端按一下回车，Cookie 就会自动写入配置文件，省去手动粘贴的麻烦。Cookie 是抖音识别登录身份的关键，必须要有。

第3步：编辑最小配置

复制示例配置后，在link里填入你想下载的链接即可：

link: - https://www.douyin.com/user/你的目标用户主页 path: ./Downloaded/ mode: - post music: true cover: true json: true thread: 5

• path：下载文件保存目录
• mode：post表示下载作者发布的作品，可改为like（点赞）、mix（合集）、music（音乐）
• thread：并发下载数，默认5，速度与稳定性之间的平衡点

第4步：开始下载

python run.py -c config.yml

运行后终端会实时展示进度条、成功数和耗时，命令行界面一目了然，像下面这样：

下载配置、进度条、成功数一目了然，纯命令行也能看得清清楚楚

功能亮点巡礼：7个值得记住的能力

逐一过一遍它的核心功能，每条都配上它能解决的实际问题：

1. 自动挑选无水印高清源。基于bit_rate数组自动选最高码率，视频和实况图都生效，下载即所得，不用二次处理。
2. SQLite数据库 + 本地文件双重去重。同一作品在 post/like/mix 多个模式下重复出现时不会重复下载，跨模式自动去重。
3. 增量下载模式。开启increase.post: true后，每次只抓新增内容，适合持续跟踪某个作者。
4. 失败重试与完整性校验。指数退避重试（1s、2s、5s），下载后用 Content-Length 比对文件完整性，不完整的自动清理重下，网络中断也能接续。
5. 浏览器兜底机制。API 翻页被风控时自动启动浏览器，弹出验证码窗口由你手动通过，突破"只能抓到20条"的限制。
6. 直播录制。支持 FLV/HLS 格式，主播下播、网络空闲或 Ctrl+C 中断时，已录制的字节都会保留，不白录。
7. 评论采集、热搜榜与关键词搜索。评论支持二级回复抓取，热搜和搜索关键词结果可导出 JSONL，直接当数据用。

任务中心会记录每一次下载的状态、耗时和结果，批量管理非常顺手：

任务中心按作者、类型、状态展示每条任务，支持打开目录和查看详情

真实使用场景：三种典型玩法

场景一：内容创作者的素材库搭建

做二创的博主每周要追几十个同领域账号。把多位作者的主页链接放进link，配合mode: [post, like]，再用命名模板把文件按作者和日期归档：

link: - https://www.douyin.com/user/创作者A - https://www.douyin.com/user/创作者B folderstyle: true path: ./素材库/{author}/{date}_{title}_{aweme_id}/

每个作品自动生成独立子目录，视频、封面、音乐、JSON 元数据各归其位，找素材从"大海捞针"变成"按图索骥"。作品档案面板还支持按作者、关键词、时间筛选，常看博主一眼可见：

SQLite 档案记录全部下载历史，支持按作者和关键词快速筛选定位

场景二：直播内容自动录制

需要记录直播回放时，一条命令即可：

python run.py -l "https://live.douyin.com/直播间ID" -p ./直播录制/

运行后会显示直播间标题、在线人数和清晰度选项，选定后开始拉流录制，主播下播自动收尾。FLV 文件直接可播，另附*_room.json直播间元数据快照。直播命令行界面长这样：

直播录制支持清晰度选择，主播下播后已录制内容自动保存

场景三：运营团队做数据沉淀

团队可以启用 REST API 服务模式（--serve --serve-port 8000），通过/api/v1/download提交下载任务、/api/v1/jobs查询状态，把下载能力接入自己的业务系统。下载完成后还能通过 Bark、Telegram、Webhook 推送通知，任务结束自动告警。

差异化定位：它和普通下载脚本有什么不同

市面上的抖音下载脚本大多只能处理单条链接，遇到风控、断网、重复下载就抓瞎。douyin-downloader 把"下载"这件事做成了完整工程：

避坑提示：新手最容易踩的4个坑

1. 只抓到20条作品。这是抖音翻页风控，确保browser_fallback.enabled: true且headless: false，验证弹窗出现后手动通过，别急着关窗口。
2. Cookie过期导致下载失败。Cookie 一般7-30天失效，重新执行python -m tools.cookie_fetcher --config config.yml即可刷新。
3. 想重下某条却一直跳过。程序靠"数据库记录+本地文件"双重判断，需同时删本地文件（文件名含 aweme_id 的目录）和数据库记录，只删一个不会触发重下。
4. 进度日志刷屏。默认progress.quiet_logs: true会静默进度阶段日志，调试时才加--show-warnings或-v，别一上来就开 verbose。

社区与生态：活跃维护的开源项目

项目采用 MIT 协议开源，自动化测试已覆盖71个用例，配有 GitHub Actions 持续集成、Dockerfile 一键容器化部署，还有桌面版（内测中）和活跃的 QQ 交流群。你可以这样参与：

• 使用中发现问题，在仓库 issue 区提交复现步骤
• 有想法和场景，提功能建议帮助规划路线
• 熟悉 Python 可提交 PR，改进浏览器自动化、评论采集等模块
• 完善文档和教程，让更多人上手

写在最后：让下载回归"工具"的本质

回到开头的小陈——用上 douyin-downloader 之后，他处理同样一批素材从两小时缩短到十几分钟，省下的时间全用在了真正的剪辑和创意上。这正是工具的意义：把重复劳动交给机器，把人解放出来做更有价值的事。

现在就动手吧：打开终端，git clone https://gitcode.com/GitHub_Trending/do/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