抖音批量下载怎么做？Douzy 完整无水印归档教程（4 个常用目标）-平芜编程栈

抖音批量下载怎么做？Douzy 完整无水印归档教程（4 个常用目标）

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

Douzy 是开源项目 douyin-downloader 的桌面端名字，一款免费的抖音批量下载工具。它支持无水印视频保存、按创作者主页批量归档、收藏夹同步。适合想整理内容的普通用户，也适合要做数据分析的重度用户。下面用安装配置加 4 个实际用法，带你完整走一遍。

一、项目认知：Douzy 的核心能力一览

Douzy 是一个偏实用取向的抖音内容下载项目。命令行负责执行下载任务，Douzy 桌面版把同一套后端包装成图形界面：粘贴链接、多链接排队、任务状态跟踪、本地作品档案，都可以在界面里完成。它默认优先选择无水印源，并用 SQLite 记录下载历史做去重。

能力项	说明
无水印批量下载	视频、图文、合集、音乐（原声）四类内容，支持作者主页批量任务
去重与增量	SQLite 记录历史，磁盘已存在的主文件可自动跳过，支持只下新增内容
完整元数据	每个作品附带封面、音乐、JSON 元数据等产物
浏览器兜底	分页接口被限流时自动拉起浏览器，可手动完成验证
扩展能力	评论采集、语音转写、完成通知、代理与重试，均可按配置开启

想深入看代码的话，下载模式的策略实现在 core/user_modes/ 目录，Cookie 相关逻辑在 auth/ 目录。

二、安装与配置步骤：从零到第一次下载

环境要求只有一个：Python 3.8 或更高版本，Windows、macOS、Linux 都能跑。拿到代码并装依赖：

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

接下来用cp config.example.yml config.yml复制一份配置文件。Douzy 采用 Cookie 认证，推荐用内置工具自动获取：在弹出的浏览器里登录抖音，回终端按回车，Cookie 会自动写回配置；已有 Cookie 的话也可以直接手填。拿到凭证后，跑下面两条命令就能完成第一次下载：

python -m tools.cookie_fetcher --config config.yml python run.py -c config.yml

配置不用背，先只关心几个字段：

配置项	作用
link	要下载的链接，支持单视频、作者主页、短链
path	文件保存目录
mode	内容类型：post、like、mix、music，登录后还支持 collect
number	每种类型的数量上限，填 0 表示全部
thread / retry_times	并发数与失败重试次数

另外两个常用开关：video、cover、music、json控制要不要保存视频本体、封面、背景音乐和元数据；progress.quiet_logs设为 true 可以让进度阶段日志更安静。想要接口化集成时，项目也支持用--serve启动 REST API 服务。

三、批量下载怎么配：4 个常用目标

把某位创作者的作品整体归档

目标是把一位创作者的作品和合集都存下来。做法：link 填该作者主页链接，mode 加入 post 和 mix，number 里给 post 填想要的条数（0 表示不限量），再把 increase.post 和 increase.mix 设为 true 开启增量。产出：该作者目录下按作品分文件夹，视频、封面、音乐、JSON 元数据齐全，SQLite 里留下下载记录；之后同一配置重复运行，只补新发的内容。

Douzy 主界面：粘贴链接自动识别类型，单条或多条都能排队下载

同步关注列表，持续收集新作品

目标是不用逐个复制链接，让关注的创作者有新内容就自动进库。桌面版左侧的"关注"面板可以一键同步账号关注列表，给每位创作者加备注、筛选"有新作品"的账号，再对单个账号直接发起下载；命令行用户则可以把多个作者主页链接一起写进 link。配合 increase 设为 true 定期执行，就是增量收集。产出：每位作者的目录随时间持续追加，老作品不会重复下载。

关注列表同步：标记新作品数量，直接对创作者发起下载

一键整理自己的收藏夹

目标是把自己收藏的抖音视频和系列做个完整备份。做法：link 填自己主页的收藏夹链接（/user/self?showTab=favorite_collection），mode 用 collect 下载收藏视频，或用 collectmix 下载收藏的系列合集。注意这两种模式基于登录 Cookie 的账号、且必须单独使用，不能和 post、mix 等混在一起；它们也不支持增量跳过。产出：收藏内容按 collect、collectmix 子目录归档，方便按收藏夹结构慢慢翻。

收藏与喜欢面板：收藏的合集可以整组下载

采集评论与语音转写，做内容分析

目标是让每个作品不只留下视频，还留下可分析的数据。做法：把 comments.enabled 设为 true，可用 max_comments 限制每条作品抓取的评论数，include_replies 控制是否抓二级回复；把 transcript.enabled 设为 true，默认模型为 gpt-4o-mini-transcribe，密钥建议放在 OPENAI_API_KEY 环境变量里，转写实现可参考 core/transcript_manager.py。需要限定时间段时，再用 start_time 和 end_time（格式 YYYY-MM-DD）做筛选。产出：每个作品目录里多出 *_comments.json 评论文件和 txt/json 两种格式的转写文本，视频、数据、文本一次备齐。

四、文件组织方式：目录结构、命名模板与 JSON 元数据

默认开启 folderstyle 时，每个作品有独立文件夹。文件名由 filename_template 控制，默认 {date}{title}{id}，可用变量包括 {id}、{title}、{author}、{author_id}、{date}、{year}、{month}、{day}、{time}、{timestamp}、{type}、{mode}；模板里至少要包含 {id}，否则不同作品可能撞名。作者目录层由 author_dir 决定：nickname 是纯昵称，sec_uid 是稳定的用户 ID，nickname_uid 是"昵称_ID"，重名多的重度用户推荐后者。每个作品目录里的 info.json 保存标题、描述、发布时间、点赞数、评论数、作者信息等元数据，开启评论或转写后，comments.json 和转写文件也落在同一目录，方便归档和检索。

Downloaded/ ├── download_manifest.jsonl └── 旅行摄影日记_MS4wLjAB.../ └── post/2026-06-15_跟拍攻略_734123.../ ├── video.mp4、cover.jpg、music.mp3 └── info.json、_comments.json、transcript.txt

任务中心：批量下载的任务状态、失败重试和输出目录都能在这里管理

五、常见故障排查表

现象	可能原因	解决办法
下载慢，或只拿到 20 条左右就停	API 分页触发风控，或网络不稳	开启 browser_fallback 并把 headless 设为 false，在弹出浏览器里手动完成验证；把 thread 降到 3 左右；必要时配置 proxy
Cookie 失效，任务频繁失败	登录状态过期	重新运行`python -m tools.cookie_fetcher --config config.yml`获取新 Cookie，建议每周检查一次
文件名重名、作者目录混乱	模板缺少 {id}，或两位作者昵称相同	filename_template 中加入 {id}；author_dir 改为 nickname_uid；保持 folderstyle 为 true
磁盘空间不够	全量下载内容累积过多	用 start_time、end_time 圈定时间范围；用 number.post 等限制条数；定期清理或迁移到外部存储