☰
一次性备份整个抖音主页:Douyin Downloader 免费批量下载教程
2026/10/3 1:44:42 网站建设 项目流程

一次性备份整个抖音主页: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 稳一些
databaseSQLite 去重开关需要跨多次运行去重时保持开启
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),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询