抖音无水印下载完整指南：三步跑通 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 是一个开源的无水印下载工具，覆盖单条视频、图集、合集、音乐和博主主页，去水印、去重、重试都自动完成，配置一次之后基本不用管。
项目速览：做抖音无水印批量下载的工具
一句话定位：把你手选的抖音链接变成本地文件库。工具自动挑选无水印的高清源，写出 JSON 元数据，并用 SQLite 记录去重，重复运行不会重复下载。
| 能力 | 说明 |
|---|---|
| 链接类型 | 单条视频、图集、合集、音乐、博主主页、直播间 |
| 无水印源 | 自动选无水印源，original可选原画 |
| 批量与去重 | SQLite 记录历史，磁盘增量跳过已下载 |
| 容错 | 指数退避重试，风控拦截时浏览器兜底验证 |
| 扩展能力 | 评论采集、完成通知推送、视频转写、REST API 服务模式 |
上图是仓库附带的桌面 GUI Douzy（闭测中）的链接下载工作台，基于同一套后端，粘贴链接即可发起任务。命令行用法是主体，下面从它讲起。
准备工作：Python 环境与 Cookie
运行环境：Python 3.8+，macOS、Linux、Windows 都支持。
获取代码并安装依赖：
git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt可选的浏览器兜底：分页被风控时工具会拉起浏览器辅助验证，需要预装 Playwright，额外执行
pip install playwright和python -m playwright install chromium。一个抖音 Cookie：主页批量和风控绕过都需要。仓库自带自动抓取脚本，下一节说明用法。
核心操作：从单条视频到主页批量
先跑通单条视频
复制默认配置并运行自动 Cookie 抓取。会弹出浏览器，登录抖音后回到终端按回车，Cookie 自动写入配置文件：
cp config.example.yml config.yml python -m tools.cookie_fetcher --config config.yml然后给 run.py 传一个视频链接即可下载，文件默认存到./Downloaded/：
python run.py -c config.yml -u "https://www.douyin.com/video/7604129988555574538"-t指定并发数，-p指定保存目录，都可以和上面的参数一起用。
进阶：主页批量与多模式
配置就绪后，把link换成博主主页。mode决定抓什么：post作品、like点赞、mix合集、music原声，可以组合使用。number控制每种模式的数量，0表示全部。完整字段见下一节。
配置与自定义：config.yml 的关键项
link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx # 博主主页 path: ./Downloaded/ # 保存路径 mode: - post # 作品；也可换 like/mix/music number: post: 0 # 0 = 全部；设 50 只下前 50 条 increase: post: true # 增量：已下载过的跳过 thread: 5 # 并发数 video_quality: highest # 最高转码档；改 original 探测原画 # ... browser_fallback、comments、live 等字段省略直播录制、通知推送、转写、REST 服务模式这些冷门字段，在 config.example.yml 里都有独立分区和注释，按需打开即可。
典型场景
把某个博主的主页搬进本地素材库
适合短视频创作者。贴入主页链接，用post模式全量下载。文件按"作者/日期"分类，每条作品附带封面、原声和 JSON 元数据。
增量补抓特定时间段的作品
适合长期跟踪某位博主的人。把start_time/end_time设到目标区间，开启increase，再次运行只下载新增部分。
采集单条视频的评论做分析
适合舆情监控。打开comments.enabled，评论层会以*_comments.json落在视频旁边，情绪分析直接可做。
批量任务成败都能在任务中心里看到，个别作品失败时点重试就行。
排错与调优：无水印下载最常踩的 3 个坑
- 只下到约 20 条作品：平台风控限制了分页。把
browser_fallback.enabled设为true、headless设为false，在弹出的浏览器里手动完成验证，别过早关闭。 - 链接全部失效，疑似未登录：Cookie 过期。重新执行
python -m tools.cookie_fetcher --config config.yml扫码刷新即可。 - 进度输出又噪又重复：默认
progress.quiet_logs: true已静默，调试时临时加-v参数看日志就好。
调优建议：
thread默认 5，弱网可降；retry_times默认 3 次video_quality改original拿上传原片，略慢但画质更高- 直播录制标记为实验功能，先拿短时长直播间试
先跑通单条视频的例子把流程走一遍，再切到主页批量。提醒一下：下载内容仅限个人学习与研究，注意他人版权与隐私；平台更新导致功能失效时，拉取最新代码看看修复。
【免费下载链接】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
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
