抖音批量下载工具完整教程：三步命令跑通批量无水印归档

抖音批量下载工具完整教程：三步命令跑通批量无水印归档

【免费下载链接】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，浏览器窗口可见才能手动验证。

桌面版的进度页会显示已处理条数、成功/失败统计和逐任务事件日志，卡在哪一步一眼就能看出来。

出问题时：三种常见状况的自检清单

如果某个作品想重新下载，要两边都清理：删掉本地对应的子文件夹，再删掉数据库里那条记录。只删一边都不会触发重下——程序是按"数据库记录 + 本地文件"双重判断的。

使用边界与下一步

用三句话收尾：它是免费的、命令行优先的抖音批量下载工具；能无水印批量保存作者主页、合集、收藏夹和音乐；带去重、增量和重试，让重复归档变成一句命令的事。

下一步建议：先拿一个小合集（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