抖音批量下载全攻略：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 去重。无论你是想备份学习资料，还是定期整理关注创作者的全部作品，这篇 douyin-downloader 使用教程都能让你在半小时内跑通第一个下载任务。

凌晨两点，她只花三分钟备份了一周的直播回放

小周是一家在线教育公司的内容运营，每天的工作之一是把当天的课程直播保存成回放素材。工具倒是现成的——录屏软件、浏览器插件、手动下载，各来一套。可一套流程下来，一场 40 分钟的直播要折腾将近半小时：录屏容易录进弹窗，网页缓存下载经常断流，文件名还是乱码，归档时全靠肉眼辨认。

直到同事把 douyin-downloader 丢给她。她把直播间链接粘贴进配置文件，运行一条命令，去倒杯水回来，FLV 文件已经按照"作者名 / 直播标题 / 日期"的目录结构整齐躺好。更让她意外的是，周末她想把一位讲剪辑的老师近半年的作品全部留存，原以为要熬个大夜，结果同样一条命令，几百个视频按发布、点赞、合集、音乐分类自动归位，重复内容一个没下。

她感叹的不是"工具很强大"，而是"原来这种事可以不用人盯"。这正是这类抖音下载工具存在的意义：把重复劳动交给程序，把时间还给人。

一句话定位：它是什么，能解决什么问题

简单说，douyin-downloader 是一个"粘贴链接就能下"的抖音资源管理器。你给它一个视频链接、一个用户主页链接或一个直播间链接，它负责解析、去水印、挑选最高码率、下载媒体文件、整理目录，并把每一次下载记进数据库，避免下次重复劳动。

上手难度上，普通用户只需要会改 YAML 配置；想要并发、代理、通知这些进阶能力，配置项也都有现成开关。下文先带你完整跑通第一次下载，再进入具体场景。

第一次运行：从安装到出片的完整路径

先说明环境：需要 Python 3.8 以上，macOS、Linux、Windows 都支持。整个过程不需要写一行 Python 代码。

第一步，把项目克隆到本地并安装依赖。在终端里执行：

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

第二步，生成配置文件并自动获取 Cookie。抖音接口需要身份凭证，项目提供了自动获取方式，省去手动从浏览器开发者工具里翻 Cookie 的麻烦：

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

运行第二条命令后会自动弹出浏览器，你正常登录抖音，回到终端按 Enter，程序会把 Cookie 写进配置。如果之后遇到 Cookie 失效，重新跑一遍这条命令即可。

第三步，把想下的链接写进配置。用任意编辑器打开config.yml，把link换成你的目标：

link: - https://www.douyin.com/video/7604129988555574538 # 想下载的视频 path: ./Downloaded/ # 保存目录 thread: 5 # 并发下载数，默认 5

第四步，运行并观察进度。

python run.py -c config.yml

命令行会以 Rich 进度条展示每个任务的状态，下载完成的作品会自动附带封面、音乐、头像和一份 JSON 元数据。整个过程体验下来，最直观的感受是"省心"：链接解析失败会自动重试，下载不完整的文件会被自动清理后重新拉取，进度条不再刷屏干扰。

画面里你能看到工具在启动时打印的配置摘要、抓取到的作品数量、线程数，以及"跳过已存在"的去重提示——这意味着同一文件不会因为重复运行命令而再次下载。

场景一：批量归档一位创作者的全部历史作品

什么时候需要它？你关注了一位宝藏博主，想把他过去半年的作品全部留存，用于学习或二次创作；或者你想长期跟踪某类账号，定期增量同步新内容。

配置文件的mode就是为此设计的，它控制抓取主页的哪几类内容：

link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx # 作者主页链接 mode: - post # 发布的作品 - like # 点赞的作品 - mix # 合集内容 - music # 音乐（原声）作品 number: post: 0 # 0 表示全量下载，可改成具体数字限制数量 database: true

首次使用建议把number.post设成 20 先试跑，确认目录结构和清晰度符合预期后，再改成 0 全量拉取。下载完成后，目录会自动整理成"作者名 / 模式 / 作品名"的层级，每个作品独立成文件夹：

Downloaded/ └── 讲师昵称/ ├── post/ # 2026-03-01_直播切片技巧_732xxx/ 内含 mp4、封面、音乐、data.json ├── like/ ├── mix/ └── music/

批量任务会并行推进，进度条实时显示每个作品的完成情况，失败项自动重试，最终给出成功数与耗时统计。

真正让人放心的是增量下载机制。开启increase开关后，工具会结合数据库记录和本地文件双重判断，只下载新增作品，不会把整个主页再拉一遍：

increase: post: true like: true mix: true music: true

对于需要定期同步的账号，这套"全量首跑 + 增量跟进"的组合几乎是零维护成本。下载完成的文件在资源管理器里按日期和标题命名，一眼就能找到目标内容。

场景二：定时保存直播回放与评论数据

直播是抖音上信息密度最高的内容形式之一，但也是最容易"转瞬即逝"的。douyin-downloader 的直播录制功能解决的就是这个问题：把直播间链接放进配置，录到主播下播为止。

link: - https://live.douyin.com/123456789 # 直播间链接 live: max_duration_seconds: 0 # 0 = 一直录到主播下播，也可设 3600 限制 1 小时 chunk_size: 65536 # 流分块大小，保持默认即可 idle_timeout_seconds: 30 # 流空闲 30 秒视为结束

录制得到的 FLV 文件保存在Downloaded/{作者}/live/目录，同时会附带一份*_room.json记录直播间元数据。最贴心的一点是容错设计：无论主播下播、网络空闲还是你手动中断，已录制的数据都会被保留，不会因为意外中断而前功尽弃。

录制之外，另一个高频需求是评论采集。如果你在做账号运营或竞品分析，想了解用户对某条作品的真实反馈，可以这样开启：

comments: enabled: true include_replies: false # 设为 true 会额外抓取每条评论的二级回复 max_comments: 0 # 0 = 不限数量 page_size: 20

每个作品旁边会生成一份*_comments.json，评论、作者、时间字段齐全，方便后续导入表格或做文本分析。对内容创作者来说，这份数据比截图存档有价值得多。

场景三：热搜、搜索、API 与通知，把下载器接进你的流程

当你不满足于"手动下几个视频"，就可以开始把下载器当作一条自动化流水线来用。

追热点和找选题，可以用内置的热搜榜与关键词搜索功能：

# 拉取抖音热搜榜前 30 条，导出为 JSONL 快照 python run.py --hot-board 30 -p ./Downloaded # 搜索"猫咪"相关内容，最多取 100 条 python run.py --search "猫咪" --search-max 100 -p ./Downloaded

结果会写入hot_board/和search/目录下的带时间戳 JSONL 文件，作为历史留档或进一步分析的素材。

把下载能力开放成服务，则适合需要二次开发的场景。安装两个可选依赖后，下载器就变成一个本地 REST 服务：

pip install fastapi uvicorn python run.py --serve --serve-port 8000

之后任何程序都可以通过 HTTP 接口提交任务：

这就意味着你可以把抖音下载接进自己的定时脚本、消息机器人甚至是 Web 后台，实现"每天凌晨自动同步指定账号新作品"这类无人值守流程。

下载完成的通知推送则让长任务不再需要盯着屏幕。支持 Bark、Telegram 和企业微信/飞书/钉钉的 Webhook：

notifications: enabled: true on_success: true on_failure: true providers: - type: bark url: https://api.day.app/YOUR_DEVICE_KEY # 换成你的 Bark 设备码

任务跑完，手机收到推送，你才知道"该去整理素材了"。如果还想更进一步，可选的视频转写功能能在下载后调用语音识别接口，直接输出逐字稿，用于做字幕或文字稿。

图形界面：不想敲命令也能用的 Douzy 桌面版

命令行确实灵活，但对不熟悉终端的朋友仍有门槛。项目团队基于同一套后端打造了桌面版 Douzy（当前内测中），把核心能力搬进了可视化界面：粘贴链接即刻开始、同步关注列表、实时查看进度、SQLite 档案管理、自定义命名规则。

CLI 和桌面版共用同一套后端逻辑，也就是说你在命令行里调通的配置思路，在桌面版里同样成立。选择哪种形态，取决于你习惯键盘还是鼠标。

常见问题速查与优化建议

Q：为什么只能抓到 20 条作品？这是抖音翻页风控的常见表现。解决方案：确认配置中browser_fallback.enabled: true且headless: false，当浏览器自动弹出时，手动完成验证码后不要立即关闭窗口，程序会继续翻页抓取。

Q：Cookie 失效了怎么办？重新执行一次自动获取命令即可，无需手动复制粘贴：python -m tools.cookie_fetcher --config config.yml。

Q：下载速度慢或总是失败？先看网络时段，再调并发。thread可以适当调大，但建议控制在 10 以内，避免触发风控；如果身处受限网络，配置proxy参数为本地代理地址即可。

Q：如何查看下载历史？开启database: true后，可用 SQLite 直接查询：

sqlite3 dy_downloader.db "SELECT aweme_id, title, author_name FROM aweme ORDER BY download_time DESC LIMIT 20;"

Q：想重新下载某个作品怎么办？程序通过"数据库记录 + 本地文件"双重检查判断是否跳过。删除对应文件的目录并清掉数据库记录即可触发重下，两个条件缺一不可。

优化建议清单：大批量任务分时段分批跑，别一次性压满；按"作者 / 类型 / 用途"规划保存目录，配合命名模板{date}_{title}_{id}让文件名自带时间信息；重要内容定期备份，数据库和文件目录一并留存。

资源延伸与行动号召

项目的完整说明在仓库的 README 和使用文档里：config.example.yml是带注释的配置模板，几乎每个配置项都有示例；core/目录是下载核心逻辑，想深入理解实现原理可以从这里读起；tests/下有七十多个自动化测试，覆盖了配置加载、去重、直播录制等关键路径，是了解功能边界的好材料。

如果你是第一次接触这类工具，建议从下面这条命令开始你的第一个任务：

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

然后复制配置、跑一次 Cookie 获取，把一条视频链接放进link字段，运行python run.py -c config.yml。十分钟之内，你就能亲手验证"批量下载 + 去水印 + 自动归档"到底是什么体验。

最后提醒一句：下载工具解决的是效率问题，但使用边界同样重要。请遵守平台规则，尊重创作者版权，下载内容仅用于个人学习、备份与合理引用，不要用于任何商业或侵权用途。技术是工具，怎么用，取决于你。

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