抖音批量下载完整指南:主页作品、合集、音乐一次配好
【免费下载链接】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 chromium2. 准备配置和 Cookie:把 配置文件示例 复制为config.yml,填入链接;然后运行 Cookie 抓取脚本,浏览器里登录抖音后回终端按 Enter,Cookie 会写回配置:
cp config.example.yml config.yml python -m tools.cookie_fetcher --config config.yml3. 执行第一条命令:
python run.py -c config.yml配置文件里只改link、path、mode就能跑;其余字段保持默认即可。临时只想下某一条视频,也可以用参数直传: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.enabled为true、headless为false,弹出浏览器后手动完成验证,别过早关闭。
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),仅供参考