douyin-downloader | 开源抖音视频、图集与作者主页批量下载工具

douyin-downloader 是用 Python 编写的抖音下载项目,提供配置文件、命令行入口和增量下载记录,仓库代码采用 MIT 许可。准备使用前,有一个条件必须先看:截至 2026 年 10 月 6 日核对,官方 README 已明确说明多种 CLI 下载模式正受到平台请求验证阻断,因此功能列表中的不少路径目前无法稳定拉取内容。

单视频、图集、合集、音乐、喜欢和收藏等 CLI 路径均在受影响范围,刷新 Cookie 和增加重试次数不能修复这类验证问题。作者主页的作品模式可以尝试 Playwright 浏览器回退,但能否成功仍取决于平台与会话。因此使用前更需要看清这条有限的浏览器尝试路径,以及核心配置项的实际作用。

douyin-downloader 抖音视频、图集与合集批量下载封面
douyin-downloader 下载与本地归档流程概念图(AI 生成)。

Python CLI 与 Douzy 桌面端分开看

Python CLI 当前针对抖音,源码包版本为 2.0.0。项目同时介绍 Douzy 桌面端,桌面端的版本、平台插件和可用功能独立变化,部分批量或高级能力还涉及激活。两套前端和脚本实现相互独立,桌面端的展示界面与功能进度不会自动恢复旧版 Python CLI 的抓取能力。

如果目的是立刻下载一个单视频,当前 README 的阻断说明已经影响选择;不值得先花时间反复换参数。想研究代码、配置,或在已有授权会话中尝试作者作品模式,才继续准备以下环境。

用少量作者作品尝试浏览器回退

CLI 要求 Python 3.9+。在仓库目录安装项目依赖,再准备 Playwright 与 Chromium;以下是源码依赖的安装流程(目标账号能否成功抓取,仍取决于当下的会话与风控状态):

git clone https://github.com/jiji262/douyin-downloader.git
cd douyin-downloader
python -m pip install -r requirements.txt
python -m pip install playwright
python -m playwright install chromium
  1. 复制 config.example.yml 为 config.yml,设置输出目录和作者主页链接。Windows PowerShell 可用 Copy-Item config.example.yml config.yml。
  2. 运行 python -m tools.cookie_fetcher --config config.yml,在打开的浏览器中登录抖音,再回到终端按 Enter 保存 Cookie。Cookie 相当于会话凭据,不放进公开仓库,也不发送给陌生人排错。
  3. 先只选择作品模式,并限制数量。出现平台验证阻断时,停止反复重试,按当前 README 判断这条路径是否仍可尝试。

下面是从官方配置字段整理的小范围示例,YOUR_SEC_UID 要替换为目标作者标识,其他 Cookie 与媒体开关沿用完整配置中的对应字段:

link:
  - https://www.douyin.com/user/YOUR_SEC_UID
path: ./Downloaded/
mode: [post]
number:
  post: 10
increase:
  post: true
redownload_missing_files: true
python run.py -c config.yml

数量设为 10,方便先确认流程与输出;number.post: 0 表示不限制数量,初次尝试不宜直接这样设。命令行的 -u / --url 参数是在配置链接清单后追加新任务,而非替换原配置中的地址。

Douzy 桌面端粘贴抖音链接下载界面
官方 README 展示的 Douzy 链接下载工作区(已脱敏处理隐私,底部版本标号可能早于当前 Release)。来源:https://github.com/jiji262/douyin-downloader/blob/main/img/desktop/001.png

“下载过”和“文件还在”是两回事

增量逻辑同时涉及记录与磁盘文件。迁移目录、手工删除视频之后,只看历史记录,容易误以为内容都已保存完整。官方配置中的几个字段各管一件事:

配置含义适用时要看清
increase.post: true增量处理作者作品,依据本地有效主媒体文件跳过已完成内容保留原目录和文件,才能利用既有结果
increase.post: false对选定范围重新下载,并可能覆盖文件不适合只是补回个别丢失文件的情况
redownload_missing_files: true允许补回已记入历史、但本地缺失的媒体关闭后,数据库有记录的缺失文件可能仍被跳过
number.post限制本次作者作品数量;0 为不限先用小批量确认流程,再考虑更大范围

设置日期范围时,按配置使用 YYYYMMDD 格式,结束日期包含当天。数量、日期、增量和媒体开关一起影响选取与保存结果,排查文件遗漏时须将这几项条件一并核查,切忌单凭终端输出“完成”二字判定落盘成功。

项目可以按开关保存媒体和相关信息。需要备份时,保留实际文件与对应配置、记录;配置文件只说明打算下载什么,本身并不包含视频和图集。不要为了让任务重跑就先清空数据库或整个下载目录。

遇到失败,先分清哪一层出了问题

  • 依赖或浏览器缺失:检查 Python 环境、依赖安装与 Playwright Chromium 是否准备好。
  • 会话失效:按官方工具重新登录更新 Cookie;不过刷新 Cookie 仅处理账号鉴权过期,无法解决平台请求验证拦截。
  • 平台验证阻断:对照 README 的已知限制,不用高并发和反复重试当作修复办法。
  • 文件看似遗漏:检查数量、日期、增量与补缺设置,以及输出目录是否改变。需要更多日志时,可以查看 -v 的详细输出。

README 将直播抓取标为实验性状态,当前仅涉及 HLS 播放列表解析,尚无稳定的整场可播录像产出;同理,源码中的其他命令入口也未必具备同等可用度。

MIT 覆盖项目代码;视频、图集、音乐和账号内容的使用条件另算。项目声明将用途限定在研究与学习等范围,实际保存与二次处理内容时,仍须确保自身具备对应版权或授权许可。

  • 项目与当前限制:https://github.com/jiji262/douyin-downloader
  • 中文说明:https://github.com/jiji262/douyin-downloader/blob/main/README.zh-CN.md
  • 完整配置示例:https://github.com/jiji262/douyin-downloader/blob/main/config.example.yml
  • 桌面端发行入口:https://github.com/jiji262/douyin-downloader/releases
douyin-downloader | 开源抖音视频、图集与作者主页批量下载工具 - 杂货喵
douyin-downloader | 开源抖音视频、图集与作者主页批量下载工具
此内容为免费资源,请登录后查看
M币0
发布平台GitHub
编码语言Python
运行方式Python CLI
项目版本2.0.0(源码)
项目许可MIT
支持系统Windows/macOS/Linux
免费资源
© 版权声明
THE END
喜欢就支持一下吧
点赞3 分享
评论 抢沙发

请登录后发表评论

    暂无评论内容