告别逐个右键保存，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，专攻"抖音视频批量下载"这件事：无水印视频、原声音乐、高清封面和作品信息一次收齐，单条链接、整个主页、合集甚至直播都能处理。下面这篇完整实操记录，会带你从安装环境一路跑到批量下载，再补几个日常省时间的配置技巧。

先看收获：一次下载后，你手里会留下什么

与其先讲一堆概念，不如直接看结果。用这个工具下载某个博主的作品后，本地会自动生成一套清晰的目录，大概长这样：

Downloaded/ └── 某位博主/ └── 2026-06-15_一条舞蹈教学_730.../ ├── video.mp4 # 无水印视频 ├── music.mp3 # 独立保存的原声音乐 ├── cover.jpg # 高清封面图 └── info.json # 作品元数据

每个作品一个子文件夹，文件名默认是"日期 + 标题 + 视频ID"的组合，谁是谁一目了然。info.json里记录了标题、发布时间、点赞评论数、话题标签这类信息，相当于给每个视频配了一张"身份证"。以后想按主题归档，或者把收藏夹整理成个人素材库，都不用再对着满屏乱码文件名发愁。

能力边界：从单条视频到整页作品，再到直播和评论

这个项目不只是一个"下载器"，更像一套完整的抖音内容管理工具。它能做的事包括：

单条链接下载：粘贴任意视频或图文链接，直接落盘；
主页批量下载：给定用户主页地址，把作品、喜欢列表、合集分别拉取；
直播录制：进入直播间后实时录流，主播下播自动收尾；
评论采集：按作品抓取评论，支持二级回复，输出结构化文件；
热搜与搜索：抓热搜榜、按关键词拉作品；
REST API 模式：以服务方式运行，方便接到自己的自动化流程里。

下载的数据不是从页面"录"下来的，而是直接解析出原始无码流地址，所以画质和原声都保得住。如果更喜欢图形界面，项目里还附带了桌面版 Douzy，左侧导航可以直接管理关注、任务和作品档案，普通用户上手几乎零门槛。

跑起来只需要三件事：克隆、装依赖、建配置

开始前先确认电脑上有 Python 3.8 或更高版本（终端输入python --version就能看到）。然后执行下面三条命令，把项目拉到本地并装上依赖：

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

如果pip install因为网络原因卡住，可以换成国内镜像源，比如pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple。

装完后，把示例配置复制一份，作为自己的配置文件：

cp config.example.yml config.yml

打开config.yml，可以看到一整页可调参数。首次使用建议保持默认，只改动两个地方：把link换成你想下载的链接，把path换成保存目录。下面这份是最小可用配置：

link: - https://www.douyin.com/video/730xxxxxx path: ./Downloaded/ music: true cover: true json: true

后面三行表示视频之外，同时把原声音乐、封面图和元数据也一起存下来——这也是"抖音音乐封面下载"需求最省事的实现方式。

登录这一关：Cookie 的两种获取方式与安全边界

抖音的部分接口需要登录态，项目靠 Cookie 来维持。获取方式有两种，推荐第一种：

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

运行后会弹出一个浏览器窗口，用手机抖音扫码登录，工具会自动把登录产生的 Cookie 加密写进配置文件，全程不用手动复制粘贴。

如果不方便扫码，也可以打开config.yml，在cookies:段手动填入浏览器里抓到的对应字段。需要说明的是，这些 Cookie 只存在你自己电脑的配置文件里，不会上传到任何服务器，用完随时可以删除重来。

第一次下载：用单条链接验证整条链路

配置就绪后，先拿单条视频验证一下整条流程是否通畅：

python run.py -c config.yml

工具会自动读取配置里的链接，解析作品信息、排队下载。界面上能看到每一步的事件日志，比如"正在解析链接""已提交下载请求"，右侧会实时统计成功和失败的数量。

第一次跑通后，去刚才设置的保存目录里看一眼：视频、音乐、封面、JSON 应该都齐了。这一步验证的不只是工具本身，也顺带确认了 Cookie 有效、网络通畅，之后批量操作才能放心交给它。

批量玩法：把博主主页和关注列表的作品一次性搬空

单条验证通过后，就可以体验核心功能了。把配置文件里的link换成某位博主的主页地址，然后指定下载数量和模式：

link: - https://www.douyin.com/user/MS4wLjABAAAAxxxxxx mode: - post number: post: 50

mode决定下载哪类内容：post是主页作品，like是公开的喜欢列表，mix对应合集；number里的数字表示最多取多少条，填 0 表示全部。比如上面这份配置，会把这位博主最近 50 个作品全部拉下来。

如果你关注了不少博主，桌面版里还提供"关注列表同步"：把账号的关注列表导进来，想搬谁的资料，点一下下载按钮就行，不用一个个复制主页链接。

日常参数一档配齐：自动去重、时间过滤与文件命名

用一段时间后会发现，真正提升效率的是下面这几组配置。

重复下载自动跳过。项目内置了 SQLite 数据库记录每次下载的作品 ID。再次下载同一博主时，它会把已存在的作品识别出来直接跳过，只补新增内容。对应的配置是：

database: true increase: post: true

打开增量模式后，把它当成一个"订阅更新"工具用：博主每发新作品，跑一次命令就能拿到最新的，不会重复浪费流量和磁盘。

按时间范围裁剪。只想保存某个时间段的内容时，填上起止日期，工具会过滤掉范围外的作品：

start_time: "2026-01-01" end_time: "2026-06-30"

文件命名随你定制。文件名和子目录名都支持模板变量，比如{date}_{title}_{id}、{author}、{type}等，项目里可以查看全部可用变量列表。

保存下来的所有作品会进入"作品档案"，可以按作者、标题关键词和发布时间筛选，方便日后查找或整体导出。

进阶用户还可以顺手打开视频转写（生成字幕文本）、下载完成通知（Bark / Telegram / Webhook），或者以 REST API 服务模式运行，把下载能力嵌进自己的脚本里。这些功能都在config.yml里有对应的配置段，按注释打开即可。

高频问题处理记录：403、只抓20条、下载中断与直播

日常使用中难免碰到几个坎，这里把最常见的四种情况和处理办法记下来。

下载报 403 或"未登录"。通常是 Cookie 过期了，有效期一般在 7 到 15 天。重新运行一次cookie_fetcher扫码刷新即可，养成每周刷新一次的习惯最省心。

明明有几百条作品，只抓到了 20 条。这是抖音翻页风控的典型表现。检查配置文件里是否开启了浏览器兜底：

browser_fallback: enabled: true headless: false

开启后遇到风控会弹出浏览器窗口，手动完成一下验证再让它继续，别急着关窗口。

批量下载慢或中途中断。可以试试调低线程数（默认 5），或者把批次缩小，一次下载 50 到 100 个。配合增量去重，中断后重新运行命令，已完成的会自动跳过、接着下载没完成的。

直播相关的问题。下载直播链接时，工具会先解析出直播间信息，再按清晰度选择视频流地址录制。

直播录制默认录到主播下播为止，如果想限制时长，可以在live:配置段里设置max_duration_seconds。

结尾：今天就能做的第一步，外加一条使用提醒

现在可以动手了。建议的路线是：先按上面的命令克隆项目、装好依赖，用单条视频链接跑通第一次下载，再试着批量拉一个博主的主页作品，最后把去重和时间过滤配上。整个过程大概半小时，之后你就有了一套属于自己的抖音内容备份流程。

最后说一句：这类工具请只用于个人学习、备份和存档，不要用来搬运他人作品做二次发布或商业用途。尊重创作者的付出，收藏是为了方便自己回顾，而不是拿去分发。

项目地址：https://gitcode.com/GitHub_Trending/do/douyin-downloader ，安装入口就是上文的三条命令。祝你早日把喜欢的抖音内容稳稳收进本地。

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

企业官网建设流程全解析