抖音下载器 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（抖音下载器）正是为解决这些烦恼而生：它是一款面向实用场景的开源下载工具，支持视频、图文、合集、音乐、直播、收藏夹等多种内容类型的无水印下载，既能单条精准保存，也能对作者主页一键批量获取，还自带进度展示、失败重试、数据库去重和浏览器兜底等能力。

在往下读之前，先记住三个关键词：无水印、批量、去重。整篇文章都围绕这三点展开，后面的所有功能都是它们的延伸。

30 秒认识它：这个工具到底能帮你做什么

简单说，凡是你在抖音上看到的、想留下的内容，它基本都能帮你"搬"到本地，并且搬得整整齐齐：

• 单条精确下载：视频、图文、合集、音乐链接直接粘贴就能下载；
• 主页全量打包：输入一个作者主页，作品、点赞、合集、原声音乐四种模式任选，数量不限；
• 登录账号收藏夹：把自己收藏过的内容批量取回，不依赖第三方工具；
• 直播实时录制：喜欢的直播间可以录成 FLV 文件，主播下播后数据依然保留；
• 评论区一并带走：作品评论（含二级回复）可以导出为 JSON，方便做内容研究；
• 绝不重复下载：SQLite 数据库 + 本地文件双重去重，同一内容只会出现一次；
• 下载过程稳得住：失败自动重试、文件完整性校验、API 受限时自动切换浏览器兜底。

一句话概括：它把"复制链接 → 逐个保存 → 手动去重 → 整理命名"这一整套手工活，全部自动化了。

粘贴链接即刻开始：检测链接、勾选作品/喜欢/合集，剩下的交给工具

能力拆解：六大板块逐个看明白

① 内容类型全覆盖：想存什么，就存什么

工具对内容类型的识别很"聪明"，你只需要把链接丢给它，它自己判断该走哪条路：

最省心的细节是短链自动解析：从 App 分享出来的链接通常都是v.douyin.com开头，工具会自动展开成真实地址，你无需任何预处理。

② 批量下载：作者主页一键"搬空"

这是工具最核心的亮点。拿到一个作者主页链接后，四种模式可以自由组合：

• post—— 作者发布的全部作品
• like—— 作者公开点赞过的内容
• mix—— 作者创建的合集
• music—— 作者用过的原声音乐

用配置一表达，效果立现：

link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx mode: - post - like - mix - music number: post: 100 # 每个模式下的下载数量，0 表示不限制 like: 0 mix: 0 music: 0

关键点：不同模式之间会自动去重——同一个作品既出现在"作品"里又出现在"点赞"里，只下载一次，绝不会浪费你的硬盘。

另外，如果你只是想要自己收藏夹里的东西，链接换成/user/self?showTab=favorite_collection，模式改成collect或collectmix即可，收藏的合集也能一并取回。

同步关注列表后，可以快速定位"从未下载过"的创作者，批量管理你的内容源

③ 智能管理：去重、增量、时间筛选三件套

下载工具最怕什么？一是重复下载浪费空间，二是文件命名乱七八糟。这两点工具都替你考虑好了：

• 数据库去重：SQLite 记录每一次下载，配合本地文件双重校验，同一作品永远不会存两遍；
• 增量下载：开启increase后，第二次运行只抓取新增内容，非常适合"定期追更"某个作者；
• 时间过滤：start_time/end_time指定日期范围，只下载你关心的那段时间的作品；
• 命名模板：文件名支持{id} {title} {author} {date} {type}等变量自由组合，保证既好认又不重名。

# 只下载 2024 年发布的内容，且只下载新增部分 start_time: "2024-01-01" end_time: "2024-12-31" increase: post: true mix: true database: true # 增量模式依赖数据库记录

下载完成后，每个作品会形成一个独立文件夹，视频、封面、音乐、元数据、评论文件各归其位：

下载目录自动按"日期+标题"命名，每个作品一个文件夹，井井有条

④ 稳字当头：重试、校验、浏览器兜底

网络下载难免遇到失败，工具把这些意外情况都处理成了"默认行为"：

• 失败重试：指数退避重试（1 秒、2 秒、5 秒），不会在失败时直接放弃；
• 完整性校验：用 Content-Length 比对文件大小，不完整的文件自动清理并重新下载；
• 浏览器兜底：API 翻页受限时，自动启动浏览器模拟操作，弹出验证码时你可以手动过一下，之后继续自动下载；
• 速率控制：默认限速 2 请求/秒，配合可配置的并发数，尽量不触发平台风控。

thread: 5 # 并发下载数，觉得快被风控就调小 retry_times: 3 # 失败重试次数 proxy: "http://127.0.0.1:7890" # 可选，走代理更稳定 browser_fallback: enabled: true headless: false # 显示浏览器窗口，方便手动过验证码 max_scrolls: 240

⑤ 进阶玩法：评论、热搜、转写、通知

当基础下载满足不了你时，工具还有一批"锦上添花"的能力：

• 评论采集：对指定作品抓取评论（可含二级回复），输出*_comments.json；
• 热搜榜与关键词搜索：一条命令导出抖音热搜榜快照，或按关键词搜索作品列表，结果存为 JSONL，方便二次分析；
• 视频转写：调用 OpenAI Transcriptions API 把视频转成文字稿，适合做素材整理和内容检索；
• 完成通知：下载完成后通过 Bark / Telegram / Webhook 推送到你的手机或群里，大任务挂在后台时不用干等；
• REST API 服务：以--serve启动后，其他程序可以通过接口提交下载任务、查询任务状态，方便自动化集成。

# 拉取热搜榜前 30 条并导出 JSONL python run.py --hot-board 30 -p ./Downloaded # 按关键词搜索作品列表 python run.py --search "猫咪" --search-max 100 -p ./Downloaded

作品档案功能把所有下载记录收进 SQLite，可按作者、类型、时间筛选，随时回溯

动手实操：两条最有代表性的使用路径

理论讲完，直接上手。下面两条路径覆盖了 90% 的使用场景，照做就能跑通。

实操一：最快路径，命令行下载单条视频

如果你只是想快速保存一条视频，不用建任何配置文件，直接命令行搞定：

# 1. 拉取项目代码并进入目录 git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader/douyin-downloader # 2. 安装依赖 pip install -r requirements.txt # 3. 指定链接、并发数与保存目录，直接下载 python run.py -u "https://www.douyin.com/video/7604129988555574538" -t 5 -p ./Downloaded

注意点：-u可以重复传入多个链接，一次命令行就能批量下多条；-p不写则默认存到工作目录下的Downloaded/文件夹。下载时终端会显示实时进度条，配合--show-warnings可以查看更详细的日志。

命令行模式下单作品下载：配置、进度、结果一目了然，文件按作者自动归档

实操二：配置驱动，批量追更一位创作者

想要长期、自动、增量地收集某个作者的内容，配置文件是更优雅的方式：

cp config.example.yml config.yml

然后编辑config.yml，填入你的目标：

link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx mode: - post - mix number: post: 50 mix: 0 # 0 = 合集全部下载 music: true cover: true json: true # 保存完整元数据 folderstyle: true # 每个作品独立文件夹 increase: post: true database: true

保存后运行：

python run.py -c config.yml

关键点：第一次运行全量下载，之后定期重复运行，由于开启了增量 + 去重，每次只会把新增作品补齐，不会重复劳动。下载过程中的实时进度、成功/失败统计都清晰可见。

批量下载时逐任务展示进度百分比与事件流，哪个环节卡住一眼就能看到

附带一步：Cookie 获取与直播录制

• 获取 Cookie：首次使用建议运行python -m tools.cookie_fetcher --config config.yml，登录抖音后回到终端按回车，程序会自动把认证信息写入配置，全程不需要手动复制粘贴；
• 录制直播：链接换成直播间地址即可，工具支持清晰度选择，录制文件保存在作者名/live/目录下，主播下播或网络中断时，已录制的字节会被保留，不会白录一场。

录制直播时可选 FULL_HD / SD 等多种清晰度，自动生成下载地址

按你的身份，对号入座

如果你是新手：从实操一的单条视频开始，30 秒内看到成果，建立信心后再尝试配置文件的批量模式。记住一个原则：先复制配置模板，只改链接和路径两处，其余保持默认即可。

如果你有一定经验：建议把author_dir设为nickname_uid，昵称加 ID 保证作者目录既直观又唯一；再把命名模板固定成{date}_{title}_{id}，配合folderstyle: true，长期积累后你的内容库会非常规整。定时任务（如 crontab）加上增量模式，可以实现"无人值守的持续追更"。

如果你是团队或企业：优先利用 REST API 模式把下载能力接入现有工作流，用--serve --serve-port 8000启动后，POST /api/v1/download提交任务、GET /api/v1/jobs查询状态即可对接自动化。多账号管理、完成通知、热搜与搜索数据导出，都可以支撑内容运营和竞品分析场景。

常见疑问集中解答

Q1：只能抓到 20 条作品就停了，怎么办？这是翻页触发了风控的典型表现。确认browser_fallback.enabled: true且headless: false，出现浏览器弹窗后手动完成验证码再继续，一般就能翻完整个主页。

Q2：提示 Cookie 失效了怎么处理？重新执行python -m tools.cookie_fetcher --config config.yml，重新登录一次即可，一两分钟内完成。

Q3：下载速度慢，怎么优化？先降低并发数（thread: 3）减少被限流的概率，再配合代理proxy配置；如果目标是数据完整性，把retry_times适当调大。慢而稳，往往比快而断更省时间。

Q4：我想重新下载某个作品，为什么工具跳过了？工具通过数据库记录 + 本地文件双重去重。想强制重下，需要同时清理本地文件（文件名包含aweme_id的文件夹）和数据库里对应的记录，只删其一不会生效。

Q5：下载的内容会包含水印吗？工具默认优先选择无水印片源，并自动在多个清晰度中挑选最高码率，正常下载的视频都是干净无水印的。

设置界面可自由配置作者目录命名、作品子目录和文件名模板，打造你的专属归档规则

现在，就可以开始整理你的抖音内容库了

回到开头那个"内容悄悄消失"的遗憾——有了 douyin-downloader，你不再需要被动的等待和手动搬运。一条视频、一个合集、一整个作者主页，甚至一场直播，都可以在你想要的时候，以无水印、高清晰、有条理的方式留在本地。

现在就可以做的三件事：

1. 复制一条你最喜欢的视频链接，用命令行跑一次，体验 30 秒完成的成就感；
2. 找到一位值得长期学习的创作者，用配置模式批量下载并开启增量，建立你的持续内容库；
3. 按自己的身份对号入座，尝试一个进阶功能（直播录制、评论采集或通知推送），让工具更贴合你的使用习惯。

工具的价值在于把重复劳动交给程序，把时间和注意力还给你。当你积累了几个月、几年之后回看，一个井井有条、随时可检索的个人内容库，就是它给你最好的回报。

最后也请牢记：本工具仅适用于个人学习、研究、备份等合法合规场景。请尊重内容创作者的劳动成果与合法权益，遵守抖音平台的相关规则与使用条款，不得将下载内容用于商业用途或任何侵犯他人版权、隐私的行为。工具的持续改进也离不开社区的反馈，遇到问题欢迎提交 Issue，一起让这个下载器越来越好用。

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