3 分钟上手的抖音下载工具：一个链接，通吃视频、图集、原声和整个作者主页

3 分钟上手的抖音下载工具：一个链接，通吃视频、图集、原声和整个作者主页

【免费下载链接】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 是一款免费开源的抖音下载工具，它把下载当成备份来做：贴一个链接，视频、图集、合集、原声、直播都能拿到手，作者主页还能整页批量搬运，自动去水印、自动挑最高画质。

它解决的是两类"下载焦虑"

市面上大多数工具只回答"单个视频怎么存"，而这个项目解决的是两个更扎心的问题。

链接类型通吃，不用研究格式

今天要存一条视频，明天想收一个合集，后天要扒一首原声——在很多工具里这是三种玩法，在这款抖音下载工具里只是三个链接的差别。它支持/video视频、/note图集、/collection合集、/music原声，以及live.douyin.com直播；短链（v.douyin.com/...）也会自动解析成真实地址，不用自己手动跳转。

更省心的是作者主页批量下载：把主页链接填进去，四种模式一次跑完。

link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx mode: - post # 发布作品 - like # 点赞作品 - mix # 合集 - music # 原声 number: post: 50 # 0 表示不限量

同一部作品如果既出现在"发布"里又出现在"点赞"里，会被自动去重，绝不重复下载。

断点、去重、校验，像备份工具一样可靠

多数下载器是"一把梭"：跑完就完，中断重来，还会反复下载。这个工具把可靠性做成了默认配置——失败按指数退避自动重试（1 秒、2 秒、5 秒逐级等待）；每个文件下载后比对 Content-Length，不完整的自动清理并重下；启用database: true后，已下载作品写进 SQLite，与本地文件形成双重去重，配合increase开关还能增量下载：以后再跑同一位作者，只补新作品，不碰旧文件。

3 分钟跑通第一个下载任务

先装环境，再配 Cookie，最后一行命令开始下载。

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

Cookie 是访问抖音接口的钥匙，推荐用项目自带的提取工具自动获取——它会拉起浏览器，你扫码登录后回车，配置自动写入，无需手工翻浏览器开发者工具。

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

接着把链接填进config.yml的link字段，运行即可：

python run.py -c config.yml

图为批量下载时的实时进度：先抓取到 274 个作品，再按 5 线程并发下载，成功数、用时、保存路径都一目了然。

三个值得玩味的细节

翻页被风控？浏览器兜底替你过验证

批量抓取作者主页时，"只能翻到 20 条"是接口风控的常见表现。开启browser_fallback后，工具会启动真实浏览器继续翻页，遇到验证码时弹出窗口让你手动过一下，采集完再回到 API 流程。这是不少下载器没有的"人机协同"设计，也是它敢做全量备份的底气。

文件命名和目录，是为你归档设计的

下载的文件默认按日期_标题_ID命名，作者名下再按模式分目录（post/、like/、music/），视频、封面、原声、元数据 JSON 各归其位。日期取的是作品的发布时间而不是下载时间，长期归档不会乱。

顺手还带了几个"附加技能"

除了下载，它还能录制直播（主播下播时保留已录数据）、按作品采集评论、拉取热搜榜和关键词搜索结果并导出 JSONL，甚至可以 REST API 服务模式运行，供其他程序调用。一个仓库，覆盖了抖音内容获取的大多数场景。

新手最容易踩的三个坑

• Cookie 过期导致 403：Cookie 一般 7-15 天失效，失效后重新运行python -m tools.cookie_fetcher --config config.yml即可，不用重装任何东西。
• 只抓到 20 条作品：确认browser_fallback.enabled: true且headless: false，浏览器弹窗出现后手动完成验证，别急着关窗口。
• 删了文件却不重新下载：这是双重去重机制在起作用——只有数据库有记录但本地文件缺失时才会重下。想彻底重来，需要同时清掉下载目录和dy_downloader.db里的对应记录。

下一步

如果你也有"把喜欢的创作者完整存下来"的念头，不妨把这件事当成一次数据备份来做：克隆仓库、配好 Cookie、贴上链接，剩下的交给工具。项目完全开源免费，配置文件里有注释、文档里有参数对照表，遇到问题也有据可查。动手试一试，也许 3 分钟后，你就多了一套属于自己的抖音内容归档。

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