5 分钟上手抖音批量下载工具 douyin-downloader：无水印、去重、断点续传一次讲透-平芜编程栈

5 分钟上手抖音批量下载工具 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
水印	画面自带水印，二次创作直接废	自动挑无水印视频源，并选最高码率
批量	一条一条手动操作	主页、合集、音乐一键整批抓取
重复	反复下载同样的内容，硬盘吃紧	SQLite 数据库 + 本地文件双重去重
中断	断网断电一切从头再来	Content-Length 完整性校验，不完整文件自动清理重试
素材组织	文件名混乱，找起来头疼	按`作者/模式/日期_标题_ID`自动归档，附带 JSON 元数据

它把"下载"从一件需要盯着的杂活，变成一条能挂后台、能自动增量、能对接其他系统的流水线。

3 步完成环境搭建，拿下今天第一个视频

别被"开源工具"四个字吓到，整个上手过程就是复制三行命令。打开终端，跟着走。

第一步：把项目拉下来并装好依赖

git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader # 克隆仓库 cd douyin-downloader # 进入目录 pip install -r requirements.txt # 安装依赖

网络不给力就换国内镜像：pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple

第二步：用一条命令自动登录拿 Cookie

抖音需要登录状态才能访问内容，这也是多数人卡住的地方。好消息是它内置了自动化脚本：

python -m tools.cookie_fetcher --config config.yml # 自动打开浏览器引导登录

浏览器会弹出抖音登录页，扫码登录后回到终端按一下回车，Cookie 就自动写进配置文件了。全程不用手动翻浏览器开发者工具，对新手极友好。

第三步：配置链接，运行

先复制一份示例配置：cp config.example.yml config.yml，然后编辑它，把下载链接换成你的目标，比如一条视频或一个博主主页：

link: - https://www.douyin.com/video/7604129988555574538 # 换成你想下载的链接 path: ./Downloaded/ # 下载保存目录 thread: 5 # 5 个并发 database: true # 开启 SQLite 去重

保存后运行：

python run.py -c config.yml # 启动下载

接下来你会看到终端里逐条刷新的进度条，每个作品的状态、耗时、保存路径都清清楚楚。

单作品下载：进度、跳过记录、成功统计一目了然，全程无需手动干预

短链也没问题——https://v.douyin.com/...这类分享链接会自动解析后下载，省去你手动还原长链接的麻烦。

三个进阶玩法：增量、API、自动通知

基础下载只是开胃菜，下面三个能力才是让它"好用"的关键。

增量下载防重复：只下你没存过的

维护长期素材库最怕的是重复下载。打开增量开关后，工具会比对数据库历史，只下载新增作品：

increase: post: true # 只下载新发布的视频 like: true # 只下载新喜欢的视频 database: true # 增量模式依赖数据库记录

配合定时任务跑，你的素材库会自动"追更"，像关注列表一样只进新的。

一条命令把下载器变成 REST API

如果想把下载能力嵌入自己的脚本或页面，可以启动服务模式：

pip install fastapi uvicorn # 一次性可选依赖 python run.py --serve --serve-port 8000 # 以 REST API 模式运行

启动后POST /api/v1/download提交{"url": "..."}即可入队下载，GET /api/v1/jobs/{job_id}查询进度。这意味着你可以把它接进自动化工作流，比如定时任务触发、网页按钮一键下载。

下载完自动推送：睡觉也能盯素材库

批量下载跑在后台时，你不想一直盯着终端。开启通知后，完成或失败都会主动告诉你：

notifications: enabled: true providers: - type: bark # iOS 推送 url: https://api.day.app/YOUR_DEVICE_KEY - type: telegram # Telegram 机器人 bot_token: "123456:ABC..." chat_id: "987654321"

支持 Bark、Telegram、Webhook 三种渠道，企业微信、钉钉、飞书的机器人地址同样可以填入。下载完成的消息直接出现在你手机上。

实时进度与事件流，每个任务当前在排队、解析还是下载，一眼可查

三类人，三种打开方式

同样是下载工具，不同人的用法差异很大。

内容创作者：批量拉取关注博主的作品和合集当灵感库。mode支持post（发布）、like（点赞）、mix（合集）、music（原声）四种并行，跨模式自动去重——同一个作品不会因为既在主页又在合集里就被下两遍。配合folderstyle命名模板，素材按作者/日期_标题_ID归档，导入剪映、PR 直接可用。

研究人员 / 运营：除了视频本身，还能采集作品评论（含二级回复）、导出热搜榜和关键词搜索结果：

python run.py --hot-board 30 -p ./Downloaded # 拉取热搜榜前 30，导出 JSONL python run.py --search "猫咪" --search-max 100 -p ./Downloaded # 关键词搜索

每部作品还附带完整 JSON 元数据（点赞、评论、作者信息、分辨率等），可以直接用 pandas 做分析。

直播录屏党：直接丢一个直播间链接进去，FLV 格式录制，主播下播、网络空闲或手动中断时，已录制的字节都会保留，不丢数据：

link: - https://live.douyin.com/123456789 # 直播间 ID live: max_duration_seconds: 3600 # 0 表示录到主播下播

解析直播间后自动拉取高清流并开始录制，下播即保存

五个高频坑位，直接抄答案

坑 1：只能抓到 20 条作品。这是抖音翻页风控。开启浏览器兜底并保持窗口不关，验证通过后即可继续翻页：

browser_fallback: enabled: true headless: false

坑 2：Cookie 过期。通常 7–30 天失效，重新跑一遍python -m tools.cookie_fetcher --config config.yml即可。

坑 3：想重新下载某个作品。双重去重意味着只删文件或只删数据库都不行，要两边一起清：

sqlite3 dy_downloader.db "DELETE FROM aweme WHERE aweme_id = '作品ID';"

坑 4：直播 HLS 源。HLS 只保存 playlist 文件，需要配合 ffmpeg 转码；FLV 则可以直接播放。

坑 5：下载成果的目录结构。文件默认按作者/模式/日期_标题_ID存储，找文件前先看download_manifest.jsonl下载清单，里面记录了每个文件的路径、标签和发布时间，比翻文件夹快得多。

效率对比：用数字说话

拿一个 50 条作品的博主主页做实测：

任务	手动逐条保存	douyin-downloader	节省
单个作品	3–5 分钟	15–30 秒	约 3 分钟
50 个作品	2–3 小时	10–15 分钟	1.5 小时以上
文件命名整理	30 分钟手动改	自动完成	30 分钟
质量检查	20 分钟	3–5 分钟（完整性校验）	15 分钟