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 是一款基于 Python 的抖音批量下载工具，支持主页作品、合集、喜欢与音乐的无水印下载，带 SQLite 去重、浏览器兜底与可选评论采集，适合内容创作者、数据研究者与个人存档需求。本文覆盖安装、功能配置、真实场景与排障。

🚀 快速上手：三步完成抖音批量下载部署

环境要求：Python 3.9+，支持 Windows、macOS、Linux。命令行版目前仅支持抖音平台。

第 1 步，安装依赖：

git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader python -m pip install -r requirements.txt python -m pip install playwright && python -m playwright install chromium

第 2 步，配置并登录。复制配置模板并获取 Cookie：

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

工具会打开浏览器，登录抖音后回到终端按 Enter 保存 Cookie。然后把config.yml里的link换成目标博主主页地址，参考 config.example.yml 中的中文注释按需调整。

第 3 步，运行：

python run.py -c config.yml

跑完后在path指定的目录（默认./Downloaded/）下即可看到成果：按「作者名/post/日期_作品标题_aweme_id」组织文件夹，内含无水印.mp4，以及按开关生成的_cover.jpg、_music.mp3、_data.json等附属文件。

🧩 功能拆解：四个核心配置项

多类型批量下载：mode 与 number

一句话价值：一条配置覆盖作品、喜欢、合集、音乐、收藏夹，无需逐个复制链接。

link: - https://www.douyin.com/user/YOUR_SEC_UID mode: [post, mix] # 作品 + 合集 number: post: 50 mix: 0 # 0 表示不限数量

设置后的效果：抓取该博主主页最近 50 条作品和全部合集；link换成单个视频、图文或短链时则按单条下载。注意：2026 年 8 月起抖音接口风控已覆盖部分接口，CLI 对单个作品、喜欢、音乐等直连下载受限，主页作品可走浏览器兜底，详见后文「进阶与边界」。

增量下载与自动去重：increase 与 database

一句话价值：重复运行时只拉新内容，不重下、不占带宽。

increase: post: true # 跳过已判定下载过的作品 database: true # 历史写入 dy_downloader.db redownload_missing_files: true # 磁盘文件缺失或为空时补下

设置后的效果：第二次运行自动跳过已有作品。想重新下载并覆盖时，把对应increase改为false即可，无需清空数据库。

时间范围与画质筛选：start_time 与 video_quality

一句话价值：只下指定时段的作品，画质档位可控，省流量。

start_time: "2025-01-01" end_time: "2025-06-30" # 包含结束日期当天 video_quality: original # 探测并优先原片，失败回退最高转码档

设置后的效果：范围外作品直接不拉取；original可能比最高转码档大数倍且每条作品多一次探测请求，日常使用建议保持默认highest。

评论采集与语音转写：comments 与 transcript

一句话价值：给每个作品补齐文本数据，形成完整档案。

comments: enabled: true include_replies: false transcript: enabled: true model: gpt-4o-mini-transcribe

设置后的效果：每个作品额外生成*_comments.json，视频语音被转写成 txt 或 json（需设置环境变量OPENAI_API_KEY）。转写与评论模块分别位于 core/comments_collector.py 与 cli/whisper_transcribe.py。

🎬 真实场景：两类典型用法

自媒体运营跟踪竞品

他是谁：一名自媒体运营，长期跟踪两名竞品的更新节奏。

想达成什么：持续拿到两人的新增作品和评论数据，形成定期更新的素材库。

关键配置：

link: - https://www.douyin.com/user/竞品一 - https://www.douyin.com/user/竞品二 mode: [post] increase: post: true comments: enabled: true

得到什么结果：每周重跑一次任务只下载新作品，每条作品附带评论 JSON；配合start_time还能按周切片统计发布频率。

课程类内容的批量备份

他是谁：一名教研人员，需要完整备份某博主的系列课程视频。

想达成什么：原画保存 + 可搜索的字幕文本。

关键配置：

mode: [mix] video_quality: original transcript: enabled: true response_formats: [txt, json]

得到什么结果：合集按filename_template规则落成独立文件夹，每节课都有原片与字幕文件，靠文件名中的日期和标题即可定位章节。

⚙️ 进阶与边界

• 浏览器兜底：翻页受限时 Playwright 接管滚动采集，保持browser_fallback.enabled: true和headless: false，在弹出的浏览器里手动完成验证即可；这是 CLI 下主页作品的主要可用路径。
• 完成通知：notifications支持 bark、telegram、webhook 三种 provider，成功或失败都会推送，适合挂后台跑大批量任务。
• 数据存储与导出：开启database: true后，SQLite 库dy_downloader.db记录作品明细与任务历史，下载根目录还会追加download_manifest.jsonl逐行清单，可直接用 sqlite3 查询或导入 pandas 分析，实现见 storage/database.py。
• REST 服务与桌面版：python run.py --serve --serve-port 8000可把下载器挂成 API 服务（需另装 fastapi 与 uvicorn）；另有 GUI 桌面版 Douzy，支持抖音之外更多平台，日常下载推荐优先考虑。

🩺 故障排查

Cookie 失效现象：请求失败，日志出现登录态或风控相关提示。 原因：Cookie 过期或被风控重置。 解决：重新执行python -m tools.cookie_fetcher --config config.yml登录保存。

主页只抓到少量作品现象：主页有上百条作品，实际只下载了几条。 原因：API 分页受限，浏览器兜底未开启或未通过验证。 解决：保持browser_fallback.enabled: true与headless: false，在浏览器中自行完成验证；当前风控仍可能阻止，不保证成功。

看不到失败原因现象：任务中断，终端只有简短提示。 原因：默认日志级别偏精简。 解决：加-v参数运行，如python run.py -c config.yml -v，查看详细日志。

下载慢、频繁重试现象：进度条长时间不动，重试日志刷屏。 原因：并发数偏高触发限速，或网络不稳定。 解决：调低thread（如 5 改为 3），或在proxy中配置代理出口。

写在最后

douyin-downloader 的思路很直接：用 YAML 定义范围，用 CLI 执行，用 SQLite 记住进度。对个人存档和中小规模采集，命令行版已经够用；多平台或高频批量需求可以再看桌面版。

合规声明：本工具仅限个人学习、研究与个人数据备份用途，请尊重内容创作者版权，遵守平台规则与隐私要求，并自行承担使用责任；平台接口变化可能影响功能可用性。

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