
从保存一个视频到搬回整个主页我的抖音批量下载实战记录【免费下载链接】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 值得花三分钟认识一下。这是一款开源的抖音批量下载工具主打无水印与高清画质单个视频、图文、合集、音乐、作者主页甚至直播都能下载到本地。下面是我从零到上手的完整记录也是踩过坑之后的实操指南。一切从一个存不下来的视频开始事情的起因很小我刷到一个讲历史的长视频想存下来在通勤路上慢慢看。按过去的习惯我先试了录屏——画质打折不说屏幕角落还带着抖音的水印和点赞动画怎么看怎么别扭。接着试了在线解析网站把链接粘进去跳出一堆弹窗广告下载回来的是一个被二次压缩的模糊版本。后来换了一款流行的下载器又要求注册登录、限制每天下载次数。三番五次折腾下来我意识到问题不在能不能下载而在于这些方案都解决不了同一件事批量下载与原始画质。单个视频都这么费劲那些想长期收藏的创作者主页和合集就更不用想了。三分钟装好这步比想象中顺利于是我开始找开源的方案最后落在了 douyin-downloader 上。它的安装过程没有想象中复杂四条命令搞定git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt cp config.example.yml config.yml简单拆解一下第一条把项目代码拿到本地第二条进入项目目录第三条安装全部依赖只需要 Python 3.8 以上的环境Windows、macOS、Linux 都能跑最后一条把示例配置复制成config.yml——之后你所有要改的参数都集中在这个文件里。这里有个小提醒如果你以后想用浏览器兜底或自动登录取 Cookie这两个能力还需要额外装一个 Playwright。这一步可以先跳过等真正用到再说不影响基础使用。真正的门槛是 Cookie不是代码装好之后我立刻兴冲冲地跑了一次下载结果全是请求失败、内容为空。查了项目文档才明白抖音需要登录态才能访问内容这一步绕不过去。工具为此提供了一个自动获取 Cookie 的命令python -m tools.cookie_fetcher --config config.yml运行后会自动弹出浏览器窗口你用手机抖音扫码登录回到终端按一下回车Cookie 就被自动写进config.yml。我在这里踩过一个坑第一次图省事从浏览器开发者工具里手动复制 Cookie 字段结果不是漏了字段就是格式不对折腾了半小时。后来老老实实用上面这条命令一分钟搞定。建议你也别手搓让工具自己来。再记一条经验Cookie 有有效期过段时间失效后下载会再次报错重新跑一遍上面的命令即可不用重装任何东西。第一个视频落地无水印原画质拿到 Cookie 后我先拿单个视频试水。在config.yml的link里贴上视频链接运行python run.py -c config.yml进度条走完Downloaded目录下多了这样一个结构Downloaded/ └── 作者名/ └── post/2026-08-14_视频标题_aweme_id/ ├── video.mp4 ├── cover.jpg ├── music.mp3 └── data.json这里有几个细节让我印象很深。第一视频真的没有水印——工具会优先挑选无水印的视频源这是默认行为不用额外配置。第二画质不是差不多就行而是按视频码率自动挑最高的那个视频和实况图都适用。第三除了视频本体封面、背景音乐、以及一个记录点赞数、评论数、发布时间的data.json元数据文件全都自动下载好了。对只想保存单个视频的人来说到这里其实已经够用。但真正让我觉得这工具不一样的是接下来的批量操作。贪心时刻一次拿回整个作者主页单视频顺利后我开始惦记那个历史博主的主页——几十个视频每个都好看要是一个个复制链接手会废。douyin-downloader 的做法是把链接换成作者主页地址再告诉它要下载哪些类型、最多下多少个。link: - https://www.douyin.com/user/MS4wLjABAAAA你的sec_uid mode: - post number: post: 50mode里可以写post发布作品、like点赞作品、mix合集、music音乐number则限制每个类型的下载数量写 0 表示不限制。我把post设成 50一键跑出了这位博主的最新几十个作品。批量下载能跑得这么放心靠的是两套去重机制数据库里记一笔本地文件再查一遍同一个视频怎么都不会重复下载。哪怕中途中断重跑一次已下载的部分会被自动跳过。 分享一个真实的踩坑经历当我把number.post调到 0全量下载后作品翻到第 20 条就停住了。这是抖音翻页风控的典型表现。解决方案就在配置里——开启browser_fallback让它启动浏览器继续翻页如果弹出验证码手动过一下再让它继续几百条作品也能完整抓下来。同一套命令还藏着合集、图集和音乐搞定作者主页批量下载之后我才发现之前看到的只是冰山一角。同一个link字段换成不同的链接前缀就对应不同的内容类型链接类型用途典型开头视频下载单个作品/video/{id}图文图集也能存不只视频/note/{id}、/gallery/{id}合集整个合集批量下载/collection/{id}、/mix/{id}音乐收藏原声/music/{id}主页作者主页批量下载/user/{sec_uid}抖音常见的短链v.douyin.com那种它也能自动解析不用手动去还原完整地址。对长期跟踪某个创作者的人来说还有个很实用的开关叫增量下载increase: post: true database: true开启后每次运行只下载新增的作品已下载过的直接跳过。我每周跑一次就能持续收集博主的新内容既省时间也不重复占硬盘。不同模式之间还共享同一套去重记录比如同一条视频既在发布作品里、又出现在合集里也只会下载一次。意外收获直播也能整段录下来真正让我意外的是直播录制。某天博主开直播讲干货我又想存下来抱着试试看的心态把直播间链接放进了linklink: - https://live.douyin.com/123456789 live: max_duration_seconds: 0max_duration_seconds设 0 表示录到主播下播为止。更贴心的是就算中途网络断开或者你手动按了 CtrlC 中断已经录下来的部分会被完整保留不会白录。⚠️ 一个小提醒直播录制目前还是实验性功能。录出来的 FLV 格式大部分播放器能直接放如果源是 HLS则需要用 ffmpeg 做一下后处理这一点项目文档里写得很清楚。从能用到好用的几个开关用顺了之后我又陆续打开了几个开关工具从能下载变成了很顺手评论采集在配置里开启comments.enabled每个视频会额外生成一份*_comments.json做内容分析时非常有用。热搜与搜索命令行里直接跑python run.py --hot-board 30拉热搜榜或python run.py --search 关键词按关键词搜索作品结果以 JSONL 格式落盘方便后续处理。完成通知下载完可以推送到 Bark、Telegram 或 Webhook。我习惯把批量下载挂在后台跑完手机上收到一条通知不用一直盯着终端。桌面版项目还提供了一个图形界面客户端粘贴链接、选择类型、查看任务状态都比命令行更直观。如果你不想记命令桌面版是更省心的选择如果你要做自动化命令行模式配合 REST API 服务--serve参数可以直接嵌进自己的脚本里。复盘它适合谁又该注意什么最后做个坦白。我用过的方案不算少把它们放在一起对比差距其实很直观对比项录屏 / 在线解析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创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考