抖音视频无水印批量下载:douyin-downloader 完整上手指南
2026/8/28 9:41:27 网站建设 项目流程

抖音视频无水印批量下载: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 编写,靠一份 YAML 配置文件驱动,Windows、macOS、Linux 上都能直接跑。

它适合三类人:想把喜欢的博主作品存下来离线看的普通用户;需要批量素材做二创、混剪的短视频创作者;以及要给账号内容做归档、顺手留下标题、点赞数、作者这些元数据 JSON 的运营人员。

几个让批量任务更省心的机制:下载记录写进本地 SQLite 数据库,重复运行会自动跳过已有作品;开启增量下载后,博主更新了几条就只拉几条;请求被限流或遇到验证码时,程序会自动弹出浏览器窗口,你手动过一次就能接着跑,不用从头再来。

核心能力总览

先用 30 秒看完它最拿手的四件事,再决定要不要往下读。

  1. 原始文件无水印下载:直接调抖音接口取回原始视频、图片和原声音频,不是录屏或转换站二次压缩的产物,拿到的就是平台存储的那档画质。
  2. 主页级批量下载link填用户主页地址即可,发布的作品、喜欢的列表、创建的合集、音乐(原声)四类内容都能批量拉取,thread控制并发线程数。
  3. 数据库防重复 + 增量:本地 SQLite 记录每个作品的 ID,再次运行自动跳过;increase开启后只补下载新增内容。
  4. 失败自动恢复:网络抖动、限流导致的失败会自动重试;需要人工处理验证码时,程序把任务交给浏览器窗口,处理完继续下载。

V1.0 与 V2.0 版本怎么选

仓库提供两条入口脚本,先分清适用场景,能少走一半弯路。

  • V1.0DouYinCommand.py(稳定版):配置文件驱动,单个视频、图集、主页批量、直播都经过验证可用,日常使用首选。
  • V2.0downloader.py(增强版):支持--auto-cookie自动获取登录态、异步并发和智能重试,用户主页下载完全正常;但单个视频下载目前存在 API 返回空的已知问题。

一句话:下单个视频或求稳,用 V1.0;要自动 Cookie、高并发和增量,下载整个主页用 V2.0。

⚡ 快速上手:安装、Cookie 与首次下载

这一节带你从零走到第一个无水印视频落盘,总共就三条命令。

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

把仓库拉到本地并装好 Python 依赖,环境要求 Python 3.9+。

  1. 拿登录态(Cookie)
cp config.example.yml config.yml python cookie_extractor.py

程序会弹出浏览器窗口,扫码登录一次抖音账号,Cookie 自动写回配置,之后基本不用管。若提示缺 Playwright,先执行pip install playwrightplaywright install chromium再试;不想装浏览器的话,也可以跑get_cookies_manual.py,按图文引导从开发者工具复制 Cookie。

  1. 下载第一个视频:把config.ymllink改成单条视频链接(v.douyin.com短链或douyin.com/video/直链都行),然后运行:
python DouYinCommand.py

进度条走完,打开Downloaded/目录,视频、封面、原声音频和元数据 JSON 已经按作品分好文件夹了。

批量下载配置说明:主页作品一次下完

这一节把主页批量下载的几个关键配置项讲透,照着改就能跑。

config.yml改成下面这样:

link: - https://www.douyin.com/user/你的主页链接 mode: [post] number: { post: 0 } # 0 表示不限制数量 thread: 5

mode决定下哪几类内容:post是发布的作品,like是 ta 喜欢的,mix是 ta 创建的合集,可以写成多选;number各项填 0 就是全量,填数字则只下最新的 N 条。运行python DouYinCommand.py后,终端里每个作品一行状态,多线程序列拉取,结束时自动汇总成功、失败、跳过的数量。

下完之后文件不是堆在一个文件夹里的,目录会自动分层:

  • Downloaded/作者名_用户ID/
    • post/:发布的作品,每个作品一个独立文件夹
    • like/mix/:喜欢的作品与合集,按mode生成
    • 每个作品文件夹里:.mp4视频、_cover.jpg封面、_music.mp3原声、data.json元数据
  • 不想建这么多文件夹,把folderstyle改成False,文件直接平铺保存

进阶玩法:直播、音乐与时间过滤

批量下载之外的几个用法,按需求挑着用。

  • 🔴直播录制:把直播间地址直接作为链接传入,程序解析后录制直播流,断线自动重连、分段保存:
python DouYinCommand.py --link "https://live.douyin.com/直播间ID"
  • 音乐(原声)收藏link指向douyin.com/music/页面,number.music控制拉取多少条用了这首音乐的作品,适合按 BGM 收集素材。
  • 按时间筛选start_time/end_timeYYYY-MM-DD,只下指定时间段内的作品,比如只留某活动期间的内容。
  • 追更模式increase.post: true配合数据库使用,博主更新几条就只下几条,定期跑一次即可保持本地库最新。

常见问题与解决办法

下载卡住时先来这里对照,多数问题有现成解法。

Cookie 失效或提示重新登录怎么办

Cookie 有有效期,重新跑一次python cookie_extractor.py扫码登录即可,程序会覆盖旧值写回配置。

V2.0 下载单个视频没有结果怎么办

这是当前的已知 API 问题。换 V1.0 的DouYinCommand.py即可,或者把该视频所在的主页用批量模式下载。

批量下载中途变慢或失败增多

多半是触发了限流。先把thread调小一点,程序会自动重试;如果弹出了验证码浏览器窗口,手动完成验证后任务会继续。

重复运行会不会重复下载

不会。database: True时,已下载作品 ID 记在本地 SQLite(data.db)里,二次运行自动跳过;开启increase后更是只补新增内容。

上手三步与注意事项

把前面的内容压缩成三个动作,按顺序执行就能开始第一次批量下载。

  1. 克隆并安装:git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader,再pip install -r requirements.txt
  2. 配置 Cookie:python cookie_extractor.py扫码登录一次
  3. 填链接跑任务:link里放视频或主页地址,python DouYinCommand.py开始下载

最后提醒一句: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

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

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

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

立即咨询