抖音批量下载完整指南：一键保存视频、合集与音乐-平芜编程栈

抖音批量下载完整指南：一键保存视频、合集与音乐

【免费下载链接】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 是一款免费开源的抖音批量下载工具：粘贴一个创作者主页链接，他的视频、图文、合集和音乐就能被整批抓下来，默认去水印、自动挑最高清晰度。它适合想把整个主页作品系统化保存下来的内容创作者、运营人员和档案爱好者。

没有它之前，你得手动干这些活

翻页 + 逐个下载：一个主页有 50 个作品，你要不停上滑、点开、找去水印渠道、保存，一个账号攒够 1 小时是常事，中途断网还得重来。
文件全是无名氏：手动存下来的文件叫10086.mp4、10087.mp4，想找"上个月那个教程"，只能逐个点开看内容。
只存了视频本身：BGM、封面图没法跟着一起落盘；作品一旦下架，连封面都没了。
重复劳动：隔几天想看看博主更新没有，只能把整个主页再跑一遍，已下载的视频全部重新拉一次。

它凭什么值得用

一条链接批量抓：解析/user/{sec_uid}主页链接后自动翻页收集作品，number.post控制数量（0 = 全量），不用手动逐个操作
双重去重：SQLite 数据库记录 + 本地文件中的 aweme_id 双重检查，重跑任务只补新作品和缺失文件
无水印 + 自动选画质：优先选无水印源，读video.bit_rate数组自动挑最高码率，还能配置拉取上传原片
完整资源落盘：视频、背景音乐、封面、作者头像、JSON 元数据可同步保存，目录按"作者/模式/发布日期_标题_作品ID"组织
跑长任务不翻车：默认 5 并发、2 请求/秒限速、失败按 1s/2s/5s 指数退避重试，下载不完整会自动清理重下
浏览器兜底：API 翻页被风控卡住时自动拉起浏览器继续抓，验证码还能人工过

五步跑起来

拿到代码→ 仓库文件出现在本地目录：

git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader

安装依赖→ 终端不再报ModuleNotFoundError：

pip install -r requirements.txt

自动获取 Cookie→ 浏览器弹出抖音登录页，登录后回终端按 Enter，Cookie 自动写入配置：

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

写一份最小配置config.yml→ 指向目标主页链接和下载目录：

link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx path: ./Downloaded/ mode: [post]

启动任务→ 终端出现 Rich 进度条，文件按作者目录陆续落盘，完成后生成download_manifest.jsonl下载清单：

python run.py -c config.yml

桌面版 Douzy 的链接下载工作台：粘贴链接、识别类型、点下载即可

核心功能逐个看

作者主页批量下载

解决的问题：主页作品动辄几百上千条，手动收集不现实。工作方式：mode字段支持post（发布）、like（点赞）、mix（合集）、music（音乐）四种模式，可组合使用，跨模式自动按 aweme_id 去重；设置start_time后，翻页一旦越过起始日期会提前停页，不必把整个主页翻完。适合谁：想系统收集某个账号内容的创作者和研究者。

增量更新与去重

解决的问题：重复下载浪费时间和硬盘。工作方式：database: true时每个作品写进dy_downloader.db；再跑任务时先查数据库、再扫本地文件名里的 aweme_id，两边都确认"没下载过"才动手。increase.post: true打开后，第二次运行只会下载新增作品。适合谁：需要定期跟踪目标账号更新的人，配合定时任务几乎零维护。

浏览器兜底

解决的问题：抖音对接口翻页有风控，API 模式经常只能拿到 20 条左右。工作方式：browser_fallback.enabled: true（默认开启）时，程序会启动一个真实 Chromium 浏览器，读取页面自己发出的作品列表请求，默认有头模式（headless: false），弹出验证码时你可以人工完成验证。适合谁：主页作品量大、API 模式总是停在 20 条的用户。

完整资源与画质控制

解决的问题：只存视频，BGM 和封面留不住。工作方式：music、cover、avatar、json四个开关分别控制背景音乐、封面、头像、元数据是否落盘；video_quality可选original（探测上传原片，比最高转码档大时优先下载）、highest（默认）、或指定1080p/720p等档位。命令行版还带直播录制、评论采集（comments.enabled生成*_comments.json）、热搜榜和关键词搜索等附加能力。适合谁：做素材库、做数据分析、需要留档的用户。

任务中心展示每条下载任务的进度、成功/失败计数，失败项可单独重试

不同人的用法

内容创作者

竞品研究：批量拉同类账号的post，对比标题、封面、BGM 的搭配规律
素材库建设：开music+cover开关，把高频出现的 BGM 和封面风格集中归档

运营与研究

定期跟踪：定时任务 +increase.post: true，每次只抓新增作品
互动分析：开comments.enabled，连同评论一起导出，直接做词频和话题统计

普通用户

收藏备份：把喜欢的创作者主页整批存到本地，不怕作品下架
按时间段存档：用start_time/end_time只保存某个时期的作品

Douzy 桌面版可同步当前账号的收藏夹、收藏合集与喜欢列表，逐集合下载

两个最值得改的配置

拉原画画质。转码最高档和上传原片可能差出几倍体积，做素材库时值得多等一次探测请求：

video_quality: original

限定时间范围。只想要最近的更新时，post模式翻页到起始日期即提前停页，省掉大量无效请求：

start_time: "2026-01-01"

另外提醒一个边界：2026-08 起抖音 Argus 风控陆续拦截了 CLI 的点赞/收藏/合集/音乐及单视频接口，主页作品 API 翻页同样受限。这类需求官方建议改用桌面版 Douzy（内测中，从项目 Releases 页下载安装文件），它通过内置登录窗口代发请求，不受该门禁影响。

命令行版	桌面版 Douzy
形态	YAML 配置 + 终端	图形界面，粘贴链接即下
平台	抖音	抖音、TikTok、YouTube
关注/收藏同步	仅当前账号收藏夹（`collect`模式）	关注、收藏夹、喜欢列表同步
任务管理	进度条 + 下载清单	多链接队列、任务中心、失败重试
风控适应	API 直连 + 浏览器兜底	内置登录窗口签名，不受 Argus 门禁影响
适合	脚本集成、定时任务、技术用户	所有用户