抖音无水印批量下载工具：单条链接到博主主页全量抓取

【免费下载链接】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 命令行工具，粘贴抖音链接即可保存无水印视频、图集、合集与原声，也能批量抓取整个博主主页，适合做素材存档和内容数据的个人用户。

🧭 能力速览：从单条链接到整个主页

以上配置字段的完整说明见 config.example.yml，下载流程与模块分工可以查 PROJECT_SUMMARY.md。

把第一个视频存到本地

整个流程分三段：装环境、扫码登录、确认文件落盘。

装好 Python 环境

要求 Python 3.9+，Windows、macOS、Linux 都支持，装完依赖约需 1 分钟。

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

如果后面要启用浏览器兜底（翻页被风控时自动拉起真实浏览器），再装一次 Playwright：pip install playwright && playwright install chromium。

首次运行的最小配置

把示例配置复制成你自己的config.yml，并把link换成要下载的链接，path改成想要的下载目录：

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

第二条命令会弹出浏览器，登录抖音后回到终端按 Enter，Cookie 自动写回config.yml，不用手抄。首次运行加登录共需 2~3 分钟。

跑通第一条下载

python run.py -c config.yml

也可以临时追加链接、调整并发线程数：python run.py -u "<链接>" -t 8。默认 5 线程，线程数越大速度越快，对服务端压力也越大。

验证下载是否成功

看到以下三点才算跑通：

• 终端出现进度条，结束时输出成功与失败的数量统计；
• Downloaded/里出现按{date}_{title}_{id}命名的文件夹，视频文件非空；
• 项目根目录生成dy_downloader.db（SQLite），里面记录了这条下载历史，增量跳过就靠它和磁盘文件一起判定。

命令行之外也有图形入口：同一套下载后端的桌面端 Douzy 提供粘贴链接、任务队列和进度看板，见 run.py 所在目录结构，截图如下。

🗂 进阶用法：三个最常见的场景

全量收集某位博主主页

适合想长期归档一位创作者全部内容的人。配置片段：

mode: [post] number: { post: 0 } increase: { post: true }

判断是否生效：第一次运行下完存量；之后同一命令再跑一遍，已存在的作品被直接跳过，只出现新作品的进度条。like、mix、music各模式也有对应的increase开关，同一作品 ID 不会在多个模式里被下两次。

按发布时间段筛选

适合做某个活动期、某个月份的定向素材库。配置片段：

start_time: "2025-01-01" end_time: "2025-06-30"

判断是否生效：下载目录里只出现该区间内发布的作品；结束日期当天发布的内容包含在内。

采数据而不是存视频

适合做研究、运营分析的场景，要的是结构化数据。命令：

python run.py --search "猫咪" --search-max 100 -p ./Downloaded python run.py --hot-board 30 -p ./Downloaded

把关键词搜索结果和热榜写成 JSONL 文件；再在配置里打开comments.enabled: true，每个视频会多一份评论 JSON，可直接进分析流程。

⚠️ 问题排查：下载卡住时的四种常见原因

结尾

到这里，单条链接、整页主页、时间段筛选都覆盖了；下载行为由 run.py 统一调度，想改并发、画质、通知等字段直接编辑config.yml即可。使用前请记住三条：

• 下载内容仅用于个人观看、学习与数据管理，尊重原作者版权，不做二次侵权传播；
• 控制thread与请求频率，避免对服务端造成过大压力；
• 尊重平台规则与隐私边界，批量抓取时注意内容的使用场合。

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