抖音无水印批量下载完整教程：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 是一个值得看一眼的免费开源方案。它用 Python 编写，既能单条保存一个视频、一张图集或一首原声音乐，也能对着一个作者的主页做批量下载，配合进度展示、失败重试和 SQLite 去重，属于典型的"装完、配好 Cookie 就能干活"的工具。本文面向没有编程背景的使用者，带你把它跑起来。

它能帮你做什么

存单个视频或图文

场景：你在 App 里看到一条分享链接（https://v.douyin.com/xxxxx/这类短链，或者https://www.douyin.com/video/123456789这类网页直链），想把这条作品原样存下来。做法：把链接放进配置文件的 link 列表，工具会自动识别链接类型，优先挑选无水印视频源，并在可用码率里挑最高清的那档。落地的是一个 mp4 文件，需要的话还能顺带生成封面、原声 mp3 和一份记录标题、作者、发布时间的 JSON 元数据。

存一位作者的全部作品

场景：你想把某位作者长期沉淀的内容归档，或者做素材库、竞品分析。做法：配置里填该作者主页链接（https://www.douyin.com/user/xxxxx），用 mode 字段选择抓取范围——post取发布作品、like取点赞作品、mix取合集、music取使用同一原声的作品；number 字段控制每种模式最多抓多少条，填 0 表示不设上限。同一作者可以同时勾选多种模式，跨模式遇到的重复作品会自动去重，不会下载第二遍。

存图集与音乐

图集作品（多图图文）会按图片逐张保存为 JPG；音乐链接（/music/xxxx）优先下载原声文件，拿不到原声时回退到使用该音乐的第一条作品，保证你至少拿到一份可听的文件。这两类都适合"顺手存下来"的使用方式，配置里加一行链接即可。

🚀 环境准备与首次运行

前置要求只有一个：系统里装好 Python 3.9 或更高版本（Windows、macOS、Linux 均可）。克隆仓库并安装依赖：

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

然后复制一份配置文件：把仓库里的config.example.yml另存为config.yml，后续所有修改都在这份文件上进行。首次运行时你会看到一个带进度条的终端界面：任务总数、已完成数、失败数都在实时刷新，下载过程不需要盯着看，等它自己走完即可。若你后面要用到浏览器兜底（见后文），再补装playwright并执行python -m playwright install chromium下载浏览器内核。

⚙️ 登录态怎么配

抖音的接口要求请求方携带身份信息才能正常翻页和取源，这份信息就是 Cookie——可以理解为浏览器登录后生成的一串"通行证"，没有它，批量抓取会在很早的阶段被拦下。手动从浏览器里复制 Cookie 既繁琐又容易漏项，所以推荐走自动获取路线：

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

这条命令会弹出一个浏览器窗口，你用抖音账号扫码登录，回到终端按 Enter，程序就把所需的 Cookie 项自动写进配置文件。相关的读取、校验与刷新逻辑集中在 Cookie 自动管理模块，你不需要理解它的内部细节。建议：首次配置成功后，留意终端输出的写入提示，确认 config.yml 里的 cookies 段落已填充非空值。

V1.0 还是 V2.0：怎么选

项目文档把能力分成两档：V1.0 稳定版和 V2.0 增强版，两者的分工其实很清晰，按你的主要诉求对号入座即可。

• 诉求一：偶尔保存一两条视频。选 V1.0 流程。它针对单条下载做了专门优化，稳定性高，使用路径就是"改配置里的链接→运行"两步，几乎零学习成本。
• 诉求二：批量下载作者主页、收藏夹内容。选 V2.0 流程。它提供 mode/number 这套批量参数和自动 Cookie 获取，主页全量抓取表现完整；代价是配置项更多、偶发单条视频下载时的接口兼容问题，整体上手难度中等。

一个省事的走法：先用 V1.0 的流程存一条单视频，确认 Python 环境、依赖、Cookie 三样都通了，再切到 V2.0 的批量配置。这样一旦失败，你能很快判断是环境问题还是批量参数问题。

进阶设置值得知道的几项

• 增量下载：把database设为 true 并打开对应模式的increase开关后，工具会在本地 SQLite 里记录每条已下载作品的 ID，下次运行只拉新增内容。长期追更某位作者时，这一步能省掉大量重复劳动。
• 并发控制：thread参数决定同时下载的文件数（默认 5）。网络好、作品多可以往上调，建议别超过 20；频繁失败就往回调。失败的下载会按 1s、2s、5s 的间隔自动重试，retry_times控制重试次数。
• 元数据保存：开启 JSON 选项后，每个作品旁会生成一份_data.json，包含标题、作者、发布时间、播放量等信息，适合后续做内容分析或归档检索。
• 文件夹自动归类：folderstyle默认开启时，下载内容按"作者昵称/模式/日期_标题_ID"的结构落盘，同一作者的所有作品天然聚在一起，几百条作品也不会乱。

踩坑速查

只抓到 20 条左右就停了？这多半是翻页触发了平台风控，不是链接填错。把browser_fallback.enabled设为 true、headless设为 false，再运行一次；当浏览器窗口弹出验证时，手动完成验证后别急着关窗口，让程序自己翻页。

下载中途突然失败，多半是登录态失效了。抖音的 Cookie 有有效期，过期后批量任务会成片失败。处理方式就是重新跑一次前文的 cookie_fetcher 命令刷新登录态，不需要重装任何东西。

速度不理想想提速？调整thread并发数是最直接的手段；如果用的是代理网络，确认配置里的proxy字段填写格式为http://127.0.0.1:端口这类完整地址，代理不通时所有请求都会卡在超时上，看起来就像"很慢"。

想重新下载某个已经存过的作品？注意去重是"数据库记录 + 本地文件"双重判断的：只删文件不动数据库，程序仍会认为它已下载过。需要重下时，把对应的本地文件夹和数据库dy_downloader.db里该作品的记录一起清掉即可。

使用边界

这个项目定位为技术研究与学习交流用途，请把它放在这个框里使用：遵守抖音平台的服务条款，尊重原创内容的版权，不将下载内容用于侵犯他人权益或商业侵权的场景。另外提醒一点客观风险：平台的接口策略会随时间变化，某天抓取能力下降属于正常的技术波动，不必视为工具故障。

写在最后

如果你的需求是偶尔存单条视频，按 V1.0 流程走配置即可当天上手；如果要长期跟踪多位作者、沉淀图集与原声，建议先把 V2.0 的增量下载和文件夹归类两项配好，再开始第一次批量运行。把config.yml里的 link 换成你自己的第一个链接，就是接下来唯一要做的事。

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