抖音批量下载完整指南:主页作品、合集、音乐一次配好
2026/9/16 20:00:48 网站建设 项目流程

抖音批量下载完整指南:主页作品、合集、音乐一次配好

【免费下载链接】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 去重和浏览器兜底。适合需要批量归档某位创作者内容、做个人内容备份或定时同步新作品的用户。

它能帮你做什么

  • 无水印下载:自动挑选无水印视频源,并可指定原画或最高转码档
  • 主页批量采集:按post/like/mix/music模式拉取作品,跨模式按作品 ID 去重
  • 增量与时间过滤:重复运行只补新增内容,也能只下某个日期区间内的作品
  • 可靠性兜底:指数退避重试、下载完整性校验,翻页受限时自动打开浏览器让你手动过验证

首次使用:三步跑起来

1. 装好依赖:需要 Python 3.9+,克隆仓库后安装基础依赖即可;要启用浏览器兜底或自动抓 Cookie,再补装 playwright:

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. 准备配置和 Cookie:把 配置文件示例 复制为config.yml,填入链接;然后运行 Cookie 抓取脚本,浏览器里登录抖音后回终端按 Enter,Cookie 会写回配置:

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

3. 执行第一条命令

python run.py -c config.yml

配置文件里只改linkpathmode就能跑;其余字段保持默认即可。临时只想下某一条视频,也可以用参数直传:python run.py -u "视频链接" -p ./Downloaded

核心功能详解

主页作品批量下载

把作者主页链接放进link,用mode选类型、number定数量(0 表示不限量),一次任务可混合多种模式。文件默认按「作者/模式/日期_标题_作品ID」分层存放,封面、音乐、头像、JSON 元数据都可用开关追加:

link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx mode: [post, like] number: post: 0 like: 50

增量下载与时间范围过滤

increase开启后,工具会检查本地文件:已存在非空主媒体的作品直接跳过,删除文件则下次会重下。再配合start_time/end_time,可以只保留某个时间区间内的内容:

increase: post: true start_time: "2024-01-01" end_time: "2024-12-31"

无水印与画质选择

下载时优先选无水印源。video_quality控制档位:original探测上传原片(比转码档大才用,失败退回最高转码档),highest只从转码档里选最高码率(默认),也可以直接指定 1080p、720p 等分辨率。

常用配置速查

配置项作用建议值
link要下载的链接,可多条主页/视频/合集/音乐链接
path下载根目录./Downloaded/
mode内容模式,可多选按需组合post/like/mix/music
number各模式数量上限0 为不限量,先试 1 条
thread并发下载数5,网络不稳降到 3
start_time/end_time时间范围过滤YYYY-MM-DD
video_quality画质档位highest,追求原片用original

另有两个值得留意的默认项:browser_fallback.enabled默认开启,负责翻页被限时的浏览器兜底;database默认开启,记录下载历史并参与去重判断。

高频问题

Q:作品很多,为什么只拉到 20 条左右?A:这是翻页风控的常见表现。确认browser_fallback.enabledtrueheadlessfalse,弹出浏览器后手动完成验证,别过早关闭。

Q:Cookie 失效了怎么办?A:重新运行python -m tools.cookie_fetcher --config config.yml,登录刷新后自动写回配置。

Q:想重新下载某条作品怎么操作?A:工具是数据库记录加本地文件双重判断,删掉该作品的本地文件即可触发重下;把对应模式的increase设为false则批量重下并覆盖。

Q:number里的 0 是什么含义?A:0 表示不限量,即该模式下能取到的全部作品;填正整数就是数量上限。

Q:收藏夹模式collect有什么限制?A:它只作用于 Cookie 对应的登录账号,且必须单独使用,不能和post/like等模式混在同一次任务里。

使用提醒:请仅将下载内容用于个人学习、研究与自我数据管理。尊重创作者版权与平台规则,不要传播他人隐私内容或用于商业用途;账号风险由使用者自行承担。

下一步很简单:先用单条视频链接跑通全流程,确认 Cookie、目录结构和画质都符合预期,再把链接换成主页并开启增量模式。

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

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

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

立即咨询