免费开源的抖音批量下载工具 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 是一款免费开源的抖音批量下载工具，主打无水印保存视频、图集、合集与音乐，同时内置自动归档、SQLite 去重和增量更新。这篇文章按"先想清楚要什么，再动手下载"的思路，带你从安装配置到跑通第一次批量下载，顺带挖几个容易被忽略的能力。

收藏夹不是保险箱：失效前，先把内容搬回硬盘

不知道你有没有这种经历：某天点开抖音收藏夹，某条视频显示"作品已删除"。收藏夹里存的其实只是链接，内容是否还在，取决于作者和平台。想留住的视频，只有下载到本地才真正属于你。

但如果靠手动逐个保存，又会撞上两堵墙：一是水印，二是画质压缩。douyin-downloader 的解法很直接——从抖音接口直接取原始文件，自动挑无水印、最高码率的视频源，把"留档"这件事一次性做完。

它不是随手写的小脚本，而是一个工程化工具：批量并发、失败重试、数据库去重、下载完整性校验、文件自动归档都有实现。代码托管在 GitCode，MIT 协议，克隆地址见下文命令。

上图是它的命令行界面：左边显示任务进度与状态，右侧给出成功数、耗时等统计，下载过程全程可见。

一张表看清：它到底能吞下哪些内容

绝大多数同类工具只解决"单个视频"这一个场景，douyin-downloader 覆盖的内容形态要宽得多：

其中"用户主页批量"支持四种模式，也可以组合使用：

• post：作者发布的全部作品
• like：作者点赞过的作品
• mix：作者创建的合集
• music：作者使用过的音乐

跨模式还会自动去重——同一个作品在"发布"和"合集"里都出现时，只会下载一次，不会白白浪费流量。

顺带一提，同一个后端还孵化了一个桌面客户端 Douzy（目前内测中）：粘贴链接、选模式、看任务中心，比命令行更直观。

四条命令跑通第一次下载

环境要求不高：Python 3.8+，Windows / macOS / Linux 都行。全程四条命令：

# 1. 克隆项目（仓库地址） git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader # 2. 安装依赖 cd douyin-downloader && pip install -r requirements.txt # 3. 复制一份配置文件 cp config.example.yml config.yml # 4. 自动获取 Cookie（会弹出浏览器，扫码登录后回车即可） python -m tools.cookie_fetcher --config config.yml

第 4 步是最容易卡住的地方，多说一句：抖音需要登录态才能访问内容，这个命令会打开浏览器让你扫码登录抖音，登录成功后回到终端按回车，Cookie 会自动写进配置文件，全程不需要手动复制粘贴。

配置好之后，改一下config.yml里的下载链接就能开跑：

link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx path: ./Downloaded/ mode: - post number: post: 50 # 最多下载 50 个作品，0 表示不限 thread: 5 # 并发线程数 database: true # 开启 SQLite 去重

然后执行：

python run.py -c config.yml

想临时追加链接、改并发数、改保存路径，不用动配置文件，直接命令行覆盖：

python run.py -c config.yml \ -u "https://www.douyin.com/video/7604129988555574538" \ -t 8 \ -p ./Downloaded

批量下载的正确姿势：增量、去重与归档

只下一个视频，任何工具都行；批量下载才是考验设计的地方。douyin-downloader 在这块做了四件事：

第一，增量下载。设置increase.post: true后，再次运行只会下载上次之后的新作品，适合每天追更某个作者，不重复拉旧内容。

第二，双重去重。项目同时用 SQLite 数据库和本地文件名做检查。已下载的作品再次遇到时直接跳过，目录里不会堆满重复文件。

第三，自动归档。文件按"作者 → 模式 → 作品"三层结构存放，作品目录名默认是"发布时间_标题_ID"，一眼能看出内容归属：

Downloaded/ └── 作者名/ └── post/ └── 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_data.json

第四，下载清单。每次任务都会追加写入download_manifest.jsonl，每行一条 JSON，记录作品日期、作者、标题、标签、文件路径，方便日后检索。

支撑批量稳定运行的基础设施也没落下：默认 5 个并发线程、失败自动重试 3 次（间隔指数退避）、请求限速每秒 2 次、下载后用 Content-Length 校验完整性，文件不完整会自动清理重下。翻页遇到风控时，还可以开启浏览器兜底，人工过一下验证码继续抓取。

文件名和目录名都能自定义模板，比如用filename_template: "{date}_{title}_{id}"，变量支持{id} {title} {author} {date} {mode}等，强迫症用户会喜欢。

被低估的三个隐藏能力

批量下载之外，仓库里还埋着几个多数人不知道的功能，按实用性排序：

直播录制。把链接换成live.douyin.com/{room_id}，工具会解析直播流并录制为 FLV。主播下播、网络中断或你手动 Ctrl+C 时，已录制的部分都会保留，不会白录一场。

数据导出。想研究抖音热搜趋势，或按关键词收集内容，不用写爬虫：

python run.py --hot-board 30 -p ./Downloaded # 热搜榜前30条 python run.py --search "猫咪" --search-max 100 # 关键词搜索

结果以 JSONL 文件落盘。配合配置里的评论采集（comments.enabled: true），每个作品还能额外生成一份*_comments.json，评论数据也能一并带走。

接口化。装一下可选依赖后，还能以 REST API 服务模式运行：

pip install fastapi uvicorn python run.py --serve --serve-port 8000

提交{"url": "..."}到/api/v1/download即可创建下载任务，再通过/api/v1/jobs/{job_id}查询进度。下载完成后还能推送到 Bark、Telegram 或企业微信 Webhook，人在外面也能知道任务结束。

新手最容易踩的四个坑

坑一：Cookie 失效。下载报"未登录"时，重跑一遍python -m tools.cookie_fetcher --config config.yml刷新即可，这是最高频的问题。

坑二：作者主页只抓到 20 条。这是抖音翻页风控的典型现象。对策：确认配置里browser_fallback.enabled: true且headless: false，浏览器弹出后手动完成验证，别急着关窗口。

坑三：想重新下载却始终被跳过。去重是"数据库 + 本地文件"双保险，只删一边没用。想重下某条作品，要同时删掉对应的本地目录和数据库记录：

rm -rf Downloaded/作者名/post/*_<aweme_id>/ sqlite3 dy_downloader.db "DELETE FROM aweme WHERE aweme_id = '<aweme_id>';"

坑四：进度日志疯狂刷屏。默认progress.quiet_logs: true就是静默模式；调试时再临时加--show-warnings或-v，别让终端刷成瀑布。

从今天开始，把喜欢的内容搬回家

给你一份可直接照做的行动清单：

1. 克隆仓库并安装依赖（本文第三节的四条命令）；
2. 跑一遍cookie_fetcher，完成扫码登录；
3. 在config.yml里填上第一个链接，先用number.post: 5试水；
4. 确认文件归档结构符合预期后，再放开数量限制并开启增量下载；
5. 熟悉了基本操作，再逐个尝试直播、热搜导出和 REST API。

最后照例提醒：工具本身开源免费，但下载内容请仅用于个人学习、研究或法律允许的合理使用范围，尊重创作者版权，不要在未经授权的情况下二次传播或商用。

项目信息速览

• 开源协议：MIT License
• 适用平台：Windows / macOS / Linux
• 环境要求：Python 3.8+
• 进阶阅读：douyin-downloader/README.zh-CN.md（完整功能与参数表）、douyin-downloader/config.example.yml（全部可配置项）

【免费下载链接】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