一次性备份整个抖音主页: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
一次运行跑完,本地下载目录会多出一批作品:无水印视频、封面、原声和_data.json元数据,按目录归档。Douyin Downloader 是一款免费的抖音批量下载工具,粘贴一条链接即可归档整个主页。
先跑通一次:从克隆到第一批作品落盘
跟着走就是一份完整的 Douyin Downloader 使用教程,四小步:克隆仓库、装依赖、取 Cookie、启动。环境需要 Python 3.8 及以上。
git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt抖音接口要带 Cookie 才能请求。先复制示例配置,再跑自带脚本:浏览器弹出后登录抖音,回终端按 Enter,Cookie 自动写回配置文件,不用手抄。
cp config.example.yml config.yml python -m tools.cookie_fetcher --config config.yml把要下载的主页或单条链接填进config.yml的link,启动:
python run.py -c config.yml跑完打开path指向的目录 🚀:每个作品一组以 aweme_id(作品的唯一编号)命名的文件,无水印视频本体、封面、原声、元数据都在。取 Cookie 的脚本在 tools/cookie_fetcher.py。
批量下载抖音主页作品:从给目标到失败兜底的四个机制
链接随便给:post、like、mix、music 四种模式和两个时间窗
单条分享链接、v.douyin.com短链、/user/{sec_uid}主页链接,哪种都行,短链会自动展开。主页场景下mode决定下载维度:post作品、like点赞、mix合集、music音乐,可多选混跑,同一个作品被两个模式命中时只保留一份。number是每种模式的数量上限,填 0 代表全量;start_time/end_time按时间窗过滤,只留某段时间内的内容。各模式的策略代码在 core/user_modes/ 目录下按模式分文件。
无水印优先,码率最高的那路自动替你挑
视频、图文(note)、合集(mix)、单条音乐都能下;音乐维度会直接抓原声文件。下载源优先选无水印版本,同一作品有多档码率时自动取最高清晰度的那一档,不用你判断哪路更清。
双重判重加 increase 增量:第二次运行只补新作品
判重看两层:一层是 SQLite 数据库里的记录,另一层是本地文件名里带的 aweme_id(作品的唯一编号)。重复跑同一目标,已存在的文件不会被再存一遍。把配置里increase对应模式改成true,下次运行旧库跳过、只抓新增作品——这就是抖音作品增量备份,适合定期盯着某些账号有没有更新。
5 线程、1s/2s/5s 重试:坏了它自己会救
默认开 5 个线程并行,请求频率限制在每秒 2 个;某次请求失败会按 1 秒、2 秒、5 秒的间隔依次重试。文件落盘后还会跟服务端声明的 Content-Length 对大小,不够就删掉重来,不留下半截文件。主页翻页被风控卡住时(典型症状是抓到二十来条就停),打开browser_fallback,程序会拉一个真实浏览器打开主页,抓页面自己发出的作品列表请求;弹出验证时人工处理,窗口开着别关。并发与限速逻辑在control/目录,桌面版的工作台则把每个任务的状态和结果集中呈现。
顺路能带走的东西:封面、BGM、评论和 REST 接口
每个作品可以连同封面、背景音乐、作者头像、_data.json(点赞数、发布时间等)一起存下来;comments配置项按作品抓评论,可选二级回复,输出成 JSON。另外还支持热搜榜快照(--hot-board)、关键词搜索(--search)、直播录制(FLV/HLS,中断也保留已录数据),以及--serve起一个 REST API 服务,让外部系统提交下载任务。
配置速查:config.yml 里最常动的 8 项
配置加载逻辑在 config/ 目录,日常改动集中在下面这几项 ⚙️
| 配置项 | 作用 | 什么时候动它 |
|---|---|---|
link | 单条链接或主页链接 | 每次换下载目标都改它 |
path | 文件落盘目录 | 想换到别的磁盘或目录时 |
mode | 下载维度 post/like/mix/music | 想从作品切到点赞或合集时 |
number | 每种模式数量上限,0 为全量 | 只想抽样抓几条时 |
thread | 并发线程数,默认 5 | 网络偏弱时调低到 3 稳一些 |
database | SQLite 去重开关 | 需要跨多次运行去重时保持开启 |
increase | 各模式增量开关 | 让下次运行只抓新增作品时 |
browser_fallback | 翻页被限流时真实浏览器兜底 | 只抓到约 20 条就停时保持开启 |
读者最常问的三个问题
只抓到二十来条就停,是不是出错了?
现象:主页明明有几十个作品,程序停在约 20 条附近。原因:翻页请求被风控拦下,不是程序坏了。解法:确认browser_fallback.enabled为true且headless为false;浏览器窗口弹出后人工完成验证,验证期间别关窗口,通过后续页就会接着翻。
请求突然成片地失败,该怎么办?
现象:跑着跑着大量请求开始报错。原因:Cookie 失效了。解法:重跑一次python -m tools.cookie_fetcher --config config.yml,新 Cookie 会直接写回配置;Cookie 的读写由auth/模块统一管理,不用手动复制粘贴。
2026 年 9 月起部分请求 403,是我的配置错了吗?
现象:部分下载直接返回 403(Blocked by ArgusSecurityPlugin)。原因:抖音侧的风控升级,属于平台行为——2026-08 起点赞、收藏夹、收藏合集的 CLI 直连被拦,2026-09 起单个视频/图文、合集、音乐也被纳入,主页作品翻页同样要依赖浏览器兜底。解法:这些场景改用桌面版 Douzy,它通过内置登录窗口代发请求,不受该门禁影响。
免费开源,用起来记得三件事
它把一条链接变成一整套内容资产,批量、去重、增量、重试、元数据全部自动完成,你只管决定要下载什么。项目采用 MIT 协议,可免费使用与二次开发;请把它限定在技术研究、学习交流和个人数据管理范围内,合规使用。
【免费下载链接】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
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考