抖音批量下载完整指南：5 步跑通 douyin-downloader，把无水印视频搬进硬盘

抖音批量下载完整指南：5 步跑通 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 是开源抖音批量下载工具：按无水印母版保存视频、图集、合集与原声音乐，自带去重、重试和直播录制。读完并按顺序做一遍，你能下下第一条无水印视频，再学会把整个作者主页搬进本地硬盘。

先撕掉一个误区：水印不是刻在视频里的 📦

反直觉的事实是：你看到的每条抖音视频，服务器上都存着一份没贴水印的原件。

把它想成快递：水印只是贴在纸箱外的快递单，不是刻在货物上的。日常播放只是给你看"带单的包装"。douyin-downloader 做的事，就是找到服务器那扇门，把原件直接搬到你电脑上——封面、原声音乐、元数据顺路一起带走。

所以不需要录屏，也不用碰在线解析网站。心理门槛先降一半。

最快上手：5 步拿下第一条无水印抖音视频 🗝️

第一次跑通只需要下面五步，每步都只给必要命令。

第 1 步，把代码和依赖装好。下面这条命令串完成克隆、装核心依赖和扫码工具，最后一条会下载扫码用的浏览器内核：

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

第 2 步，复制一份配置模板。项目自带样例配置 config.example.yml，拷一份出来改：

cp config.example.yml config.yml

第 3 步，扫码拿到"进门钥匙"。运行这个内置小程序会弹出浏览器二维码，用抖音 App 扫一下，回终端按回车，Cookie 自动写进配置，全程不用手抄。实现就在 tools/cookie_fetcher.py：

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

第 4 步，填上"收货地址"。打开config.yml，把想下的视频短链填进link。注意默认只保存视频本体，封面、音乐、元数据这些附带产物默认是关的，按需打开：

link: - https://v.douyin.com/xxxxxx/ path: ./Downloaded/ music: true cover: true json: true

第 5 步，跑起来。短链自动解析，视频源按无水印优先挑选，码率自动挑最高一档，命令行实时刷进度：

python run.py -c config.yml

跑完去Downloaded/看一眼，第一条无水印视频已经躺在硬盘里了。🎉

如果你完全不想碰命令行，项目还有基于同一套后端的桌面版 Douzy（内测中），把链接粘进输入框点"下载"就行：

主页批量下载：把 mode 和 number 两个开关对上 🏠

单条只是试跑，真正的用武之地是整个主页。把link换成作者主页地址，两个字段就决定行为：

link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx mode: - post - mix number: post: 50 mix: 0

• mode决定下什么：post作品、like点赞、mix合集、music原声，可以多选；
• number决定下多少：50表示最近 50 条，0表示全部抓完；
• 默认 5 线程并发，几百条作品挂机一会儿就跑完；
• 跨模式自动去重：同一部作品同时在"作品"和"合集"里也只下一次。

各模式的实现都放在 core/user_modes/ 策略目录里，一模式一个文件，想研究哪条线就进哪个文件。想要更狠的画质，把video_quality从默认的highest改成original，它会多探测一次上传原片，比最高转码档大就优先下原片。

增量下载：让第二次运行只搬新到的包裹 📮

第一次全量搬完，之后不想重来？关键在两个开关。开启database后，SQLite 会当你的搬家台账：下过什么、文件在哪，全记着。再打开increase：

database: true increase: post: true

下次运行自动跳过旧内容、只拉新增。隔一周补一次，本地收藏和博主主页就长期保持同步，追更党最吃这一套。

时间过滤：只收某一段时间的作品 📅

只想存档博主"某次活动期"的内容？配两个日期即可，只下落在区间内的作品：

start_time: "2026-07-01" end_time: "2026-07-31"

格式固定YYYY-MM-DD。按月份做主题收藏、按活动时间做专题归档，都靠这一招。

进阶选讲：直播、评论、热搜和 API 四个扩展 📡

批量玩熟之后，还有几块能力值得解锁。

直播录制：link填直播间地址就生效，主播下播或你手动中断时，已录字节会自动保留为正式文件，不白录一场，FLV 落在Downloaded/{作者}/live/下：

link: - https://live.douyin.com/123456789 live: max_duration_seconds: 3600

评论采集：打开comments.enabled后，每部作品旁多一份*_comments.json，可带二级回复，做内容分析很方便：

comments: enabled: true max_comments: 500

热搜榜与关键词搜索：两行命令把当天热搜或指定关键词的作品列表导出成 JSONL，追热点选题时特别顺手：

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

REST API 服务模式：想把下载接进自己的系统？装两个可选依赖后以服务模式启动，就能用POST /api/v1/download提交链接、用GET /api/v1/jobs/{job_id}查状态：

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

体验细节：这几个地方最顺手 🧾

命名规则能自定义。filename_template默认{date}_{title}_{id}，也支持{author}{year}{month}{type}等变量随意拼，唯一要求是模板里带上{id}防重名覆盖。

目录结构一眼看懂。folderstyle默认按作品建子目录；author_dir可以选nickname、sec_uid或nickname_uid三种作者目录命名，重名博主多的话选第三种。

半截文件不会留在硬盘里。每个文件下完做 Content-Length 比对，不完整的自动清理重试；失败走指数退避（1s、2s、5s），默认重试 3 次，由retry_times控制。

夜里挂机，早上看手机。配置里打开notifications，任务结束经 Bark、Telegram 或企业微信/飞书 Webhook 推送结果，单个推送失败不阻塞下载。

不想盯终端，就看任务列表。桌面版 Douzy 的任务中心把每个任务的成功/失败计数列成卡片，失败项可直接重试，还能一键打开输出目录：

避坑速查：4 个高频痛点的快速处理 🧯

只抓到 20 条就停了→ 原因：翻页触发了风控。→ 一句话解决：配置里确保browser_fallback.enabled: true且headless: false，弹出浏览器后手动过一下验证再继续。

提示 Cookie 失效、要登录→ 原因：Cookie 有时效，过期即失效。→ 一句话解决：重跑python -m tools.cookie_fetcher --config config.yml扫码一次，秒恢复。

下载速度慢→ 原因：并发不够或网络到抖音服务器不稳。→ 一句话解决：调高thread（默认 5），必要时用proxy配代理。

重跑却被跳过、想重新下载→ 原因：程序按"数据库记录 + 本地文件"双重去重。→ 一句话解决：先删目录再删台账记录，例如rm -rf Downloaded/作者名/后执行：

sqlite3 dy_downloader.db "DELETE FROM aweme WHERE author_name = '作者名';"

撕掉快递单，原件已经到家 📦

回到开头那个比喻：水印只是贴在纸箱外的单，不是刻在货物上的。你不需要录屏，也不依赖任何在线解析站——一个开源工具，就能把无水印母版、原声、封面和元数据整整齐齐收进本地。

今天就能动手的第一步：挑一条你一直想留着的视频，照"5 步最快上手"跑一遍。跑通之后，再翻出一个常看的主页丢进去——你会发现，管理抖音内容原来可以这么清爽。

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