douyin-downloader 使用教程：4 步批量下载博主主页无水印视频

douyin-downloader 使用教程：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

想把某位博主的主页作品全部存到本地，逐条点开另存太慢。douyin-downloader 是一个开源的抖音批量下载工具，能把无水印视频、图集、合集、原声一次抓完，还支持直播录制和评论采集。读完这篇教程，你能从零跑通单条链接下载，并独立完成一次博主主页的批量任务。

douyin-downloader 功能清单：它能批量下什么

1. 单条去水印下载：贴一条视频、图文、合集或音乐链接（含短链），自动解析、挑无水印源，并自动选最高码率。
2. 博主主页批量抓取：支持post（发布）、like（点赞）、mix（合集）、music（原声）四种模式，可组合使用，跨模式自动去重。
3. 直播录制：贴live.douyin.com房间链接开始录，主播下播或你按 Ctrl+C，已录部分都会保留。
4. 附带数据存档：可连封面、原声、作者头像、完整 JSON 元数据一起保存，也能按作品抓评论（含二级回复）存成 JSON。
5. 工程化保障：默认 5 线程并发、指数退避重试、SQLite 加本地文件双重去重、不完整文件自动重下，API 翻页被风控时还能拉起浏览器兜底并人工过验证码。
6. 可扩展：时间过滤、增量下载、REST API 服务模式、Docker 部署都开箱可用。

和录屏、手动另存的差别在于：你拿到的不是一堆带水印的劣质文件，而是"原始画质 + 无水印 + 完整元数据"、可去重、可增量、可检索的档案。

douyin-downloader 安装步骤：从克隆到首次下载成功

第 1 步：克隆仓库并装依赖

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

为什么需要：进度条、HTTP 客户端等第三方依赖不少，照仓库清单一次装齐最稳，只需提前备好 Python 3.8+。

第 2 步：准备配置、拿 Cookie

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

为什么需要：Cookie 是访问抖音 API 的凭证，脚本会打开浏览器，你登录一次就自动写入配置。运行前需先执行pip install playwright和python -m playwright install chromium。

第 3 步：把链接写进 config.yml

把link项改成要下载的抖音链接，number.post设 0 表示不限量。首次试水建议先设 1，只下一条验证流程。

第 4 步：跑第一次下载

python run.py -c config.yml

为什么需要：这条命令读 config.yml 并按里面的链接执行，终端有实时进度条，完成后文件落在Downloaded/目录，按作者名和作品标题自动分文件夹。只想快速试一条链接，直接用-u追加即可，不用改配置。

抖音批量下载的三个真实场景：个人归档到定时增量

场景一：归档自己收藏的作品

你会遇到什么：收藏夹越存越乱，还有作品被作者删掉，平台里的存档说没就没。

一条命令解决：配置里写https://www.douyin.com/user/self?showTab=favorite_collection，mode 设为collect，运行python run.py -c config.yml。

跑完你会看到：每条作品一个"日期+标题"命名的文件夹，里面是无水印视频，还有一份带发布时间、点赞数、文案的 JSON，可以直接做关键词检索。

不想碰终端的话，同一套后端的桌面版（Douzy）提供图形界面，粘贴链接就能发起任务。

场景二：给某个博主建素材库

你会遇到什么：做内容拆解要大量同领域作品，手动存得慢，带水印没法直接用。

一条命令解决：python run.py -c config.yml -u "https://www.douyin.com/user/MS4wLjABAAAAxxxx" -t 8 -p ./Downloaded/，配置里 mode 放post。

跑完你会看到：终端实时显示进度和每条任务状态，已下载的作品自动标记"跳过"；结束后硬盘里是按日期、标题分好类的文件夹，视频、封面、原声各归其位。

场景三：每天增量更新

你会遇到什么：要长期跟踪几个账号，手动操作不可持续，还容易碰到限流。

一条命令解决：配置里打开increase.post: true（保持 database 开启），挂到定时任务每天跑同一条命令。

跑完你会看到：每次只拉新发布的作品，配合 SQLite 去重，同步一个账号只要几秒，省流量也省时间。

进阶配置与常见坑：五个问题说清楚

只抓到 20 条作品，是真的只有这么多吗？大概率是翻页被风控了。把browser_fallback.enabled设为true、headless设为false，浏览器弹出后手动过一遍验证，它会继续往下翻页。

并发数调多少合适？不是越大越快。默认 5 线程够用，建议 5-8，调太高反而容易触发限流；速率限制默认 2 请求/秒，一般不必动。

下载中途断网，文件会坏吗？不会白下。默认按 Content-Length 校验完整性，不完整的文件会自动清掉，下次运行重新下载。

只想下某个时间段的作品？配置里写start_time和end_time（格式 YYYY-MM-DD），范围外的作品会被自动过滤，不用下完再挑。

某条作品想重新下载怎么办？去重靠"数据库记录 + 本地文件"双重判断，把对应文件夹（文件名带 aweme_id）和 dy_downloader.db 里的记录都删掉，才会重新抓取。

完整配置项和输出目录结构见 README.zh-CN.md，核心下载逻辑在 core/ 目录，想改命名规则可以直接看源码。

上手建议：从一条链接开始

先用第 4 步试一条单链接，熟悉终端反馈；再跑一次主页批量，最后配上增量加定时任务。

核心命令就一条：python run.py -c config.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