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

如果你要把一个抖音号的作品整页存到本地,又不想忍受录屏的水印和画质损失,douyin-downloader 就是一个免费开源的抖音无水印下载工具:粘贴链接,视频、图集、合集都能落成无水印原片。照着下面配置一次,你拿到的就是按日期和标题分好文件夹的本地备份。

一张表看懂它能干什么

  • 无水印多档画质:直接取接口的无水印源,video_quality从 480p 到original(探测上传原片,失败自动退回最高转码档)随你选。
  • 主页批量:mode支持post(作品)、like(喜欢)、mix(合集)、music(音乐),一个作者主页的内容整页搬走。
  • 增量与补档:按磁盘上的主媒体文件判断,increase开启后二次运行只补新增;redownload_missing_files管文件被删后是否补下。
  • 时间与数量筛选:start_time/end_time圈定发布时间段(含结束当天),number控制每种模式的条数,0表示不限。
  • 数据延伸:评论采集生成 JSON、--hot-board/--search导出热搜与搜索结果 JSONL、完成后推 Bark / Telegram 通知。
  • 直播录制:live.*可录直播间,属实验功能,HLS 源只保存播放列表,不是可直接播放的视频。
维度手动录屏在线解析网站douyin-downloader
水印与画质带水印,受屏幕分辨率限制依赖站点解析,常要注册无水印,可选最高转码档或原片
批量规模一条条手动录基本只支持单条主页/合集整包,默认 5 线程并发
Cookie 去向不涉及上传给第三方站点只存在本地config.yml
去重补档无无磁盘文件 + SQLite 记录双重判断
附加能力无极少评论采集、热搜导出、完成通知

同仓库还提供图形化的 Douzy 桌面版,粘贴链接即可下载,抖音之外覆盖 TikTok、YouTube 等平台:

三步跑通第一次下载

需要 Python 3.9 以上,Windows、macOS、Linux 都支持。

第 1 步:装依赖

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

拉源码、进目录、装依赖,一次完成。只有想让翻页受限时自动开浏览器兜底,才需要额外补一句pip install playwright加python -m playwright install chromium,没有需要可跳过。

第 2 步:准备配置与凭证

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

第一条把官方模板复制成自己的config.yml,之后只改这份;Windows PowerShell 用Copy-Item config.example.yml config.yml。第二条会自动弹出浏览器,登录一次抖音,回到终端按回车,Cookie(可以理解为抖音发给你的"登录通行证")就写进了配置,全程不用手抄。

第 3 步:跑第一次下载

把config.yml里的link换成目标链接(单条视频或博主主页都行),然后:

python run.py -c config.yml

终端实时显示进度,成品默认进Downloaded/目录,按"作者 / 日期_标题_作品id"归档,-v可打开详细日志。完整字段说明见 config.example.yml。

三个高频场景

把博主主页整包备份下来

目标:某作者的全部作品存进本地。只改三行配置:

link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx mode: - post number: post: 0

post: 0表示不限条数。想只存某段时间的作品,再补start_time: "2025-01-01"和end_time两行即可,日期格式YYYY-MM-DD。

顺手把评论采集下来

目标:每个作品连评论一起落盘,方便后续做内容分析。

comments: enabled: true include_replies: true max_comments: 0

跑完后每个作品目录里多一个*_comments.json,max_comments: 0表示不限条数,回复楼层可用include_replies控制。

不下载,只拉热搜和搜索结果

目标:纯收集数据,不落视频文件。直接用子命令:

python run.py --hot-board 30 -p ./Downloaded python run.py --search "关键词" --search-max 100

第一条把热搜前 30 条存成 JSONL,第二条按关键词搜作品并导出,每行一条 JSON,任何文本工具或脚本都能接着处理。

出问题先自查

现象原因解决
提示登录态失效、大量解析失败Cookie 放久了过期重跑python -m tools.cookie_fetcher --config config.yml
主页只拉到几十条就停API 翻页触发风控保持browser_fallback: enabled: true、headless: false,弹窗里手动过验证
删了本地文件,重跑却显示跳过数据库里还有下载记录把increase.post设为false(重下并覆盖),无需清空数据库
文件缺失不补下redownload_missing_files被关了设为true,缺失或空文件自动重新下载
并发高时失败变多线程数偏大或网络受限thread从 5 调小到 3,网络差时在proxy填代理地址

常见问答

下载一半断网了,要重头来吗?不用。每条任务按retry_times(默认 3 次)自动重试,不完整文件会被清掉重下。

想拿原片画质怎么设?video_quality: original。它会先探测上传原片,比最高转码档大就下原片,探测失败自动退回,代价是每条作品多一次探测请求。

怎么查最近下载了什么?sqlite3 dy_downloader.db "SELECT aweme_id, title, author_name FROM aweme ORDER BY download_time DESC LIMIT 20;"查最近 20 条。

转写文件为什么没生成?依次核对transcript.enabled是否为true、环境变量OPENAI_API_KEY是否有效,图文作品没有音轨,不会产出转写。

速查与下一步

想做的事怎么弄备注
存单条视频/图集link填视频或短链自动解析,默认取最高转码档
主页整包备份mode: [post]+number.post: 0可用start_time/end_time圈时间段
二次运行只补新增increase.post: true按磁盘主文件判断
采集评论comments.enabled: true每作品一个 JSON
热搜/搜索导出--hot-board/--search输出 JSONL
刷新 Cookiepython -m tools.cookie_fetcher一键浏览器获取

相当于给抖音开了个本地存档柜:链接扔进去,文件夹自己长出来 ✅ 用得顺手后,欢迎翻一翻 core/ 里的下载主流程和 docs/ 里的设计文档,发现问题可以提 Issue,顺手修个小 bug 交个 PR 也完全 OK。最后提醒一句:下载的内容请仅用于个人学习、研究或备份,尊重创作者的版权和平台规则。

核心关键词:抖音无水印下载工具;长尾关键词:抖音批量下载、抖音主页备份、抖音评论采集、抖音热搜导出、抖音直播录制

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

延伸阅读

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