企业官网建设流程全解析

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 是一款基于命令行与 YAML 配置的抖音无水印批量下载工具，支持视频、图文与用户主页作品的批量下载，并提供 SQLite 去重与增量更新。它把"手动逐条保存"变成可重复运行的自动归档，适合需要批量保存、筛选和整理博主作品的个人用户。

抖音批量下载使用场景与痛点

• 补档三个月的作品库。晚上 22:00，你想把某位博主 7 月 1 日以来发布的所有作品存到本地。在配置里填好start_time: 2026-07-01和end_time，运行一次后，文件按发布时间归入2026-08-25_作品标题_aweme_id这样的子文件夹，一次跑完。
• 长任务中断不白下。下载 200 多个作品时中途断网。retry_times: 3会自动重试失败项；第二天恢复任务时，增量下载会检查磁盘上已存在的主文件并跳过，只补下缺失的部分。
• 每周固定追更。长期关注某个专栏，希望每周一检查新作品。开启增量开关后，重复运行同一份配置，旧作品全部跳过，只下新增内容，不用清空数据库、也不用手动对账。

douyin-downloader 安装与登录快速开始步骤

要求 Python 3.9+，支持 Windows、macOS 和 Linux。

先克隆代码并安装依赖，最后两条命令为 Playwright 浏览器兜底准备内核：

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

把示例配置复制为正式配置，再启动浏览器登录获取 Cookie（Windows PowerShell 请用Copy-Item config.example.yml config.yml代替cp）：

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

在打开的浏览器里登录抖音，回到终端按 Enter 保存 Cookie。然后把config.yml中的示例link换成目标博主主页地址，运行：

python run.py -c config.yml

全部参数可用python run.py --help查看，常用项有-p指定下载目录、-t设置并发数、-v输出详细日志。

douyin-downloader 核心功能：无水印下载、增量去重与画质控制

视频与图文的无水印批量下载

默认抓取无水印源文件，附带封面、音乐、头像和原始 JSON 均可通过开关按需保存。实际效果是：一份配置批量拉取数十上百个作品，磁盘上留下结构统一的媒体文件。

日期筛选与数量限制

start_time/end_time使用YYYY-MM-DD格式且包含结束当天，number.post设为0表示不限数量。实际效果是：只保存目标时间窗内的作品，磁盘占用可预期。

增量下载与 SQLite 去重

increase.post: true跳过已下载作品，redownload_missing_files: true在文件缺失或为空时补下；dy_downloader.db记录每次任务的作品明细与历史。实际效果是：任务可以随时中断重跑，不产生重复文件。

并发、重试与浏览器兜底

默认 5 个并发（thread: 5）、3 次重试（retry_times: 3），API 翻页受限时由 Playwright 浏览器兜底采集作品 ID。实际效果是：网络不稳或接口受限的任务更可能完整跑完。

可选扩展：评论、转写与通知

评论采集会为每个作品额外生成*_comments.json；转写功能对接语音转文本 API；完成通知支持 bark、telegram、webhook 三类推送。需要哪一项就在配置里打开哪一项。

douyin-downloader 进阶用法：定时任务与自定义目录结构

• 🔐定时任务 + 推送通知。在系统 crontab 中加一条每天 02:00 执行python run.py -c config.yml的规则，再开启notifications并填入 bark 推送地址。效果是：每日自动检查并归档新作品，完成后手机收到通知，无需人工盯守。
• 自定义目录与命名。修改filename_template与folder_template（可用{date}、{title}、{id}等变量，需至少含{id}防覆盖），并把author_dir改为nickname_uid，批量保存多位博主时不会因同名昵称合并目录；保留folderstyle: true得到"作者名/post/日期_标题_作品ID"的三层结构。
• 画质与并发调优。需要原片时把video_quality从默认的highest改为original，探测失败会自动回退到最高转码档；带宽富余时把thread从 5 提到 10，带宽紧张则调低。

douyin-downloader 工作原理：从链接解析到落盘

配置按"命令行参数 > 环境变量 > 配置文件 > 默认值"顺序加载。程序解析链接类型后，携带 Cookie 请求抖音接口获取作品元数据，应用日期、数量与媒体类型筛选，再并发下载媒体文件；完成后追加写入download_manifest.jsonl清单并将历史记入 SQLite，API 分页受限时切换 Playwright 浏览器补全作品 ID。

douyin-downloader 常见问题与排错指南

问：Cookie 失效或提示需要登录怎么办？答：重新运行python -m tools.cookie_fetcher --config config.yml，在浏览器中再次登录抖音，按 Enter 保存新的 Cookie。

问：主页只获取到少量作品且没有报错？答：通常是接口分页被风控限制。保持browser_fallback.enabled: true、headless: false，在弹出的浏览器中手动完成验证。另外，2026-08 起风控已限制 CLI 下载单个视频、合集与音乐，主页作品依赖浏览器兜底、不保证成功；日常下载单个作品建议使用 Douzy 桌面版（Windows/macOS）。

问：任务失败但看不出原因？答：加-v参数输出详细日志：python run.py -c config.yml -v；也可以打开download_manifest.jsonl和dy_downloader.db核对已下载的记录。

延伸阅读：完整配置与字段说明见 config.example.yml，架构与落盘策略见 PROJECT_SUMMARY.md，许可条款见 LICENSE。

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