☰
抖音无水印批量下载完整指南:3步保存博主主页全部作品
2026/10/7 2:03:03 网站建设 项目流程

抖音无水印批量下载完整指南: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 是一个 Python 开源项目,专门做抖音无水印批量下载:给它一个主页链接,它帮你把作品、图集、合集、音乐一条条抓下来,自动去重、自动重试、自动按发布时间整理目录。

它给你的核心价值:

  • 🎯无水印原片:优先拉取无水印地址,支持选原画/最高转码档画质
  • 🚀主页批量抓取:作品、点赞、合集、音乐四种模式,数量可限可不限
  • 💾SQLite 去重:下载历史落库,重复运行只补新内容,不浪费流量

它解决什么问题

手动存视频的痛,基本都在这几张表里:

手动做法真实代价
手机本地保存带水印,画质被压缩
找解析网站链接三天两头失效,隐私没保障
一条一条下载博主发了 500 条作品,手酸到放弃

douyin-downloader 的思路是把重复劳动交给程序:

  • 批量:一个主页 URL 顶 500 次手动点击,number字段想全量就全量
  • 可控:按日期范围、按数量上限筛选,不是无脑全拉
  • 抗折腾:内置重试、限速、并发队列,网络抖动不会让整批任务崩掉
  • 可追溯:每个作品生成独立文件夹 + JSON 元数据 +download_manifest.jsonl清单,随时能查「我到底下了什么」

下图是配套的 Douzy 桌面端抖音主页任务配置界面,命令行版的能力(作品/喜欢/合集/音乐四种模式、数量上限、日期范围)与之对应:

⚠️ 先说个实话:2026 年起抖音风控升级,CLI 对部分接口(单视频、合集、音乐、点赞等)会被拦截。项目提供了Playwright 浏览器兜底(browser_fallback),用真实浏览器环境去绕过,成功率视风控状态而定;日常大批量场景建议配合桌面端使用。下面流程依然完整可跑通「主页作品批量下载」主线。

三步跑通

第 1 步:准备环境并安装依赖

要求Python 3.9+(Windows / macOS / Linux 均可):

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

最后两条是为浏览器兜底安装 Chromium 内核,只需要装一次。

第 2 步:配置 Cookie(下载的关键)

Cookie 就是你在抖音网页版登录后浏览器携带的身份凭证,有它 API 才认你是「已登录用户」:

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

运行后会自动弹出浏览器,在浏览器里登录你的抖音账号,回到终端按回车,Cookie 就自动写进config.yml了,不用手动复制任何字段。

第 3 步:填入链接,首次运行

打开config.yml,把link换成目标博主的主页地址:

python run.py -c config.yml

看到进度条滚动、终端打印完成统计,你就跑通了第一次批量下载。想查全部命令行参数:python run.py --help。

能做什么

按你的使用场景对号入座,能力都在config.example.yml里有对应开关:

你的场景对应能力关键配置
存一个博主全部作品mode: [post]主页批量抓取number.post: 0(0 = 不限)
只要某段时间的更新时间范围筛选start_time/end_time(YYYY-MM-DD)
只下某几个置顶/最新作品数量上限number.post: 10
顺手收集 BGM音乐模式mode: [music]
抓博主点赞列表点赞模式mode: [like]
视频 + 封面 + 元数据全套附带产物开关music/cover/avatar/json
定时补新,不重复下载增量下载increase.post: true+database: true
把视频转成文字稿可选 Whisper 转写transcript.enabled: true

所有模式共用同一套并发、重试、限速机制,也都能按模式单独设置数量与增量开关——配置粒度是「按模式」的,不会互相干扰。

一次完整操作

以「保存某博主 2026 年以来的全部作品,视频 + 封面 + 元数据,增量执行」为例。

1. 配置(config.yml核心片段):

link: - https://www.douyin.com/user/你的目标主页链接 path: ./Downloaded/ mode: [post] number: post: 0 # 0 = 全量 start_time: 2026-01-01 end_time: "" video: true cover: true json: true music: false thread: 5 # 并发数 retry_times: 3 # 失败重试 database: true # SQLite 去重 increase: post: true # 已下载过就跳过 video_quality: highest

完整字段注释(含画质档位、命名模板、浏览器兜底等)都写在 config.example.yml 里,中文注释,照抄改值即可。

2. 运行:

python run.py -c config.yml

3. 得到的结果:按「作者 → 日期_标题_作品ID」自动归档的目录,结构大致如下:

Downloaded/ ├── download_manifest.jsonl # 全量下载清单,每行一条 JSON └── 博主昵称/ └── post/ └── 2026-03-15_作品标题_aweme_id/ ├── 2026-03-15_作品标题_aweme_id.mp4 ├── 2026-03-15_作品标题_aweme_id_cover.jpg └── 2026-03-15_作品标题_aweme_id_data.json

日期取的是作品发布时间而不是下载时间,回看整理时一目了然。再次运行同一配置,增量模式会自动跳过库里已有的作品,只补新发布的。

进阶与调优

  • 调画质:video_quality支持original(探测上传原片,失败自动退回最高转码档)、highest(默认)、lowest(省流量),也可指定1080p/720p等,匹配不到自动降级。原片有时比转码档大数倍,注意磁盘空间。
  • 调并发:thread: 5是默认值。家庭宽带建议 3~5,企业网络可到 8~12;别盲目拉满,风控场景下高频请求反而更容易被拦。
  • 调命名:filename_template/folder_template支持{date} {title} {author} {id} {year}等变量,模板里必须保留{id}防止重名覆盖。
  • 浏览器兜底:browser_fallback.enabled: true+headless: false,翻页被风控拦截时会用真实浏览器补数据;弹窗出现验证时手动过一下即可。
  • 下载完成通知:notifications支持 Bark / Telegram / 企业微信 webhook,跑大批量时手机随时收结果。
  • 桌面端:不想碰命令行的话,配套的 Douzy 桌面版提供图形界面,粘贴链接、跟踪任务、浏览本地归档一步到位:

排错速查

现象原因解法
请求 403 / 频繁失败Cookie 过期或风控拦截重新跑python -m tools.cookie_fetcher --config config.yml;仍失败则确认browser_fallback已开启并手动过验证
主页作品只下到几条接口翻页被风控限制保持browser_fallback.enabled: true、headless: false,让浏览器兜底补齐
重复下载同一个作品increase未开或库被删确认database: true且对应模式increase: true
想全量重下一遍增量开关在生效对应模式设increase: false即可覆盖重下
速度很慢并发太高被限速,或网络本身不稳降thread,加retry_times;必要时配proxy
想看详细报错默认日志偏安静python run.py -c config.yml -v打开 verbose 日志

更多设计细节可翻 PROJECT_SUMMARY.md 和 docs/。

安全与合规

  • 仅用于个人备份、学习研究,尊重原作者版权,不要二次商用或传播
  • Cookie 等于你的登录态,只留在本机,不要提交到代码仓库或发给别人
  • 控制请求频率(并发别拉太满),是对平台也是对自己账号的保护

写在最后

douyin-downloader 把「无水印、批量、去重、可追溯」这四件事做成了一个配置驱动的一体化流程——一次配置,长期受益。现在就 clone 下来,用三步跑通你的第一个主页批量下载吧。

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

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

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

立即咨询