抖音批量下载的完整攻略:从单条视频到整个作者主页,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
douyin-downloader 是一个开源的抖音批量下载工具,主打无水印下载,视频、图集、合集、音乐都能处理,还能从作者主页整页批量抓取。一句话概括它的价值:把你喜欢的每一条抖音内容,变成本地一份干干净净、随时可回看的文件。
那个深夜,我弄丢了自己的收藏夹
事情要从一个普通的周四晚上说起。我照例睡前刷抖音,刷到一个很喜欢的博主的教程视频,顺手点了"收藏",心里想着"改天再看"。改天来了,收藏夹里那个位置却只剩一行灰色小字:作品已删除。
那一刻我突然意识到一件事——收藏不等于拥有。平台可以下架、作者可以删号、视频可以变灰,而你能在本地硬盘里真正留住的,只有那份实实在在的文件。
我试过手动保存:长按"保存本地",下来的永远是带水印的版本;录屏?画质糊得没法看;去第三方网站解析,要么弹广告,要么偷偷收费,要么给你一个模糊到怀疑人生的"高清"。更别提当你想把一位创作者几百条视频都存下来时,手动操作根本就是一场体力消耗战。
于是问题来了:如果有一件事,能一次解决"去水印、批量抓取、自动分类、绝不重复下载",你愿意花几分钟配置吗?
第一条命令:一条链接换一个干净的视频
douyin-downloader 用 Python 写成,把"下载抖音内容"拆成了四步:粘贴链接 → 解析内容 → 去水印 → 存进本地。你不需要懂任何代码,只要会复制粘贴。
第一次使用,需要先拿到你的Cookie——你可以把它理解成"登录凭证",让工具以你的身份访问抖音接口。项目内置了自动获取工具,跟着引导在浏览器里登录一次就行:
# 1. 克隆项目 git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader/douyin-downloader # 2. 安装依赖 pip install -r requirements.txt # 3. 复制配置模板 cp config.example.yml config.yml # 4. 自动获取 Cookie(相当于登录凭证,首次必做) python -m tools.cookie_fetcher --config config.yml登录抖音后回到终端按回车,Cookie 会自动写进配置。接下来,把任何一条作品链接喂给它:
# 下载单个视频,-u 可以重复传入多个链接 python run.py -c config.yml -u "https://www.douyin.com/video/7604129988555574538"它会自动挑选无水印的视频源,从码率列表里选最高清的那一档,然后把视频、封面、背景音乐、JSON 元数据整整齐齐放进同一个文件夹,每一步实时进度都显示在命令行里:
命令行版下载现场:进度一目了然,已存在的文件会被自动跳过。
如果不想碰命令行,项目还有一个桌面客户端Douzy,粘贴链接、勾选内容类型、点击开始即可:
桌面版"下载"页:粘贴链接后自动识别作品、喜欢、合集,勾选即下载。
从"一条链接"到"一个主页"
单条下载只是热身。真正让我"回不去"的,是它的作者主页批量下载。
想象这个场景:你关注一位创作者半年了,想给 ta 建一份"作品全集"留在本地。手动翻页一条条另存为?几百条视频,可能要搭上一个完整周末。而用 douyin-downloader,只需要一段几乎不用改的配置:
# config.yml 片段:整页抓取某位作者的全部作品 link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx # 作者主页链接 mode: - post # post=发布的作品,like=喜欢,mix=合集,music=音乐 number: post: 0 # 0 表示全量下载,填 50 则只下最近 50 条 path: ./Downloaded/ thread: 5 # 并发数,网络差可以调低到 2~3 database: true # 开启 SQLite 去重(SQLite 是一个轻量级本地数据库文件) filename_template: "{date}_{title}_{id}" # 文件名模板,必须包含 {id} 防重名运行python run.py -c config.yml,剩下的交给它。下载完成的文件会自动按"作者 → 模式 → 单个作品"三层结构归档:
每个作品一个独立文件夹,视频、封面、音乐、元数据都在里面,按日期排序非常清爽。
这里有个很加分的细节:SQLite 去重 + 本地文件双重检查。同一个作品,就算你既下载了它的"作品"又下载了"合集",也只会保存一份;第二次运行遇到已存在的文件,直接跳过。再配合increase.post: true开启增量下载——只补新增内容,把"备份一位创作者"变成一条可以每天定时执行的例行公事。桌面版的"任务中心"和"实时进度"页,则把这一切变成了看得见的状态:
任务中心(上)统计进行中、成功与失败的任务;实时进度页(下)逐任务展示处理到哪一步。
三种人,三种玩法
工具说到底是给人用的。同样是"下载抖音内容",不同的人用起来完全是三种形态:
内容创作者:把别人的主页变成自己的素材库。想研究竞品选题?把目标博主的链接填进link,mode同时开post和mix(mix 就是合集,作者把同主题视频打包成的系列),再配一个定时任务每周跑一次增量,一个持续更新的学习资料库就自动长出来了。
数据分析师:内容不只是视频,更是数据。打开comments.enabled: true,每个作品会额外生成一份*_comments.json评论数据,还能带上二级回复;想追热点,用--hot-board 30拉热搜榜快照;想研究某个话题,用--search抓搜索结果。配合start_time/end_time做时间过滤,以及可选的语音转写(transcript.enabled: true),视频还能直接变成可检索的文字稿。
# 一键导出抖音热搜榜前 30 条,存成 JSONL(一种每行一条记录的 JSON 格式) python run.py --hot-board 30 -p ./Downloaded # 按关键词搜索并导出结果 python run.py --search "猫咪" --search-max 100 -p ./Downloaded普通用户:备份自己的收藏夹和喜欢的直播。把链接换成https://www.douyin.com/user/self?showTab=favorite_collection,mode: [collect],你的收藏夹会原样搬进本地;遇到喜欢的直播,直接把直播间链接丢给它,录到主播下播为止,中途断网或手动中断,已录的字节也会保留下来:
直播录制模式:自动识别直播间、选择清晰度、拿到流地址开始录制。
风控来了也不慌:藏在配置里的兜底设计
用第三方工具最怕的就是"突然失效"。douyin-downloader 把最常见的坑都预埋了解决方案:
- 只抓到 20 条作品就停了?这是典型的翻页风控。开启
browser_fallback.enabled: true,并保持headless: false,工具会在翻页受限时自动弹出一个浏览器窗口,你手动过一下验证码(别急着关窗口),它接着往下翻——这就是它名字里的"浏览器兜底"。 - Cookie 过期、突然报错?重新跑一遍
python -m tools.cookie_fetcher --config config.yml,一分钟搞定。 - 下载到一半断网,文件不完整?内置完整性校验会比对文件大小,不完整的文件自动清理后重试,配合指数退避的重试策略(1 秒、2 秒、5 秒递增),网络再烂也能扛过去。
- 日志刷屏看得眼花?配置里
progress.quiet_logs: true一开,进度阶段自动安静下来。
等玩熟了,还有更多用法等着你解锁:python run.py --serve --serve-port 8000直接跑成 REST API 服务,把下载能力暴露给其他程序调用;下载完成后还能推送到 Bark、Telegram 或企业微信 Webhook,任务结束手机立刻知道。
把下载变成习惯
回头看那个弄丢收藏夹的深夜,我最后悔的不是"没保存",而是"以为收藏了就等于拥有"。现在我会定期跑一遍 douyin-downloader,把喜欢的作者、收藏的内容、甚至追过的直播,都变成本地一份份有名字、有日期、有封面的干净文件。
如果你也在意自己的内容资产,不妨花 30 分钟把上面这几步走一遍:克隆项目、获取 Cookie、粘贴第一条链接,然后——给项目点个 Star,让它陪你走得再久一点。
最后说句正经话:请合理使用下载工具。它适合个人学习、研究、数据备份与内容管理,请尊重创作者的劳动成果和平台规则,不要用于商业用途或侵犯他人权益。工具本身只负责把"喜欢"变成"拥有",怎么用,取决于你。
【免费下载链接】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),仅供参考