☰
抖音批量下载完整指南:无水印归档创作者主页与收藏夹,3 条命令跑通第一次下载
2026/10/9 1:55:18 网站建设 项目流程

抖音批量下载完整指南:无水印归档创作者主页与收藏夹,3 条命令跑通第一次下载

【免费下载链接】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 是一款免费开源的抖音批量下载工具,桌面端名叫 Douzy。它能无水印保存视频、图文、合集和音乐四类内容,支持把创作者主页整体归档、关注列表增量收集、收藏夹完整备份,并用 SQLite 记录下载历史实现去重。这篇指南带你看清它的核心能力,从安装、拿到登录凭证,到 4 个最常用的批量下载场景,一步步走完。

Douzy 桌面版把命令行后端包装成图形界面:粘贴链接自动识别类型、多链接排队、任务状态跟踪、本地作品档案都在界面里完成。它默认优先选择无水印源,命令行和桌面版共用同一套下载逻辑。想读源码的话,各下载模式的策略实现在 core/user_modes/ 目录,登录凭证相关逻辑在 auth/ 目录。

第一次抖音批量下载要敲的 3 条命令

要达成的目标:把第一个作品落到本地磁盘。整个过程只依赖 Python 3.8 或更高版本,Windows、macOS、Linux 都支持。

第一步,把代码拉下来并装依赖:

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

第二步,复制配置并获取登录凭证。工具采用 Cookie 认证,推荐用内置工具自动获取,不用手写:

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

配置不用背,第一次先认这几个字段:link是下载目标,path是保存目录,mode决定内容类型(post 作品、like 喜欢、mix 合集、music 音乐,登录后还有 collect 收藏),number给每种类型设数量上限、填 0 表示全要,thread和retry_times分别是并发数和失败重试次数。另有video、cover、music、json四个开关控制是否保存视频本体、封面、背景音乐和元数据;progress.quiet_logs设为 true 能让进度阶段日志更安静。全部字段可对照 config.example.yml 查看。需要接口化集成时,加--serve参数即可启动 REST API 服务。

做完得到:path指定的目录里出现作品文件,SQLite 数据库留下下载记录——这是后面所有"只补新增"能力的基础。

归档单个创作者的全部作品:用 post 和 mix 模式抓主页

目标是把一位创作者的视频、图文和合集全部存下来。做法分两步:

  • link填该作者的主页链接,mode写[post, mix],number.post填想要的条数,0 代表不限量;
  • 把increase.post和increase.mix都设为true开启增量。

产出是该作者根目录下按作品分文件夹,视频、封面、音乐、JSON 元数据齐全,下载记录同步写入 SQLite。之后同一配置重复运行,只会补新发布的内容,老作品直接跳过。

不想逐个复制主页链接的话,有两条路:Douzy 桌面版左侧的"关注"面板可以一键同步账号关注列表,给每位创作者加备注、筛出"有新作品"的账号后对单个账号发起下载;命令行用户则把多个作者主页链接一起写进link,再配合increase: true定期执行,就是一个持续追加、不重复下载的增量收集流水线。

备份收藏夹:collect 和 collectmix 两种模式

目标是自己收藏的抖音视频和系列合集做个完整备份。link填自己主页的收藏夹链接(/user/self?showTab=favorite_collection),然后按内容类型二选一:mode用collect下载收藏的视频,用collectmix下载收藏的系列合集。

这三个坑要提前知道:

  • 这两种模式基于登录 Cookie 对应的账号,没登录或 Cookie 不是目标账号就会跑错数据;
  • 必须单独使用,不能和 post、mix、like 等模式写在同一个mode列表里;
  • 它们不支持增量跳过,每次运行都按当前收藏内容走一遍。

产出:收藏内容分别按collect、collectmix子目录归档,结构跟随收藏夹,方便回头慢慢翻。

给每个作品挂上评论和语音转写,做内容分析

目标是让作品不止留个视频文件,还留下能直接分析的数据。两组开关按需打开:

  • 评论采集:comments.enabled设为 true,max_comments限制每条作品抓取的评论数(0 为不限),include_replies控制是否抓二级回复;
  • 语音转写:transcript.enabled设为 true,默认模型是gpt-4o-mini-transcribe,API 密钥建议放在OPENAI_API_KEY环境变量里,实现细节可看 core/transcript_manager.py。

只想要某个时间段的作品时,再用start_time和end_time(格式YYYY-MM-DD)做筛选。产出:每个作品目录里多出*_comments.json评论文件,以及 txt 和 json 两种格式的转写文本,视频、数据、文本一次备齐。

看懂目录命名规则,翻车了按这张清单排查

默认开启folderstyle时每个作品有独立文件夹,落盘结构长这样:

Downloaded/ ├── download_manifest.jsonl └── 旅行摄影日记_MS4wLjAB.../ └── post/2026-06-15_跟拍攻略_734123.../ ├── video.mp4、cover.jpg、music.mp3 └── info.json、_comments.json、transcript.txt

文件名由filename_template控制,默认{date}_{title}_{id},可用变量有{id}、{title}、{author}、{author_id}、{date}、{year}、{month}、{day}、{time}、{timestamp}、{type}、{mode}。模板里必须包含{id},否则不同作品可能撞名覆盖。作者目录层由author_dir决定:nickname是纯昵称,sec_uid是稳定用户 ID,nickname_uid是"昵称_ID"组合——重名多的重度用户选后者。每个作品目录的info.json保存标题、描述、发布时间、点赞数、评论数、作者信息等元数据,评论和转写产物也落在同目录,归档检索都方便。

日常踩坑基本是这四类,对号入座:

  • 下载慢,或只拿到 20 条左右就停:多半是分页接口触发了风控或网络不稳。把browser_fallback开启且headless设为 false,在弹出的浏览器里手动完成验证;thread降到 3 左右;必要时配置proxy。
  • Cookie 失效、任务频繁失败:登录状态过期了,重新跑一次python -m tools.cookie_fetcher --config config.yml,建议每周检查一次。
  • 文件名重名、作者目录混乱:模板缺{id}或两位作者昵称相同。filename_template补上{id},author_dir改为nickname_uid,保持folderstyle为 true。
  • 磁盘空间不够:用start_time、end_time圈定时间范围,用number.post等限制条数,定期清理或迁移到外部存储。

把无水印源选择、去重、元数据、文件组织这几件麻烦事打包成一个工具后,单条链接和整页主页的归档方式是一致的,粘贴链接就能开始。请仅将它用于个人学习、研究与备份目的,尊重创作者的合法权益。

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

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询