一条链接搞定抖音批量下载：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 是一款开源的抖音批量下载工具，主打无水印下载，一条链接就能带走视频、图集、合集、音乐乃至直播内容，适合内容创作者、自媒体运营者和普通用户快速搭建个人素材库。

先看一个真实场景：整理素材，不该耗掉你一整晚

周五晚上，你打算为下周的剪辑项目找素材。收藏夹里躺着 50 个视频，关注的博主刚更完一个 30 集的合集，还有两场直播想录下来当参考。于是你开始了熟悉的流程：打开页面 → 找在线解析站 → 等广告 → 下载 → 改名 → 手动分类。一个视频折腾 3 分钟，50 个就是两个半小时，最后还得面对满屏的水印和一堆乱糟糟的文件名。

douyin-downloader 把这件事压缩成了"复制链接 → 运行 → 收文件"三步。这篇文章会沿着"从 1 条链接到 1 个完整素材库"的路径带你走一遍，一共 5 关，每过一关，你就多掌握一项能力。

第 1 关｜先弄懂它能吃什么：一条链接，覆盖 6 种内容

很多人以为下载工具只能"下一个视频"，这个工具真正值钱的地方在于：它能识别几乎所有抖音链接类型，包括短链接，复制过来就能用。

连v.douyin.com/xxx这种短链也能自动解析，不用先去网页里翻出完整地址。

把链接粘进去，工具自动识别是视频、合集还是主页，并列出可下载的内容

此刻你已掌握：判断一条链接能不能用这个工具。99% 的抖音页面链接，都可以。

第 2 关｜10 分钟跑通第一次下载

上手过程拆成 4 步，每步对应一条命令。✅ 表示完成后你就获得了对应能力。

第一步：拉取代码并安装依赖

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

这条命令会自动打开浏览器引导你登录抖音，登录完回到终端按一下回车，Cookie 就自动写进配置文件，不用手动复制粘贴。✅ 你已经有了"合法访问内容"的凭证。

第三步：准备配置文件

cp config.example.yml config.yml

然后编辑config.yml，一个能跑的最小配置长这样：

link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx # 你想下载的链接 path: ./Downloaded/ # 保存目录 mode: - post # 下载主页发布的作品 thread: 5 # 5 个并发 database: true # 开启去重记录

第四步：运行

python run.py -c config.yml

✅ 到这里，你已经能下载任意单条视频和第一个博主主页的全部作品。

第 3 关｜让批量下载替你干活：模式、去重与增量

单个主页往往不止"发布作品"一种内容，mode支持四种组合，互不冲突：

mode: - post # 发布的作品 - like # 喜欢的作品（需要对方主页公开） - mix # 该博主的所有合集 - music # 用过的原声音乐

多个模式同时开启时会自动跨模式去重——同一个aweme_id绝不会下载两遍。这也是它最实用的一点：数据库记录 + 本地文件名双重去重，断网重跑、重复运行都不会浪费流量。

increase: post: true # 只下载没下过的新作品 database: true # 增量依赖数据库记录，务必保持开启

配合start_time/end_time做时间过滤，以及filename_template: "{date}_{title}_{id}"自定义命名，文件夹会自动整理成"作者 → 类型 → 日期_标题_ID"的层次，打开就能找到想要的东西。

批量任务进行时，每个作品的解析、下载状态一目了然，中途中断也能续传

下载完的文件自动按日期和标题分目录存放，无需手动整理

此刻你已掌握：一个"会自动更新、不会重复、自动分好类"的素材库。

第 4 关｜进阶武器库：直播、评论、热搜与 API

批量下载只是基础，这套工具还能伸进更多工作流里。

录制直播：链接指向直播间即可，主播下播、网络空闲或手动中断时，已录制的字节都会保留，不会白录一场：

link: - https://live.douyin.com/123456789 live: max_duration_seconds: 3600 # 0 表示录到主播下播

采集评论：给每个作品生成独立的*_comments.json，可含二级回复，做舆情分析或选题调研时很省事：

comments: enabled: true include_replies: false max_comments: 500

热搜与搜索：不需要配置，命令行直接拉：

python run.py --hot-board 30 -p ./Downloaded # 热搜榜快照 python run.py --search "猫咪" --search-max 100 -p ./Downloaded

REST API 服务：装好fastapi uvicorn后运行python run.py --serve --serve-port 8000，就能用POST /api/v1/download提交链接、GET /api/v1/jobs/{id}查询进度，方便接入自己的自动化脚本。下载完成还能通过 Bark、Telegram 或 Webhook 推送通知，适合挂机批量跑的场景。

此刻你已掌握：把下载能力接进自己的脚本、定时任务甚至服务端。

第 5 关｜翻车自救手册：5 个高频问题的解法

Q1：为什么只能抓到 20 条作品？这是抖音翻页风控的典型表现。打开配置里的浏览器兜底，遇到验证弹窗时手动过一下：

browser_fallback: enabled: true headless: false

Q2：Cookie 过期了怎么办？Cookie 通常 7~30 天失效，重跑一次python -m tools.cookie_fetcher --config config.yml即可，全程自动化。

Q3：下载速度慢？把thread控制在 3~5，工具默认每秒最多 2 次请求（rate_limiter），这是主动让速以降低风控概率；网络环境允许时也可给proxy配一个代理。

Q4：想重新下载某个作品怎么办？去重靠"数据库 + 本地文件"双重判断，所以两者都要清理：删掉对应的本地文件夹，再用sqlite3 dy_downloader.db "DELETE FROM aweme WHERE aweme_id='xxx';"清掉记录。

Q5：下载的文件都放在哪？在配置里path指定的目录下，按"作者名 / 模式（post、like、mix、music）/ 日期_标题_ID"组织，每个作品附带视频、封面、音乐和 JSON 元数据。

写在最后：让工具回归工具

回到开头那个周五晚上。同样的 50 个视频、一个 30 集合集、两场直播，现在只需要把链接写进配置跑一次，剩下的时间可以留给真正重要的剪辑和创作。技术工具的价值从来不是替代创作，而是把重复劳动压缩到最短，让你把精力花在值得的地方。

下一步很简单：克隆仓库，装好依赖，粘贴你的第一条链接。🚀

温馨提示：请尊重原创作者的劳动成果，遵守平台服务条款和相关法律法规，建议将下载内容用于个人学习、研究与内容创作，避免商业侵权用途。

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