douyin-downloader 抖音视频无水印批量下载完整指南：从单条到主页追更-平芜编程栈

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 是一款免费开源的抖音无水印下载工具，支持单条视频、图文、作者主页批量下载、合集与音乐原声，全程在本地运行，不产生任何费用。本文按"先跑通、再配置、后排障"的顺序展开，每条命令都可以直接复制执行，所有配置字段都附有一句话说明，读完即可独立完成从单条保存到主页追更的完整流程。

三条命令下出第一条无水印视频

整个过程不需要写代码，分为安装环境、准备登录凭证、执行下载三步。

第一步：获取源码并安装依赖

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

第一条命令把项目源码拉取到本地，第二条进入项目目录，第三条安装运行所需的全部 Python 依赖。等 pip 的进度条走完、没有红色报错输出，环境即准备完毕。

第二步：扫码获取访问抖音的 Cookie

python cookie_extractor.py

该命令会自动打开浏览器窗口，你用抖音 App 扫码登录一次，程序把 Cookie（记录登录状态的凭证字符串）写入配置文件。终端提示 Cookie 提取成功，说明登录凭证已经就绪。

第三步：贴一条链接，下载第一条视频

python downloader.py -c config_simple.yml -u "https://v.douyin.com/xxxxxx"

工具解析这条短链，自动挑选无水印的高清视频源开始下载。判断成功的方式：终端打出"下载完成"，并且Downloaded/目录里同时出现视频文件和封面图片。

如何批量下载整个作者主页

把作者主页链接填进link，用mode指定要发布的作品还是点赞过的作品，用number限制抓取数量：

link: - https://www.douyin.com/user/你的主页ID mode: [post] # post=发布作品，like=喜欢作品 number: {post: 50} # 只取最近50个，0表示全部 path: ./Downloaded/ # 保存目录

保存配置后运行python downloader.py -c config_simple.yml，终端会实时刷新每个任务的进度条和耗时统计。文件按"作者 → 类型 → 日期"三级目录归档，每个作品单独一个文件夹，方便事后检索。

如何配置增量更新只追新内容不重复下载

下载过的主页再次运行时，工具会借助 SQLite 数据库（本地单文件数据库）记录历史，自动跳过已有文件，只搬运新增作品：

increase: post: true # 只下载新增作品 database: true # 增量依赖数据库记录 start_time: "2025-01-01" # 只看该日期之后发布的

隔几天运行一次，它就充当追更助手。任务列表里出现"跳过已存在"的统计项，就是去重逻辑在生效。

如何整集获取长系列合集

把合集页链接直接写进link，工具自动识别合集类型并遍历其下全部作品：

link: - https://www.douyin.com/collection/合集ID number: allmix: 0 # 0表示合集下作品全收

allmix控制合集内作品的抓取上限，设为 0 表示不设限。

如何关闭多余资源只保留视频本体

不需要的附加资源直接关掉对应开关，既省磁盘也提升速度：

music: false # 不下载背景音乐 cover: false # 不下载封面 json: true # 保留元数据JSON，方便归档

常用配置字段速查

配置项	实际影响	参考取值
`link`	下载链接列表，可填多条	视频/主页/合集链接
`path`	文件保存目录	`./Downloaded/`
`mode`	主页链接对应的下载模式	`post`，需要点赞作品时加`like`
`number.post`	主页作品抓取上限	`0`全量，或按需定值
`increase.post`	是否仅抓取新增作品	追更场景填`true`
`database`	开启 SQLite 去重	`true`
`thread`	并发线程数	`5`
`retry_times`	单条失败后的重试次数	`3`

下载常见问题与一行解法 🔧

提示登录失效或抓不到作品→ 抖音登录态有时效，过期后接口不再返回数据 → 重跑python cookie_extractor.py刷新 Cookie。
主页只能抓到 20 条→ 翻页频率过高触发了风控 → 把thread降到 2~3，隔一段时间再运行。
个别视频反复失败→ 作品已被删除或设为私密，属正常现象 → 无需处理；若只是限流，retry_times: 3会自动重试。
下载明显变慢或超时→ 网络波动或被限流 → 在配置中加proxy字段改走代理。