douyin-downloader 抖音批量下载实操指南：5 步搭起你的无水印视频收藏库

douyin-downloader 抖音批量下载实操指南：5 步搭起你的无水印视频收藏库

【免费下载链接】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 智能去重，几分钟就能把心仪内容完整存进本地。本文用 5 个实际任务，带你从零跑通全部流程。

🗂️ 第一站：为什么你需要一个"私人抖音档案馆"？

先说实话：手动保存这件事，真没那么简单。

录屏画质差还带水印，网页解析站一次只能存一个，浏览器插件又存不了背景音乐和封面。更麻烦的是，等你攒了几十个视频，文件名全是"VID_20240301_0830"，想找一条内容得翻半天。

douyin-downloader 的思路是"整包交付"：每下载一个作品，自动生成一个以发布日期和标题命名的文件夹，里面整整齐齐躺着视频、封面、原声音乐和元数据 JSON。

一句话总结：它把"下载"升级成了"归档"。后面几站，我们一步步把这个档案馆搭起来。

🛠️ 第二站：出发前的三件套——环境、依赖与登录凭证

首次配置完整步骤其实只有三步，10 分钟内能搞定。

第一步，准备环境。本机装好 Python 3.8 以上版本，然后拉取项目并安装依赖：

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

第二步，获取登录凭证。抖音接口需要有效 Cookie 才能访问内容，推荐用项目自带的工具自动抓取：

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

命令会弹出浏览器，扫码登录抖音后回到终端回车，工具会自动提取 Cookie 并写进配置文件。如果懒得扫码，也可以从浏览器开发者工具里复制 Cookie，手动填入config.yml的cookies字段。

第三步，复制配置文件。项目自带了完整模板，复制一份再改：

cp config.example.yml config.yml

⚠️ 安全提醒：Cookie 只保存在你的本地电脑，不会上传到任何服务器。它相当于你的登录凭证，别发给任何人。

🎯 第三站：第一次下水——把一个视频完整搬回家

配置好了先别急着玩高级功能，用一个链接测通全流程最重要。

打开config.yml，把下载链接填进去，其余保持默认：

link: - https://v.douyin.com/EXAMPLE1/ path: ./Downloaded/ music: true # 下载原声音乐 cover: true # 下载封面图 json: true # 保存作品元数据

然后运行：

python run.py -c config.yml

终端会弹出 Rich 进度条，实时显示下载进度和事件日志。稍等片刻，Downloaded/目录下就会自动生成按作者、按作品组织的目录结构：

Downloaded/ └── 作者名/ └── post/ └── 2024-02-07_作品标题_aweme_id/ ├── 2024-02-07_作品标题_aweme_id.mp4 ├── 2024-02-07_作品标题_aweme_id_cover.jpg ├── 2024-02-07_作品标题_aweme_id_music.mp3 └── 2024-02-07_作品标题_aweme_id_data.json

图：douyin-downloader 主界面，粘贴链接即可开始，支持多种下载模式配置

📦 第四站：进阶——把整个博主主页搬回家

单个视频只是热身，这站的核心任务是批量下载。工具支持多种链接类型：视频/video/{id}、图文/note/{id}、合集/collection/{id}、音乐/music/{id}，而最常用的场景是把某个博主的全部主页作品一次搬走：

link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx mode: - post # 主页作品 number: post: 50 # 下载最近 50 个，0 表示全部

想更彻底？把mode一次性配齐，作品、点赞、合集、音乐四类内容同时抓取，而且跨模式自动去重——同一个作品出现在不同模式下不会重复下载：

mode: - post - like - mix - music

两个很实用的限定功能：

• 时间过滤：只下载某段时间的内容，比如start_time: "2024-06-01"、end_time: "2024-06-30"，适合只想补档近一个月作品的场景。
• 增量下载：打开increase.post: true（需配合database: true），之后每次运行只下载新增作品，不会重复劳动。

图：批量下载时的实时进度界面，每个任务的进度和日志一目了然

🔁 第五站：让工具自己干活——去重、续传与完整性校验

批量下载几十上百个作品，最怕的就是"下到一半断了"和"重复下了一遍"。这一站讲清楚工具是怎么替你兜底的。

断点续传与重试。工具默认 5 个线程并发下载，失败会自动按 1s、2s、5s 的指数退避重试，配合速率限制（默认 2 请求/秒），不会因为手速太快被平台风控。

双重去重。每个作品下载后都会写入本地 SQLite 数据库（dy_downloader.db），下次运行前会同时比对数据库记录和本地文件，两者都命中就直接跳过。这也是增量下载能"只抓新的"的底层保障。

完整性校验。下载完成后会比对文件实际大小与接口返回的 Content-Length，发现不完整会自动清理残留文件并重新下载，杜绝"下了一堆打不开的废文件"。

下载历史会沉淀为"作品档案"，支持按作者、标题关键词、作品类型和时间范围筛选，随时可以批量导出或删除：

图：作品档案页，所有下载过的作品都可以按作者、关键词、时间筛选管理

🎁 附加题：直播、评论、热搜与自动通知

主线任务跑通后，这几个彩蛋功能值得一试。

直播录制。把live.douyin.com/{房间号}填进链接，设置好录制时长即可边看边录；主播下播或网络中断时，已录制的字节会被保留，不会白录：

link: - https://live.douyin.com/123456789 live: max_duration_seconds: 3600 # 0 = 录到主播下播

图：直播录制场景，命令行指定直播间链接即可开始采集

评论采集。开启comments.enabled: true，按作品抓取评论（可含二级回复），输出结构化的*_comments.json，适合做内容分析和存档。

热搜与关键词搜索。两条命令即可把平台热点和搜索结果导出为 JSONL 数据文件：

python run.py --hot-board 30 -p ./Downloaded python run.py --search "猫咪" --search-max 100 -p ./Downloaded

完成通知。在notifications里配置 Bark、Telegram 或 Webhook，长任务跑完自动推送到手机，不用一直盯着终端。更进阶的玩法包括 REST API 服务模式（python run.py --serve --serve-port 8000）和调用 OpenAI 接口的视频语音转写，前者适合接入自己的自动化系统，后者能为每个视频生成transcript.txt字幕文本。

💡 避坑手册：老用户反复踩过的三个坑

问题 1：一个博主只能抓到 20 条作品？原因：翻页触发平台风控，API 分页被截断。 解决：确保配置文件开启浏览器兜底，翻页受限时工具会自动拉起浏览器，弹出验证时手动通过即可：

browser_fallback: enabled: true headless: false

问题 2：突然报 403 或"未登录"？原因：Cookie 有效期通常只有 7-15 天。 解决：重新运行python -m tools.cookie_fetcher --config config.yml扫码刷新，建议每周更新一次。

问题 3：进度条刷屏、日志太多？原因：每个下载阶段都有详细日志输出。 解决：保持默认的progress.quiet_logs: true即可静默日志；调试时再加--show-warnings或-v手动开启。

🏁 收尾：命令行版还是桌面版？

如果你喜欢脚本化、自动化，命令行版功能最全，配一个config.yml就能反复复用；如果你是普通用户、想要可视化操作，可以试试同源开发的桌面版 Douzy，关注列表同步、任务中心、作品档案都有图形化界面，上手门槛更低。

最后总结一下最佳实践：

1. 先下载单个视频跑通环境，再上批量，别一上来就全量抓取。
2. 批量下载配合增量模式，第一次全量、之后增量，省时省流量。
3. 每周刷新一次 Cookie，并定期用作品档案页整理归档。
4. 重要内容建议异地备份一份，建立真正的个人内容库。

工具本身完全免费开源，但请一定合理使用：下载内容仅用于个人学习、研究或备份，尊重创作者劳动成果，不要用于商业用途或侵犯他人版权。现在，打开终端，把第一个视频存进你的档案馆吧。🚀

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