三步跑通抖音主页全量批量下载：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 是一个开源的抖音批量下载工具：粘贴主页链接，自动抓取无水印视频、图集、合集与原声音乐，并自动归档去重。本文带你用三步完成安装到首次批量下载。
能力总览：六个功能点，一次讲清
它的工作方式类似一个自动登记入册的仓管员：收下一批包裹（链接），逐件验货（抓取信息）、撕掉贴纸（去水印）、贴标签（命名归档）、登记造册（数据库去重）。
| 功能点 | 对你意味着什么 |
|---|---|
| 去水印下载 | 拿到的 MP4 默认无水印，无需二次处理 |
| 主页批量抓取 | post / like / mix 三种模式，一次拉空一个主页 |
| 四类内容覆盖 | 视频、图集、合集、音乐（原声）均可下载 |
| 自动去重 | SQLite 数据库记录已下作品，重跑不重复占盘 |
| 增量下载 | 开启后只抓博主新发布的作品 |
| 自动归档 | 默认按"作者/模式"建目录，文件带标题与作品 ID |
每个作品除视频外，还会同步保存封面、原声音乐、作者头像和 JSON 元数据（music / cover / avatar / json 默认均为 true）。
上手路径：安装、登录态、首跑三步
第 1 步：克隆并安装依赖
git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt预期：终端无报错，依赖就绪。
第 2 步：获取一次性登录态（Cookie）
抖音接口需要登录凭证 Cookie（浏览器登录后的身份标识）。工具内置自动提取脚本，需先装 Playwright：
pip install playwright && playwright install chromium python cookie_extractor.py运行后会打开浏览器，扫码登录，Cookie 自动写回配置，全程约一分钟，之后长期有效。
第 3 步：首跑批量下载
把config.example.yml复制为config.yml，填入主页链接：
link: - https://www.douyin.com/user/MS4wLjABAAAA... number: post: 0 # 0 表示全部，不限数量 thread: 5 # 默认 5 线程并发下载python downloader.py -c config.yml预期：终端实时滚动下载进度，结束后输出统计表格，列出总任务数、成功、失败、跳过、成功率与用时。
配置要点：三项改一次，长期生效
- 增量下载：追更场景只抓新增，避免全量重下。
increase: post: true database: true # 增量依赖数据库记录- 多内容模式：除发布作品外，把点赞和合集也一并抓下。
mode: - post - like - mix- 归档与并发：指定保存目录与并发数，文件夹风格保持开启。
path: ./Downloaded/ folderstyle: true # 按作者/模式自动建子目录 thread: 5排错指南：5 个常见报错与一行解决
- 提示"请安装必要的依赖" → 依赖未装 →
pip install -r requirements.txt - 提示"未设置下载链接" → 配置里 link 为空 → 在
config.yml的 link 下填入主页或作品链接 - 请求失败、疑似登录态失效 → Cookie 过期 → 重跑
python cookie_extractor.py扫码即可 - 主页作品只拉到约 20 条就停 → 平台翻页风控限制了条数 → 隔几分钟重跑，增量模式会自动跳过已有作品，补抓缺口
- 个别作品反复下载失败 → 网络抖动导致 → 程序内置 3 次重试（retry_times: 3），仍失败可直接重跑，不会重复下载
写在最后
douyin-downloader 把"下载、去水印、去重、归档"合并在一条命令里，默认 5 线程并发、失败自动重试，首次全量之后即可靠增量模式长期维护一个带索引的本地视频库。仓库地址见上文克隆命令，开源免费，配置模板可直接参考 config.example.yml，接口实现集中在 apiproxy/douyin/ 目录。请仅用于学习研究、个人数据管理与合法合规场景。
【免费下载链接】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），仅供参考
