抖音下载效率翻倍：douyin-downloader 保姆级上手攻略，视频、图集、合集、音乐全覆盖

抖音下载效率翻倍：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 是一个开源的多合一下载工具，视频、图集、合集、音乐原声、直播都能抓，默认去水印、自动挑选最高清版本，还内置了重试、去重、断点续传和浏览器兜底。接下来这份教程不绕弯子，直接带你从装环境走到玩转批量归档。

主界面：粘贴链接点检测，工具自动识别是视频、图集还是合集

先认识它：一张能力清单看懂这工具有多省心

开始动手前，先用一张表看清它能处理哪些内容，避免用到时才发现不支持：

除了内容类型，它还有三个"省心内置"值得提前知道：

• 双重去重：SQLite 数据库记录 + 本地文件名扫描，同一作品不会重复下载；
• 失败自愈：指数退避重试（1秒、2秒、5秒），下载不完整的文件会通过 Content-Length 比对自动清理并重下；
• 风控兜底：翻页受限时自动拉起浏览器，让你人工过一下验证就能继续。

5分钟跑通第一单：安装、配 Cookie、开跑

第1步 准备环境与安装依赖

只需要 Python 3.8 以上版本，Windows、macOS、Linux 都行。先克隆代码并装依赖：

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

网络慢的话可以换成清华镜像源。如果你后面想用"自动获取 Cookie"或"浏览器兜底"功能，再多装一个 Playwright：

pip install playwright python -m playwright install chromium

第2步 三种方式搞定登录凭证

抖音大部分内容需要登录态，Cookie 配置有三档可选，按优先级排列：

1. 全自动：配置里写cookies: auto，运行时自动打开浏览器引导你登录，登录完按回车即写入配置；
2. 整串粘贴：从浏览器开发者工具复制整段 Cookie 字符串，直接填进配置；
3. 键值拆分：分别填写msToken、ttwid、odin_tt等字段。

推荐先用自动方式体验最顺，命令如下：

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

第3步 写一份最小配置

打开config.yml，最简配置只占几行：

link: - https://www.douyin.com/video/7604129988555574538 path: ./Downloaded/ music: true cover: true json: true thread: 5

thread: 5表示同时开 5 个下载线程；music/cover/json分别控制是否顺带下载原声、封面和元数据 JSON，默认都开着。

第4步 执行下载并查看结果

运行命令即可开下：

python run.py -c config.yml

想临时追加链接或改参数，不用动配置文件，直接命令行覆盖：

python run.py -c config.yml -u "https://www.douyin.com/video/7604129988555574538" -t 8 -p ./Downloaded

命令行批量下载：并发线程、进度统计、保存路径一目了然

下载完成后，文件会按"作者名/类型/日期_标题_作品ID"的结构自动归档，每个作品附带 mp4、封面、原声和 JSON 元数据，不需要你手动整理。

进阶场景一：把创作者主页整站归档

做内容运营或长期跟踪某个博主时，最烦的是"今天存几条、明天补几条"。这个工具支持对主页做四种模式的批量抓取：

link: - https://www.douyin.com/user/你的目标用户主页 mode: - post # 发布作品 - like # 点赞作品 - mix # 参与的合集 - music # 用过的音乐 number: post: 0 # 0 表示不限制数量，全量下载 increase: post: true # 只下载新增作品，配合数据库去重 start_time: "2024-01-01" end_time: "2024-12-31"

几个关键点帮你避坑：

• number: 0才是全量，留空或不写可能只抓前几条；
• increase增量开关依赖数据库，记得保持database: true；
• start_time/end_time是时间过滤器，格式固定为YYYY-MM-DD；
• 同一作品在 post/like/mix 之间出现会自动去重，不会下两遍。

如果某次批量下载只抓到 20 条就停了，多半是翻页风控，把浏览器兜底打开，让它在弹窗出现时人工过一下验证：

browser_fallback: enabled: true headless: false

实时进度：剩余时间估算、逐任务事件流，全在界面里可查

进阶场景二：搭一条"直播+评论+通知"的素材监控流水线

除了普通下载，这工具还能做内容监控类的工作流，三个功能组合起来特别实用。

直播录制：配置里加一条直播链接，录到主播下播或指定时长，中断也不丢数据：

link: - https://live.douyin.com/123456789 live: max_duration_seconds: 3600 # 0 表示录到主播下播 chunk_size: 65536

录好的 FLV 保存在Downloaded/作者名/live/下，并附带直播间元数据快照；即使中途 Ctrl+C，已录制的字节也会保留下来。

评论采集：想分析某条作品的评论区？打开开关即可，还能抓二级回复：

comments: enabled: true include_replies: false # 设为 true 会多拉每条评论的回复 max_comments: 500 # 0 表示不限

采集结果会生成独立的*_comments.json，方便后续做文本分析。

完成通知：下载跑完自动推送结果到手机或群聊，支持 Bark、Telegram、Webhook（企业微信、飞书、钉钉的机器人地址同样适用）：

notifications: enabled: true providers: - type: bark url: https://api.day.app/你的设备Key

这三个功能串起来，就相当于一个"自动蹲直播、采评论、发通知"的小型监控台，适合做账号内容复盘和竞品观察。

任务中心：进行中、成功、失败的记录集中管理，可批量操作

用数据说话：一次 50 条作品的归档对比

空谈不如实测，下表是一次 50 条作品归档任务的耗时对比：

整体算下来，一次归档任务从 4 小时级别压缩到半小时以内。如果你每周都要整理素材，省下的时间相当可观。

让文件井井有条：命名模板与档案库

文件名决定日后好不好找。工具支持自定义命名模板，用花括号引用可用变量：

folderstyle: true path: ./Downloaded/{author}/{date}_{title}_{aweme_id}/

比如示例效果就是2026-04-10_今天去爬山_7412345678901234567/，一眼能看出时间、标题和作品 ID。你还可以在设置里看到全部 15 个可用变量，按需组合。

设置页：命名模板可视化配置，支持按变量自由组合

同时，所有下载记录都会写进 SQLite 数据库，它既是去重依据，也是你的个人档案库。想查历史记录，直接敲：

sqlite3 dy_downloader.db "SELECT aweme_id, title, author_name, datetime(download_time, 'unixepoch', 'localtime') FROM aweme ORDER BY download_time DESC LIMIT 20;"

如果你偏好接口化使用，还支持--serve --serve-port 8000启动 REST 服务，提交链接即返回任务号，方便接入自己的脚本或前端。另外--hot-board能导出热搜榜快照，--search "关键词"能按关键词搜索导出 JSONL，适合做榜单追踪和选材调研。

新手最容易踩的4个坑

坑1：为什么只能下载 20 条作品？

这是抖音翻页风控的典型表现。确认browser_fallback.enabled: true且headless: false，浏览器弹窗出现后手动完成验证，别急着关窗口，翻页限制就会解除。

坑2：Cookie 过期了怎么办？

Cookie 一般 7-30 天有效。重新执行python -m tools.cookie_fetcher --config config.yml走一遍登录，或手动更新配置文件里的 Cookie 值即可。

坑3：想重新下载某个作品，但程序总是跳过？

工具靠"数据库记录 + 本地文件"双重判断去重。要强制重下，需同时删除本地文件（文件名含 aweme_id 的目录）和数据库记录，两边都清掉才会重新下载。

坑4：进度条刷屏、日志太吵？

默认progress.quiet_logs: true已经做了静默处理；真要排查问题，临时加--show-warnings或-v再看详细日志。

坑5：下载太慢或报错不断？

先确认thread是否合理（3-5 为宜），再考虑在配置里加max_per_second限制请求频率，或配置proxy走代理线路。频繁报错时优先检查 Cookie 有效性。

写在最后

到这里，你已经掌握了 douyin-downloader 从安装、配置、单条下载到批量归档、直播录制、通知推送的完整玩法。工具是开源的，代码结构也很清晰，想深入研究的读者可以顺着core/（下载逻辑）、auth/（登录凭证管理）、storage/（去重与文件管理）、server/（REST 服务）这几个目录往下看。

最后提醒一句：本工具仅供个人学习、素材管理和合法研究使用，请尊重原创作者的版权，遵守平台服务条款，不要用于商业侵权或任何违法违规用途。合理使用，让工具为你的创作效率加分。

祝你的素材库越来越整齐，创作越来越顺！

【免费下载链接】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