抖音批量下载工具使用攻略：从“保存不了“到“全站备份“的完整进阶路线

抖音批量下载工具使用攻略：从"保存不了"到"全站备份"的完整进阶路线

【免费下载链接】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 就是这样一款开源的抖音下载工具：去水印、支持视频/图集/合集/音乐/直播，也能整页批量下载作者主页。更难得的是它把"下载"这件事拆成了可解释、可控制的步骤——你会看到进度、重试、去重，而不是一个神秘的黑盒。下面我从几个真实痛点出发，带你把它用透。

痛点一：单条视频存不下来

想象一个场景：你在信息流里刷到一个喜欢的老电影片段，链接在手机和电脑之间传来传去，最后只能截图。其实解决它只需要一条命令。

先把项目克隆到本地并装好依赖：

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

然后粘贴链接：

python run.py -u "https://v.douyin.com/你的短链"

命令中的-u是 URL 参数，短链会自动解析成真实地址。稍等片刻，视频（无水印、自动挑最高清）连同封面、音乐和 JSON 元数据，就出现在Downloaded/目录里了。开头这几步，你甚至不需要配置任何东西。

痛点二：创作者主页的批量备份

单条下载只是开胃菜。真正的刚需是：喜欢一个博主，想把 ta 的作品全部保存下来，下次还想只下载新增的。

这时候你需要登录凭证。运行 cookie 获取脚本，按提示在浏览器登录后回到终端按回车，Cookie 会自动写进配置：

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

接着把主页链接丢给工具：

python run.py -u "https://www.douyin.com/user/主页sec_uid" -t 8

-t 8表示 8 个并发线程（默认 5）。默认下载发布作品，如果想扩展，在config.yml里把mode改成这样：

mode: - post # 发布的 - like # 点赞的 - mix # 合集的 - music # 原声的

配合number.post、start_time/end_time可以限定数量和时间范围；开启increase.post: true后，下次运行只会抓新增作品——增量更新配合 SQLite 去重，重复内容直接跳过。

上图是批量下载时的真实输出：逐个作品显示进度和耗时，失败项也会单独标注。

痛点三：合集、音乐和直播回放

短视频平台最容易被忽略的三类资源：合集、背景音乐、直播。douyin-downloader 对它们分别有独立入口：

• 合集链接（/collection/xxx）整体下载，或对主页启用mix模式；
• 音乐链接（/music/xxx）优先保存原声文件，缺失时回退到该音乐下的首条作品；
• 直播链接（live.douyin.com/房间号）转为 FLV/HLS 录制流，主播下播时已录数据会被保留。

直播场景下，工具会先展示房间标题、在线人数和清晰度选项，再输出可供录制的流地址。

痛点四：看不到进度，也不知道存到哪

很多下载工具像黑箱：跑起来之后只剩一个光标在闪。这个项目的体验是反过来的——Rich 进度条实时汇报"解析链接→创建下载器→执行下载→记录历史"，每个环节都看得见。

下载完成后，文件按"日期_标题"组织成目录，比如：

如果你不喜欢这种嵌套，配置里把folderstyle关掉，所有文件平铺在同一个目录；progress.quiet_logs设为 true 还能让日志保持安静。

痛点五：Cookie 失效与意外中断

下载量一大，最怕两件事：登录态过期、网络抖动。项目内置了RetryHandler（指数退避重试）和"登录失效自动重新登录"机制——检测到未登录时，会尝试打开浏览器引导你重新登录，成功后自动续跑，而不是让你从头再来。

单条命令的写法也足够灵活：

python run.py -u "链接1" -u "链接2" -t 5

多个-u一次排队处理；某条失败不会拖垮整批任务，结果会汇总成"成功/失败/跳过"三列统计。

进阶玩法：热搜、搜索与 REST API

下载之外，这套代码还藏了几个"顺手"的能力，适合做内容运营的人：

python run.py --hot-board 50 # 拉取热搜榜并导出 JSONL python run.py --search "美食教程" # 关键词搜索作品并导出 python run.py --serve --serve-port 8000 # 启动 REST API，供其他程序调用

配合通知推送（Bark / Telegram / Webhook），长任务跑完手机就能收到结果。想深入研究的读者，可以翻翻cli/main.py看子命令如何组织，config.example.yml里每项配置都有注释，docs/superpowers/下还有设计文档。

功能一览：按需求选命令

下一步建议：先用单条视频验证整条链路；再配好 Cookie 跑一个主页的增量备份；最后按需打开直播或热搜功能。工具只是把"复制→粘贴→等待"变得可信，真正值得尊重的，永远是内容本身——下载之后，记得只在个人学习、备份和合理引用范围内使用。会管理内容的人，先学会管理自己的下载习惯。

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