企业官网建设流程全解析

免费开源！这款抖音批量下载工具，让你 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，就是一款能救急的开源抖音批量下载工具——无水印、支持单个视频与整个主页批量下载，还能顺手把背景音乐、封面、评论一起打包归档。关键是完全免费，配置一次就能长期使用。

📖 故事开场：你的收藏夹里，躺着多少个"再也找不到"的视频？

你是不是也经历过这样的瞬间——

• 刷到一个超棒的舞蹈教学，想存下来慢慢学，却发现抖音根本不给保存，只能录屏，还带着一堆水印；
• 一位知识博主宣布退网，几百条干货视频一夜之间清零，你这才后悔当初没有备份；
• 为了下载某个视频，你在浏览器里装了三四个插件、收藏了五六个在线解析网站，结果不是收费就是限流。

我把这些痛点点了一遍后发现，问题的根源只有一个：缺少一个属于自己的、可批量可管理的内容仓库。而 douyin-downloader 想解决的，正是这件事。

🗺️ 30 秒全貌：它到底能干什么？

一句话总结：粘贴抖音链接，它帮你把"无水印视频 + 背景音乐 + 高清封面 + 完整元数据"全部下载到本地，并自动去重归档。

图：项目主界面，粘贴链接即可开始，支持作品/喜欢/合集三种模式

项目分为两部分：一是命令行版（run.py），适合批量与自动化；二是同源桌面版 Douzy，适合不爱敲命令的普通用户。两者共享同一套下载核心，也就是说命令行能做的，桌面版基本都能做。

接下来的三阶段上手地图，会带你从"第一次下载"一路走到"搭建个人内容流水线"。

🚀 第一阶段 入门：10 分钟跑通第一次无水印下载

读完本节，你将能：完成环境安装、获取 Cookie、下载你的第一个无水印抖音视频。

1. 装好环境（约 3 分钟）

打开终端，执行：

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

需要 Python 3.8 以上版本。如果安装依赖时网络较慢，换国内镜像源即可。

2. 拿 Cookie：全程只需扫码一次

抖音的大部分接口需要登录态，所以第一步是获取 Cookie。项目提供了自动获取工具：

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

运行后会打开浏览器，你扫码登录抖音，程序自动提取并写入配置。Cookie 只保存在本地，不会上传到任何服务器。之后每隔一段时间重新执行一次这条命令刷新即可。

3. 最小配置 + 第一次下载

复制一份配置模板：

cp config.example.yml config.yml

打开config.yml，把链接换成你想下载的视频短链，其他保持默认：

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

然后运行：

python run.py -c config.yml

几秒钟后，你的Downloaded/目录下就会出现一个无水印视频。恭喜，你已经完成了第一次备份。

🔁 第二阶段 进阶：把整个创作者主页"搬"回家

读完本节，你将能：一键下载某位创作者主页的全部作品，并实现"只下新的、跳过旧的"。

单集下载只是热身，真正体现这个工具价值的是用户主页批量下载。

把配置改成创作者主页链接：

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

运行后，工具会拉取该创作者的全部作品清单，然后并发下载。你可以在命令行里看到每个文件的实时进度：

图：命令行批量下载时逐条展示进度、跳过已存在的重复文件

下载完成后，文件会自动按"作者 → 作品"归档，每个作品一个独立文件夹：

Downloaded/ └── 创作者A/ └── 2026-06-15_作品标题_7412345678901234567/ ├── 2026-06-15_作品标题_7412345678901234567.mp4 # 无水印视频 ├── ..._cover.jpg # 高清封面 ├── ..._music.mp3 # 原声音乐 ├── ..._avatar.jpg # 作者头像 └── ..._data.json # 完整元数据

增量下载：下次只下新作品

下载完一个创作者后，他明天又发了新视频，难道要重新全量下载一遍？不用。工具内置 SQLite 数据库做去重，只要开启增量模式：

increase: post: true database: true

再次运行同一个链接时，已下载过的作品会被自动识别并跳过，只下载新增内容，既省时间又省流量。如果只想下某个时间段的内容，还可以加上时间过滤：

start_time: "2026-06-01" end_time: "2026-06-30"

🎮 第三阶段 实战：从"下载"到"内容流水线"

读完本节，你将能：录制直播、采集评论、抓热搜榜，并把下载结果推送到手机。

场景一：直播录制——喜欢的直播不想错过

工具支持抖音直播录制，live.douyin.com/{房间号}链接直接可用：

link: - https://live.douyin.com/123456789 live: max_duration_seconds: 3600 # 录制 1 小时；0 表示录到主播下播

命令行会实时显示直播间信息与可选的清晰度，主播下播后已录数据会自动保留：

图：命令行直播录制界面，自动解析直播间并生成 FLV 拉流地址

场景二：评论采集——把热评也存进档案

如果做内容研究或舆情分析，还可以按作品抓取评论，支持二级回复：

comments: enabled: true include_replies: true max_comments: 0 # 0 表示不限

每个作品会额外生成一个*_comments.json，结构化保存，方便后续分析。

场景三：热搜榜与关键词搜索——发现新选题

工具还内置了两个独立子命令，适合运营和内容创作者：

# 抓取抖音热搜榜前 30 条，导出 JSONL python run.py --hot-board 30 -p ./Downloaded # 按关键词搜索作品，最多 100 条 python run.py --search "猫咪" --search-max 100 -p ./Downloaded

场景四：下载完成自动通知

批量下载动辄几十分钟，干等太浪费。开启通知后，任务完成或失败都会推送到你的设备：

notifications: enabled: true providers: - type: bark url: https://api.day.app/YOUR_DEVICE_KEY

支持 Bark、Telegram、Webhook，适合挂机场景。

🧠 高手才知道的 5 个细节

这些参数藏得比较深，但用好了体验完全不同：

1. 命名模板变量：文件名和子目录都支持{date}_{title}_{id}这样的模板，可用变量有{id} {title} {author} {date} {year} {month} {day} {type}等。模板里必须保留{id}，否则重名作品会互相覆盖。
2. 作者目录三种命名：author_dir可设为nickname（直观但重名会合并）、sec_uid（稳定唯一但不可读）、nickname_uid（直观又唯一，重度用户推荐）。切换只影响后续下载，不会迁移已有目录。
3. 下载清单：除了媒体文件，每次下载还会追加写入download_manifest.jsonl，一行一条 JSON，记录日期、标题、标签、文件路径，方便做二次索引。
4. 并发与限速可调：默认 5 线程、2 请求/秒、失败自动重试（1s/2s/5s 退避）。网络不稳时把thread调小，速度慢时把rate_limit调大，找到平衡点。
5. 数据库直接查询：所有下载记录都存在dy_downloader.db，你可以直接用 SQL 检索自己的档案库：

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

桌面版把以上能力都做成了图形界面：任务中心逐条显示状态，作品档案支持按作者、标题关键词筛选，命名规则在设置里可视化配置。

图：任务中心清晰展示每个任务的进度与结果，支持一键打开目录

图：作品档案把所有下载记录存在 SQLite 中，可筛选、可批量导出

图：文件命名模板与作者目录命名方式，在设置里可视化调整

🛡️ 避坑锦囊：新手最容易踩的 4 个坑

按"症状 → 原因 → 解法"三步排查：

坑 1：突然报"403 Forbidden"或提示未登录

• 症状：之前能下，某天开始所有下载都失败。
• 原因：Cookie 过期（有效期通常 7–15 天）。
• 解法：重新执行python -m tools.cookie_fetcher --config config.yml扫码刷新，建议每周更新一次。

坑 2：只能抓到 20 条作品

• 症状：明明博主有几百条视频，只下载了 20 条就停了。
• 原因：翻页触发了抖音风控。
• 解法：开启浏览器兜底功能，让程序在 API 受限时改用浏览器采集：

browser_fallback: enabled: true headless: false

浏览器弹出后手动完成验证再关闭窗口，不要立即关掉。

坑 3：批量下载又慢又容易中断

• 症状：下到一半卡住，或某个文件反复失败。
• 原因：网络抖动 + 并发过高。
• 解法：把thread降到 3，检查网络稳定，工具自带断点重试与完整性校验（Content-Length 比对），不完整的文件会自动清理重下。

坑 4：内存占用飙升

• 症状：一次下几百个作品，电脑卡顿。
• 原因：并发下载队列堆积。
• 解法：分批下载（每批 50–100 个），或减少线程数，同时确保磁盘预留足够空间。

🌟 最后：今天就能做的第一步

回顾一下，douyin-downloader 能帮你做到的三件事：

1. 单集存档：看到喜欢的视频，10 秒内无水印入库；
2. 主页备份：整站搬空一位创作者，增量更新，永不再丢；
3. 自动归档：直播、评论、热搜、通知，一条命令串成完整内容流水线。

今天就能做的第一步：克隆项目、装好依赖、跑通一个视频的下载，全程不超过 15 分钟。跑通之后，再去备份你最喜欢的那位创作者的主页，体验一次"整站搬回家"的畅快。

一个小建议：先下单个视频验证配置，再上批量；开启增量模式后，每周花一分钟刷新 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