抖音下载器完全指南：从单条无水印视频到批量收藏一次讲清
【免费下载链接】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 是一款免费开源的抖音内容下载工具，支持无水印视频、图文、合集、音乐（原声）和直播录制，既能下载单条作品，也能整页批量抓取博主内容。它适合想把抖音内容备份到本地、建立素材库的个人用户和技术新手，命令行和桌面端两种方式都能上手。
一图看懂
- 左侧粘贴作品、主页或合集链接，点「下载」即开始任务
- 任务中心实时显示每条任务的成功数、失败数，可单独重试
- 作品档案按作者归档，支持本地检索与快速重下
- 桌面端（Douzy）与命令行共用同一套后端，能力一致
首次运行的最短路径：3步跑通第一个下载
第 1 步，拿到代码并装依赖：
git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt第 2 步，写一个最小配置文件config.yml，只留关键项：
link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx # 目标：博主主页 path: ./Downloaded/ # 保存目录 mode: [post] # 只下发布作品 number: { post: 50 } # 限最近50条，0表示全部 database: true # 开启SQLite去重记录第 3 步，获取 Cookie 并运行：
python -m tools.cookie_fetcher --config config.yml python run.py -c config.ymlcookie_fetcher会弹出一个浏览器，登录抖音后回终端按回车，Cookie 自动写回配置。之后每次运行python run.py -c config.yml即可，想临时加链接可用-u参数追加。
能力地图：一张表看全所有下载对象
| 能力 / 内容类型 | 说明 | 对应配置开关 |
|---|---|---|
| 单视频 / 图文 | /video/、/note/、/gallery/链接，自动选无水印源 | link直接填链接 |
| 合集 | /collection/、/mix/链接整合集下载 | link直接填链接 |
| 音乐（原声） | /music/链接或博主作品中的原声 | mode: [music] |
| 博主发布作品 | 按主页批量抓取，可限定数量与时间范围 | mode: [post]+number.post |
| 博主点赞作品 | 抓该博主点赞过的内容 | mode: [like] |
| 收藏夹内容 | 仅限登录账号自己的收藏，须单独使用 | mode: [collect]或[collectmix] |
| 直播录制 | 录直播流为 FLV，中断时已录部分完整保留 | live.* |
| 评论采集 | 每个作品生成*_comments.json | comments.enabled: true |
| 热搜 / 关键词搜索 | 输出 JSONL，便于二次处理 | --hot-board/--search |
| 语音转文字 | 调 OpenAI 转写 API，生成 txt/json | transcript.enabled: true |
| 完成通知 | Bark / Telegram / Webhook 推送 | notifications.* |
配置速查：最常用的 8 项
| 配置项 | 作用 | 建议值 |
|---|---|---|
link | 下载目标，可填多条 | 视频 / 用户 / 直播链接 |
mode | 内容模式，可组合 post/like/mix/music | [post]起步 |
number | 每种模式的数量上限，0 为不限 | 先设 50 试跑 |
thread | 并发下载数 | 5（建议 1–20） |
retry_times | 单任务失败重试次数 | 3 |
database | 开启 SQLite 历史与去重 | true |
increase.post | 增量同步：本地已有的主文件自动跳过 | true |
start_time/end_time | 只下指定时间段的作品 | YYYY-MM-DD格式 |
字段默认值与完整注释见 config/default_config.py，命名模板等细项可按需调整。
命令行 vs 桌面端：该用哪种
| 维度 | 命令行 | 桌面端（Douzy） |
|---|---|---|
| 启动方式 | python run.py -c config.yml | 粘贴链接点按钮 |
| 批量任务 | 配置文件 +-u追加链接 | 任务中心排队、筛选、重试 |
| Cookie 管理 | cookie_fetcher手动获取一次 | 内置登录窗口，免单独获取 |
| 部署 | 可跑在服务器 / Docker / 定时任务 | 本地图形环境 |
| 适合谁 | 要无人值守同步、服务器部署 | 首次上手、可视化跟踪进度 |
桌面端任务中心把每条任务的成功 / 失败项数、下载目录入口都摊在一张列表里，失败的条目可以单独重试。
卡点排查：常见 4 个现象与处理
- 只抓到约 20 条作品就停→ 分页被风控拦截 → 保持
browser_fallback.enabled: true、headless: false，弹出浏览器后手动完成验证，不要提前关闭窗口 - 运行报登录失效或 403→ Cookie 过期 → 重跑
python -m tools.cookie_fetcher --config config.yml重新登录即可 - 想重新下载某个作品却被跳过→ 程序按「数据库记录 + 本地文件」双重判断 → 本地媒体文件与数据库记录需同时清掉，只删其中一个不生效，具体清法见 README.md 的 Re-downloading 一节
- 进度条日志刷屏→ 属正常调试输出 → 调试时用
-v或--show-warnings查看完整日志，平时保持progress.quiet_logs: true
使用边界与合规
抖音接口会不定期调整，部分接口自 2026 年起被风控拦截，届时命令行直连可能失效，需依赖浏览器回退或桌面端，详见 README.md 的 Current Limitations。并发建议保持在 1–20 之间，过高容易触发限流。本工具仅用于技术研究、学习与个人数据管理，请勿用于侵权或其他用途，尊重内容创作者的劳动成果。
进阶话题——通知推送、REST API 服务模式（--serve）、Docker 部署与转写参数——完整说明见 README.md，CLI 入口实现可看 cli/main.py，批量抓取策略在 core/user_modes/ 下按模式拆分，方便按需阅读。
【免费下载链接】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），仅供参考
