[Github] douyin-downloader – 开源抖音批量下载与去水印工具

想批量保存抖音视频、图文、合集或某个作者主页作品时，douyin-downloader 是一个偏实用向的开源选择。它以 Python CLI 为主，支持无水印优选、增量归档、重试和浏览器兜底；同仓库还提供桌面版 Douzy，把同一套下载能力扩展到抖音、TikTok 与 YouTube。截至 2026-09-12 查看，仓库约有 1.0 万 Stars、1581 Forks，许可证为 MIT，最近 Release 为 desktop-v0.11.5。

它能下载什么

按官方 README，CLI 侧覆盖的常见入口包括：单个视频、图文/图集、合集、音乐（原声）、短链解析，以及用户主页按 post / like / mix / music 模式批量下载。登录 Cookie 后，还可针对当前账号的收藏夹、收藏合集做下载。下载时会优先选无水印源，并按码率梯队挑选更高清的视频轨；额外资源可选封面、音乐、头像和 JSON 元数据。

进阶能力还包括直播间录制（FLV/HLS）、作品评论采集、热搜榜/关键词搜索结果导出，以及可选的 REST API 服务模式（--serve）和 Bark / Telegram / Webhook 完成通知。这些能力让它更像一条可脚本化的归档流水线，而不只是“粘贴一条链接出文件”。

两条使用路径

大多数技术用户会先走 CLI：复制 config.example.yml 为 config.yml，填好链接、路径和 Cookie，再执行 python run.py -c config.yml。需要主页长列表、定时增量或脚本集成时，这条路径最直接，也支持 Docker 挂载配置与下载目录。

如果更希望图形界面，可以关注同仓库的桌面版 Douzy。它基于同一后端，为抖音、TikTok、YouTube 提供独立工作台：粘贴链接开始下载，同步关注/收藏类内容，并在任务中心跟踪结果。官方明确标注桌面版仍在内测，安装包需从 Releases 获取。

CLI 最小起步

1. 准备 Python 3.8+（macOS / Linux / Windows）。
2. pip install -r requirements.txt 安装依赖。
3. 如需浏览器兜底或自动抓 Cookie：安装 Playwright，并执行 python -m playwright install chromium。
4. cp config.example.yml config.yml，写入目标链接、下载目录和模式。
5. 推荐用 python -m tools.cookie_fetcher --config config.yml 自动写入 Cookie；登录抖音后回到终端按 Enter。
6. 运行 python run.py -c config.yml；也可用 -u 追加链接、-t 调整并发、-p 指定目录。

最小配置通常只需 link、path、mode（如 post）、并发/重试，以及一组有效 Cookie。开启 database 后会把下载元数据记入 SQLite；增量跳过则更多依赖本地文件与 increase.* 配置，而不是单靠数据库“判重即跳过”。

Cookie 与浏览器兜底

抖音公开接口经常受登录态、分页和风控影响。项目把 Cookie 当作常规前置条件，并提供自动抓取工具，降低手工复制字段的成本。当接口分页被拦时，可启用 browser_fallback：拉起浏览器继续翻页，必要时允许人工过验证码。

官方也写清了边界：浏览器兜底对 post 模式验证更完整；like / mix / music 目前更依赖 API 正常分页。收藏夹相关模式只能作用于当前 Cookie 对应账号，且不能与 post / like / mix / music 混开。把这些限制提前看清，能少踩“只下到前几页”或“收藏夹为空”的坑。

任务跟踪怎么看

桌面版把批量结果收敛到任务中心：可按进行中/已完成/失败筛选，打开输出目录，或对失败项重试。主页批量、合集下载、单作品下载会以不同任务类型列出，适合需要持续归档多个作者或合集的人。

使用前先看清限制

• 直播录制：FLV 可直接播放；HLS 源通常只保存 playlist，需自行用 ffmpeg 等工具后处理；直播接口整体仍属 experimental。
• 版权片源/门禁链接：仓库近期提交明确拦截部分无法合法拿到可播放成片的链接类型，避免误判成“解析失败”。
• 桌面版：功能面更广，但官方标注内测，版本迭代快，适合先试用再依赖。
• 合规：仅用于你有权保存的内容；账号 Cookie、验证码和平台风控都会影响稳定性，不适合当成无限制爬虫。

和直播录制工具怎么选

站内已有 DouyinLiveRecorder 一类专注直播流自动录制的项目。若你的目标是“主播开播就录、多平台直播间值守”，应优先看直播录制工具；若目标是“把已发布的视频/图文/合集/主页批量落到本地，并做增量更新”，douyin-downloader 更对口。两者都能碰直播，但主任务不同：一个偏实时录制值守，一个偏作品库归档。

相关链接

• GitHub：https://github.com/jiji262/douyin-downloader
• Releases（含桌面版）：https://github.com/jiji262/douyin-downloader/releases
• 中文 README：https://github.com/jiji262/douyin-downloader/blob/main/README.zh-CN.md