抖音视频批量下载工具 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 就是专门来终结这种体验的开源工具：它支持抖音无水印下载，单个视频、图集、合集、音乐原声、作者主页批量下载全部覆盖，并且内置进度展示、失败重试、SQLite 去重和浏览器兜底。无论你是想要一条素材，还是想把整个主页打包带走，它都能在几分钟内给你答案。

主界面：把抖音链接粘进去，检测后即可选择下载范围

先看它替你省掉了哪些麻烦事

不绕弯子，直接列出最值得关注的几个能力：

• 🎯去水印 + 自动挑最高清：下载时优先选无水印源，并依据码率信息自动挑选最高清版本，不用再手动对比画质。
• ⚡批量不设限：作者主页支持发布作品、喜欢列表、合集、音乐四种模式同时拉取，登录账号的收藏夹也能导出。
• 🔁断点续传 + 完整性校验：下载前比对 Content-Length，不完整的文件自动清理并重试；网络中断后再次运行即可接着下，不浪费已完成的字节。
• 🗃️数据库双重去重：SQLite 记录 + 本地文件扫描双保险，同一个作品无论出现在主页还是合集，都不会被重复下载。
• 🖥️浏览器兜底：翻页触发风控时自动拉起浏览器，让你手动过一下验证码，验证通过后继续翻页抓取。

十分钟跑通第一单下载

整个流程只需五步，全程不需要写一行代码。

第一步，拉取项目并安装依赖。打开终端执行：

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

第二步，准备配置与登录态。复制一份示例配置，并用自带的工具自动获取 Cookie：

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

命令会自动打开浏览器引导你登录抖音，登录成功后回到终端按一下回车，Cookie 就会被自动写回配置文件，不用手动复制粘贴一长串字符。

第三步，把要下的链接填进配置。编辑config.yml，在link下面写上目标地址：

link: - https://www.douyin.com/user/你的目标用户主页 path: ./Downloaded/ mode: - post number: post: 0 # 0 表示全量下载

第四步，运行并观察进度。执行python run.py -c config.yml，终端会实时展示每个任务的进度、跳过状态和最终统计。

命令行模式逐条展示下载进度与“跳过已存在”的去重结果

第五步，去输出目录验收。默认情况下，每个作品会落在Downloaded/作者名/post/日期_标题_作品ID/目录里，视频、封面、音频、JSON 元数据、头像按需各归其位，一眼就能找到想要的文件。

进阶玩法：按你的身份挑着用

内容创作者：把素材库管理交给命名模板

做剪辑最怕文件乱。工具支持完全自定义的文件名和子目录模板，变量包括{id}、{title}、{author}、{date}、{year}、{month}、{time}等。推荐这样组织：

folderstyle: true filename_template: "{date}_{title}_{id}" folder_template: "{date}_{title}_{id}" author_dir: "nickname_uid"

其中author_dir有三个选项：nickname直观但同名会合并、sec_uid稳定但不友好、nickname_uid两者兼顾，重度用户建议直接选它。再配合music: true、cover: true、json: true，一次下载就能拿到视频、原声、封面和完整元数据四件套。

命名模板可视化配置，变量列表一目了然，改完即时生效

追更党和运营：增量下载 + 完成通知

每周手动检查博主有没有更新，太累了。开启增量模式后，工具会对照数据库只下载新发布的内容，配合完成后推送，基本可以做到“博主发一条，你这里自动多一条”：

database: true increase: post: true notifications: enabled: true providers: - type: bark url: https://api.day.app/YOUR_DEVICE_KEY

通知渠道支持 Bark、Telegram 和通用 Webhook，企业微信、飞书、钉钉的机器人地址也能直接复用。多个渠道会并发推送，单个失败不会卡住主流程。

关注列表支持批量同步与下载，运营人员可集中管理多个博主

数据研究者：热搜榜、关键词搜索与评论采集

除了下载，工具还能当数据采集器用：--hot-board一键导出抖音热搜榜快照，--search按关键词搜索作品并落盘 JSONL，评论采集则可以为每个作品生成独立的评论文件（可选抓取二级回复）。

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

comments: enabled: true include_replies: true max_comments: 500

开发者：REST API 与 Docker 一键起服务

工具支持以服务模式运行，暴露 HTTP 接口供其他程序调用。装上可选依赖后启动，就能用POST /api/v1/download提交下载任务、用GET /api/v1/jobs/{job_id}查询进度：

pip install fastapi uvicorn python run.py --serve --serve-port 8000

对喜欢容器化的团队，仓库也提供了 Dockerfile，docker build之后挂载配置与输出目录即可运行。视频转写功能同样可选——配置好 OpenAI 密钥，下载完成后会自动生成字幕文本文件。

高频问题速查卡

Q1：只能抓到 20 条作品，翻页就停？这是抖音翻页风控的典型表现。把browser_fallback.enabled设为true、headless设为false，浏览器弹窗出现后手动完成验证，别急着关窗口，验证通过后即可继续抓取。

Q2：Cookie 过期了怎么办？Cookie 一般 7 到 30 天失效。重新执行python -m tools.cookie_fetcher --config config.yml走一遍登录流程即可，无需手动改配置。

Q3：下载速度太慢？把thread调到 3 到 5 之间，重试次数保持默认即可；如果仍受限，可以在proxy中配置 HTTP/HTTPS 代理地址绕过限制。

Q4：想重新下载某个作品，但它被去重跳过了？同时清掉本地文件目录和数据库记录才能触发重下：

sqlite3 dy_downloader.db "DELETE FROM aweme WHERE aweme_id = '作品ID';"

只删文件或只删数据库都不会生效，因为程序是双重检查。

Q5：直播怎么录？把link指向直播间地址即可，FLV 格式保存后可直接播放，HLS 源则保存 playlist 文件，可用 ffmpeg 后处理；主播下播或手动中断时，已录制的字节会被保留，不会白录。

一小时的工作，十分钟收工

最后用一组真实体感数据收个尾：

从“找链接、等广告、下完发现带水印”到“贴链接、按回车、收工看目录”，这套工具把重复劳动压缩到了极致。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