抖音批量下载工具完整教程：三步命令跑通批量无水印归档
【免费下载链接】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
打开抖音 App，逐条点开分享页手动保存 50 个视频——这大概是整理抖音视频时最拖时间的环节。douyin-downloader 是一个免费开源的抖音批量下载工具：把用户主页、合集或单条视频链接贴进去，它就能批量下载到本地、自动去重和重试，适合想长期归档喜欢的作者作品、或给自己收藏夹做备份的人。我在自己机器上完整跑过一遍，下面先带你走最短的跑通路径，再讲几个我常用的场景组合。
跑通篇：三步命令从安装到第一个视频
先确认机器上有 Python 3.8 以上版本，然后克隆代码：
git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader把项目源码拉到本地，注意实际代码在仓库里的 douyin-downloader 子目录中。进入该目录安装依赖：
pip install -r requirements.txt第一条命令负责拉源码，第二条装第三方库，两步顺利的话一两分钟就够。
接着准备配置并完成登录：
cp config.example.yml config.yml python -m tools.cookie_fetcher --config config.yml第一行把示例配置复制成你之后要改的工作文件；第二行会弹出一个浏览器，你手动登录抖音，登录完成后回终端按回车，登录凭证（Cookie）会自动写进配置。Cookie 相当于档案室的门禁卡，没有它只能拿到很有限的数据。
最后打开config.yml，在link字段粘贴要下载的链接，运行：
python run.py -c config.yml一行命令启动，终端里会持续显示进度条，完成后文件落在 Downloaded 目录里。习惯图形界面的话，项目还有内测中的桌面版，粘贴链接点按钮就能用。
这是桌面版的下载页：上方粘贴链接，下方勾选要下载的内容类型（作品、喜欢、合集），点检测后会自动识别链接类型。
不止单条视频：这个工具实际能做什么
跑通之后，最直接的收益是省时间：每个视频"点开、保存、改文件名"的三步都被自动化了，文件名自带发布日期、标题和作品 ID，按作者目录一放就是整齐的。
它的能力范围远不止"存单条视频"：
- 单条作品：视频、图文图集、v.douyin.com 这类分享短链都能直接下
- 批量：作者主页的发布作品（post）、点赞（like）、合集（mix）、音乐（music），也支持下载自己账号的收藏夹
- 附加资源：封面、音乐原声、头像、JSON 元数据，按需勾选一起保存
- 可靠性：优先选无水印源、自动挑最高码率、指数退避重试、完整性校验，不完整的文件会自动清理后重下
- 去重：数据库加本地文件双重判断，重复运行不会下载第二遍
- 扩展项：直播录制、评论采集、热搜与关键词搜索导出、视频转写、完成后推送通知（Bark / Telegram / Webhook）
前两条对大多数人就够用了，剩下的属于想深挖时的选项。
挑一个场景玩起来：三个常用下载组合
场景一：归档某个作者的作品。把主页链接放进link，用mode和number指定类型和数量：
link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx mode: - post number: post: 50上面这段的意思是"下载这位作者主页前 50 条发布作品"，数量填 0 表示不限制。mode里可以写 post、like、mix、music 多种类型，同一作品跨模式不会重复下载。
每个作品一个独立子文件夹，视频、封面、音乐、元数据都在里面，按"日期_标题_作品ID"命名，批量下完就是上面这种整齐的文件列表。
场景二：下合集或单条视频。合集链接（/collection/... 或 /mix/...）直接贴进link就能跑，不用额外配mode；单条视频、短链同理，程序会先自动解析再下载。
场景三：录制直播 🎬。把 live.douyin.com 的链接贴进去，配置录制时长：
live: max_duration_seconds: 3600这里的意思是"最多录 3600 秒"，填 0 则一直录到主播下播；录好的 .flv 存在作者的 live 目录下，中途断了已录的部分也会保留。
这张图是录制开始时选择直播间清晰度的终端画面，选定清晰度后程序就开始拉流保存。
进阶开关：增量下载、时间过滤这些实用项
增量下载是最值得开的一项。打开increase并配合数据库，每次运行只补新作品：
increase: post: true database: true配好之后可以固定周期（比如每周）跑一次，它只取上次之后的新内容，等于接着上次的进度继续收集。
时间过滤用start_time/end_time（格式 YYYY-MM-DD）圈定作品发布区间，适合整理年度回顾或某个专题的资料。
并发与代理：thread默认 5，遇到频繁限流就降到 2~3；网络需要代理时写进proxy，例如http://127.0.0.1:7890。
浏览器兜底（browser_fallback）：翻页被风控限制时，它会自动打开真实浏览器让你人工过验证，专治"只抓到 20 条就停"的问题。记得保持headless: false，浏览器窗口可见才能手动验证。
桌面版的进度页会显示已处理条数、成功/失败统计和逐任务事件日志，卡在哪一步一眼就能看出来。
出问题时：三种常见状况的自检清单
| 症状 | 最可能的原因 | 怎么处理 |
|---|---|---|
| 只抓到 20 条就停 | 翻页被风控限制 | 开启 browser_fallback，浏览器保持可见，手动完成验证后再关窗口 |
| 请求失败或速度很慢 | Cookie 过期或并发过高 | 重跑 cookie_fetcher 重新登录；把 thread 调小 |
| 进度条刷屏重复打印 | 调试日志没静默 | 保持 progress.quiet_logs: true，排错时再临时加 -v |
如果某个作品想重新下载，要两边都清理：删掉本地对应的子文件夹，再删掉数据库里那条记录。只删一边都不会触发重下——程序是按"数据库记录 + 本地文件"双重判断的。
使用边界与下一步
用三句话收尾：它是免费的、命令行优先的抖音批量下载工具；能无水印批量保存作者主页、合集、收藏夹和音乐；带去重、增量和重试，让重复归档变成一句命令的事。
下一步建议：先拿一个小合集（10 条以内）把流程跑顺，再扩展到整个作者主页；批量任务开始前备份一次 config.yml，因为 Cookie 过期是唯一需要手动处理的环节，其余都自动化了。完整参数表和更多问题排查可以看项目内的 README.zh-CN.md 和 config.example.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
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
