ARTICLE · INTELLIGENCE

战地情报 · 详情页

来自尧图项目组的一线实战观察与深度解析

抖音无水印下载完整指南:douyin-downloader 从零到批量归档

抖音无水印下载完整指南: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

手机里存了 200 多条带平台水印的视频截图,想发公众号还得一张张 P 掉?douyin-downloader 是一个免费的开源 Python 抖音无水印下载工具,把视频、图文、合集、音乐直接存成本地干净文件,并自动去重、记历史,适合运营、创作者和需要备份素材的个人用户。

桌面端支持按内容类型勾选下载范围

三条命令装好环境,扫码登录拿 Cookie

环境要求 Python 3.9+,Windows、macOS、Linux 都支持。装好依赖后跑一次 Cookie 采集脚本,浏览器弹出后扫码登录抖音,回到终端按 Enter,Cookie 会自动写进config.yml,全程不用手动去开发者工具里扒 Cookie:

git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader python -m pip install -r requirements.txt python -m pip install playwright && python -m playwright install chromium cp config.example.yml config.yml python -m tools.cookie_fetcher --config config.yml

看到浏览器成功登录、终端提示 Cookie 已保存,说明登录状态配置完成。Cookie 后续失效时,把最后一条命令再跑一遍就行。

同项目还提供 Douzy 桌面版,支持抖音、YouTube 等多平台

无水印下载单个视频和图文

把config.yml里的link换成抖音 App 里复制出来的分享短链(https://v.douyin.com/...这类),然后运行:

python run.py -c config.yml

命令行版会先解析短链、再拉取作品数据,最终存下无水印的 mp4。文件落在path指定的目录,文件名带作品发布时间和标题,不用自己改名。

一条命令批量下整个博主主页,按日期筛选

批量下载是这个工具最省时间的能力。link换成博主主页地址(https://www.douyin.com/user/...),运行同一条python run.py -c config.yml,工具会自动翻页拉取主页作品并并发下载。以 5 个并发为例,一位发了 200 条视频的博主,跑完通常在十几分钟内结束,每条视频、封面、元数据都各归各位。

命令行版覆盖的内容类型包括:

  • 视频、图文(note)
  • 主页作品(post)、喜欢(like)、合集(mix)、音乐(music)
  • 日期范围筛选与数量限制

需要提醒的是,抖音接口风控目前会影响单视频、合集、音乐、点赞和收藏等接口;主页作品可以开启浏览器兜底(默认配置 中browser_fallback.enabled默认为true),但不保证每次都成功。

增量下载怎么用:SQLite 去重,重复运行不重下

第二次跑同一个博主时,工具会查本地的 SQLite 下载库和磁盘上的文件,只下载没落盘的那部分——这就是常说的断点续传式补下。行为由两个配置项决定:

increase: post: true # 跳过已下载作品 redownload_missing_files: true # 磁盘文件缺失时补下

想强制重下时把increase.post改成false即可,不需要清空数据库。每条作品的下载记录还会追加到download_manifest.jsonl,方便事后核对哪条作品、存在哪个目录。

配置速览:5 个关键字段控制无水印下载行为

完整字段见 config.example.yml,日常最常用的就这 5 个:

path: ./Downloaded/ # 保存目录 number: post: 0 # 下载数量,0 表示不限 start_time: 2025-01-01 # 只下这个日期之后的作品(YYYY-MM-DD) end_time: 2025-06-30 # 只下这个日期之前的作品,含当天 video_quality: highest # highest / original 原画 / 1080p 等 thread: 5 # 并发数,普通网络 3~5 够用

命令行还能临时覆盖配置,不用改文件:-u追加链接、-p换保存目录、-t换并发数、-v打开详细日志,全部参数看python run.py --help。

运营小陈:把博主 200 条作品变成每周自动更新的素材库

  • 把link配成目标博主主页,start_time填 2025-01-01,thread: 5
  • 首次运行python run.py -c config.yml,批量拉下全部符合条件的作品
  • 每周重跑同一命令,已下载的自动跳过,只补新增内容
  • 打开download_manifest.jsonl按发布时间和标签盘点素材

一周花五分钟重跑一次,素材库就能一直保持最新。

按作品、喜欢、合集、音乐勾选下载范围

Cookie 过期或主页只抓到几条,怎么办

  • Cookie 失效:重新运行python -m tools.cookie_fetcher --config config.yml,扫码即恢复。
  • 主页只获取到少量作品:保持browser_fallback.enabled: true和headless: false,在弹出的浏览器里手动完成验证后继续下载。
  • 想查日志:python run.py -c config.yml -v,详细日志会打印到终端。

合规说明

本项目仅供个人学习与研究使用,请遵守平台服务条款与版权法规,尊重内容创作者的劳动成果,勿将下载内容用于商业用途。

下一步:克隆仓库装好依赖 → 跑一次tools.cookie_fetcher登录 → 在config.yml里填第一条链接,运行python run.py -c config.yml。

【免费下载链接】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),仅供参考

RELATED READING

延伸阅读

更多一线实战笔记与深度复盘,助您持续精进