抖音视频批量下载、直播回放与合集备份一款开源工具的完整实操指南【免费下载链接】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 的定位完全不同它更像一个内容仓库搬运工加仓库管理员的结合体能批量不只单条下载作者主页几百上千条作品一条命令按顺序全部拿下能去水印自动优先挑选无水印的视频源画质还不缩水能挑画质根据视频的码率信息自动挑选最高清版本能防重复下载过的内容会被记录下次运行自动跳过不会把硬盘塞满垃圾文件能自动归档按作者、类型、日期生成清晰的目录结构找东西不再翻半天。说白了它解决的是一整类问题而不是单个问题。你只需要告诉它要什么剩下的事它自己安排得明明白白。这些能力分散在仓库的不同模块里比如负责下载策略的core/user_modes/、负责文件组织的storage/file_manager.py、负责去重记录的storage/database.py。装好之后感兴趣的话可以自己去源码里逛逛都是结构清晰、注释完整的 Python 代码。装环境没你想的那么难三条命令就能跑起来可能你一看命令行工具四个字就想打退堂鼓。别急整个安装过程其实非常直接前提是你电脑上装有 Python 3.8 或更高版本——macOS、Linux、Windows 都能跑。先把仓库拉下来git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt装完依赖再复制一份配置文件作为起点cp config.example.yml config.yml如果你后面想用到浏览器兜底能力比如翻页被限制时自动弹出浏览器辅助验证就再多装一个可选依赖pip install playwright python -m playwright install chromium看到这里环境部分就结束了。是不是比想象中简单登录这一步扫码就能搞定不用再手抄 Cookie用过同类工具的人应该都有同感最劝退的往往不是下载本身而是认证环节手动打开浏览器的开发者工具翻 Cookie复制一大串ttwid、odin_tt、sid_guard……看得人头皮发麻稍不留神还复制错。douyin-downloader 把这一步做成了半自动。仓库里自带一个专门的 Cookie 获取工具运行后它会自动打开浏览器窗口你只需要扫码登录回到终端按一下回车登录凭证就被自动写进配置文件了python -m tools.cookie_fetcher --config config.yml整个过程不需要你碰任何技术细节。万一哪天登录过期了重新跑一遍这条命令就行全程两分钟。第一个完整实例从粘贴链接到文件落盘纸上谈兵说得再多不如实际跑一次。我们拿最简单的下载单个视频来走一遍全流程。首先把视频链接填进配置文件link: - https://www.douyin.com/video/7604129988555574538 path: ./Downloaded/ mode: - post然后运行python run.py -c config.yml你会看到终端里出现一个实时刷新的进度界面包含线程数、保存路径、成功与失败统计等信息下载完成后打开保存目录你会看到一个结构清晰的文件夹。里面不只是视频本身封面图、背景音乐、作者头像、元数据 JSON 全都被整整齐齐地收好了别小看这个顺手把封面和音乐也存了的设计。以后做视频剪辑、找配乐、攒素材的时候你会由衷感谢这些当初觉得有点多余的文件。不同类型的抖音内容下载姿势各有讲究单个视频只是开胃菜。这个工具真正让人上瘾的地方在于它对不同内容类型的完整覆盖。下面按类型过一遍每一类都对应一种链接格式和配置方式。作者主页批量下载喜欢一个博主就把他整个主页备份下来这是使用频率最高的场景。把链接从单条视频换成用户主页link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx mode: - post number: post: 50 # 想全量下载就写 0mode字段决定了抓什么内容post是发布的作品like是点赞过的内容mix是合集music是用过的音乐。这几个模式还能同时写在一起工具会自动去重——同一个作品不会因为在不同模式里出现过就被重复下载。抓取合集时终端会先提示正在获取合集下的所有作品数据因为需要翻很多次请求耐心等一小会儿就能看到每个视频的进度条逐一走满直播录制与回放趁还在赶紧把整场录下来直播是另一个让很多人专门跑来用它的理由。直播结束之后回放链接随时可能失效只有当场录下来最保险。把链接指向直播间地址再配上直播相关参数即可link: - https://live.douyin.com/123456789 live: max_duration_seconds: 0 # 0 表示一直录到主播下播 chunk_size: 65536 idle_timeout_seconds: 30运行后工具会解析直播间信息、列出当前可用的清晰度选项然后开始拉流下载录制支持 FLV 和 HLS 两种流格式。即使中途网络断开、或者主播提前下播已经录下来的部分也会被完整保留不会前功尽弃。录完的文件存放在Downloaded/{作者}/live/目录下旁边还附带着直播间的元数据快照。图文、单条合集、单首音乐按需精准下载除了上面两大类其他内容类型也都预留了入口粘贴对应链接即可图文作品/note/{id}或/gallery/{id}单个合集/collection/{id}或/mix/{id}单个音乐/music/{id}优先抓原声文件短链接v.douyin.com开头的分享链接会自动解析成真实地址。更有意思的是你还能用--search 关键词按关键词搜索作品并导出结果或者用--hot-board 30拉取热搜榜快照。对做选题调研、数据收集的人来说这俩功能简直像白送的彩蛋。进阶玩法这些隐藏开关才是效率翻倍的钥匙基础用法跑通之后我建议你把下面这几个配置好好研究一下。它们每一个都能解决一类实实在在的麻烦。增量下载只抓新的不重复劳动第一次把博主主页全量备份之后之后每次更新只需要打开增量开关increase: post: true database: true工具会对比数据库里已有的记录只下载上次之后新发布的作品。追更博主的正确姿势就是从全量备份平滑切换到增量更新。并发与重试速度与稳定可以兼得默认情况下工具用 5 个线程并发下载失败会自动重试 3 次并对请求做速率限制避免把自己限流。如果你的网络状况很好可以把线程数调大python run.py -c config.yml -t 8也可以在配置里用proxy项挂上代理应对网络不稳定的场景。时间过滤只想要某段时间的作品start_time和end_time两个参数能精确限定只下载指定日期范围内的内容。比如只想备份某位博主今年发的视频写清楚起止日期即可历史旧作一条都不会多下。下载完成通知人不必一直守在电脑前下载量大时总不可能一直盯着终端。配置里支持 Bark、Telegram、Webhook 三种通知渠道全部下载完成后会主动推送消息。晚上睡觉前挂个任务第二天醒来收通知省心得很。视频转写把声音变成可检索的文字如果开启转写功能工具会调用 OpenAI 的语音转文字接口为视频生成 txt 和 json 两种格式的文字稿。做访谈整理、视频字幕、内容检索时非常有用。注意这个功能目前只对视频作品生效图文不会生成转写。REST API 服务模式把下载能力打包成接口额外安装 fastapi 和 uvicorn 之后可以用python run.py --serve --serve-port 8000把整个工具变成一个本地服务通过 HTTP 接口提交链接、查询任务状态。这个玩法比较适合有编程基础、想把它接进自己自动化流程的朋友。不想碰命令行桌面版客户端了解一下命令行虽然强大但对完全不想碰终端的人来说还是有点门槛。好消息是项目基于同一套后端还提供了一个叫 Douzy 的桌面客户端——图形界面操作粘贴链接就能开始桌面版把命令行里的核心能力都搬进了界面可视化跟踪下载进度、集中管理多个任务、随时查看历史下载档案目前桌面版还处于内测阶段想尝鲜的话可以去项目 Releases 页面下载安装包。新手最容易踩的坑提前帮你排一排写到这里我把使用中最常见的几个坑集中列出来希望你能少走弯路。翻页被限制只能抓到前 20 条作品这是平台风控的常见现象。解决方法是开启浏览器兜底browser_fallback.enabled: true并把headless设为false。这样程序会弹出真实浏览器窗口你手动完成一次验证翻页就能继续下去。Cookie 失效下载开始报错不用慌重新运行一遍前面说过的 Cookie 获取命令几分钟就恢复。想重新下载某个视频但程序总是跳过这是因为工具通过数据库记录 本地文件双重检查来判断是否下载过。想强制重下需要同时清理对应的数据库记录和本地文件缺一个都不行。文件夹命名乱成一团默认命名模板是{date}_{title}_{id}自带作品 ID基本不会重名。如果担心作者改名导致目录分裂可以把author_dir设为nickname_uid兼顾直观和稳定。终端刷屏太多默认已经开启了progress.quiet_logs静默模式调试时再用-v打开详细日志也不迟。写在最后文章最后还是要认真提醒一句这个工具的本意是帮你在合规的前提下管理自己的个人数据和学习资料。请一定把它用在正途上——尊重创作者版权、不用于商业用途、不过度频繁地抓取。平台规则和接口策略随时可能变化功能偶尔失效属于正常的技术风险保持平常心就好。如果你正打算建立自己的抖音内容资源库不妨今天就动手试一试。从下载第一条视频开始到把整个收藏夹都搬到本地你会发现曾经那些想留留不住的遗憾原来可以这么简单地解决。【免费下载链接】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），仅供参考 抖音视频批量下载、直播回放与合集备份：一款开源工具的完整实操指南
抖音视频批量下载、直播回放与合集备份一款开源工具的完整实操指南【免费下载链接】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 的定位完全不同它更像一个内容仓库搬运工加仓库管理员的结合体能批量不只单条下载作者主页几百上千条作品一条命令按顺序全部拿下能去水印自动优先挑选无水印的视频源画质还不缩水能挑画质根据视频的码率信息自动挑选最高清版本能防重复下载过的内容会被记录下次运行自动跳过不会把硬盘塞满垃圾文件能自动归档按作者、类型、日期生成清晰的目录结构找东西不再翻半天。说白了它解决的是一整类问题而不是单个问题。你只需要告诉它要什么剩下的事它自己安排得明明白白。这些能力分散在仓库的不同模块里比如负责下载策略的core/user_modes/、负责文件组织的storage/file_manager.py、负责去重记录的storage/database.py。装好之后感兴趣的话可以自己去源码里逛逛都是结构清晰、注释完整的 Python 代码。装环境没你想的那么难三条命令就能跑起来可能你一看命令行工具四个字就想打退堂鼓。别急整个安装过程其实非常直接前提是你电脑上装有 Python 3.8 或更高版本——macOS、Linux、Windows 都能跑。先把仓库拉下来git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt装完依赖再复制一份配置文件作为起点cp config.example.yml config.yml如果你后面想用到浏览器兜底能力比如翻页被限制时自动弹出浏览器辅助验证就再多装一个可选依赖pip install playwright python -m playwright install chromium看到这里环境部分就结束了。是不是比想象中简单登录这一步扫码就能搞定不用再手抄 Cookie用过同类工具的人应该都有同感最劝退的往往不是下载本身而是认证环节手动打开浏览器的开发者工具翻 Cookie复制一大串ttwid、odin_tt、sid_guard……看得人头皮发麻稍不留神还复制错。douyin-downloader 把这一步做成了半自动。仓库里自带一个专门的 Cookie 获取工具运行后它会自动打开浏览器窗口你只需要扫码登录回到终端按一下回车登录凭证就被自动写进配置文件了python -m tools.cookie_fetcher --config config.yml整个过程不需要你碰任何技术细节。万一哪天登录过期了重新跑一遍这条命令就行全程两分钟。第一个完整实例从粘贴链接到文件落盘纸上谈兵说得再多不如实际跑一次。我们拿最简单的下载单个视频来走一遍全流程。首先把视频链接填进配置文件link: - https://www.douyin.com/video/7604129988555574538 path: ./Downloaded/ mode: - post然后运行python run.py -c config.yml你会看到终端里出现一个实时刷新的进度界面包含线程数、保存路径、成功与失败统计等信息下载完成后打开保存目录你会看到一个结构清晰的文件夹。里面不只是视频本身封面图、背景音乐、作者头像、元数据 JSON 全都被整整齐齐地收好了别小看这个顺手把封面和音乐也存了的设计。以后做视频剪辑、找配乐、攒素材的时候你会由衷感谢这些当初觉得有点多余的文件。不同类型的抖音内容下载姿势各有讲究单个视频只是开胃菜。这个工具真正让人上瘾的地方在于它对不同内容类型的完整覆盖。下面按类型过一遍每一类都对应一种链接格式和配置方式。作者主页批量下载喜欢一个博主就把他整个主页备份下来这是使用频率最高的场景。把链接从单条视频换成用户主页link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx mode: - post number: post: 50 # 想全量下载就写 0mode字段决定了抓什么内容post是发布的作品like是点赞过的内容mix是合集music是用过的音乐。这几个模式还能同时写在一起工具会自动去重——同一个作品不会因为在不同模式里出现过就被重复下载。抓取合集时终端会先提示正在获取合集下的所有作品数据因为需要翻很多次请求耐心等一小会儿就能看到每个视频的进度条逐一走满直播录制与回放趁还在赶紧把整场录下来直播是另一个让很多人专门跑来用它的理由。直播结束之后回放链接随时可能失效只有当场录下来最保险。把链接指向直播间地址再配上直播相关参数即可link: - https://live.douyin.com/123456789 live: max_duration_seconds: 0 # 0 表示一直录到主播下播 chunk_size: 65536 idle_timeout_seconds: 30运行后工具会解析直播间信息、列出当前可用的清晰度选项然后开始拉流下载录制支持 FLV 和 HLS 两种流格式。即使中途网络断开、或者主播提前下播已经录下来的部分也会被完整保留不会前功尽弃。录完的文件存放在Downloaded/{作者}/live/目录下旁边还附带着直播间的元数据快照。图文、单条合集、单首音乐按需精准下载除了上面两大类其他内容类型也都预留了入口粘贴对应链接即可图文作品/note/{id}或/gallery/{id}单个合集/collection/{id}或/mix/{id}单个音乐/music/{id}优先抓原声文件短链接v.douyin.com开头的分享链接会自动解析成真实地址。更有意思的是你还能用--search 关键词按关键词搜索作品并导出结果或者用--hot-board 30拉取热搜榜快照。对做选题调研、数据收集的人来说这俩功能简直像白送的彩蛋。进阶玩法这些隐藏开关才是效率翻倍的钥匙基础用法跑通之后我建议你把下面这几个配置好好研究一下。它们每一个都能解决一类实实在在的麻烦。增量下载只抓新的不重复劳动第一次把博主主页全量备份之后之后每次更新只需要打开增量开关increase: post: true database: true工具会对比数据库里已有的记录只下载上次之后新发布的作品。追更博主的正确姿势就是从全量备份平滑切换到增量更新。并发与重试速度与稳定可以兼得默认情况下工具用 5 个线程并发下载失败会自动重试 3 次并对请求做速率限制避免把自己限流。如果你的网络状况很好可以把线程数调大python run.py -c config.yml -t 8也可以在配置里用proxy项挂上代理应对网络不稳定的场景。时间过滤只想要某段时间的作品start_time和end_time两个参数能精确限定只下载指定日期范围内的内容。比如只想备份某位博主今年发的视频写清楚起止日期即可历史旧作一条都不会多下。下载完成通知人不必一直守在电脑前下载量大时总不可能一直盯着终端。配置里支持 Bark、Telegram、Webhook 三种通知渠道全部下载完成后会主动推送消息。晚上睡觉前挂个任务第二天醒来收通知省心得很。视频转写把声音变成可检索的文字如果开启转写功能工具会调用 OpenAI 的语音转文字接口为视频生成 txt 和 json 两种格式的文字稿。做访谈整理、视频字幕、内容检索时非常有用。注意这个功能目前只对视频作品生效图文不会生成转写。REST API 服务模式把下载能力打包成接口额外安装 fastapi 和 uvicorn 之后可以用python run.py --serve --serve-port 8000把整个工具变成一个本地服务通过 HTTP 接口提交链接、查询任务状态。这个玩法比较适合有编程基础、想把它接进自己自动化流程的朋友。不想碰命令行桌面版客户端了解一下命令行虽然强大但对完全不想碰终端的人来说还是有点门槛。好消息是项目基于同一套后端还提供了一个叫 Douzy 的桌面客户端——图形界面操作粘贴链接就能开始桌面版把命令行里的核心能力都搬进了界面可视化跟踪下载进度、集中管理多个任务、随时查看历史下载档案目前桌面版还处于内测阶段想尝鲜的话可以去项目 Releases 页面下载安装包。新手最容易踩的坑提前帮你排一排写到这里我把使用中最常见的几个坑集中列出来希望你能少走弯路。翻页被限制只能抓到前 20 条作品这是平台风控的常见现象。解决方法是开启浏览器兜底browser_fallback.enabled: true并把headless设为false。这样程序会弹出真实浏览器窗口你手动完成一次验证翻页就能继续下去。Cookie 失效下载开始报错不用慌重新运行一遍前面说过的 Cookie 获取命令几分钟就恢复。想重新下载某个视频但程序总是跳过这是因为工具通过数据库记录 本地文件双重检查来判断是否下载过。想强制重下需要同时清理对应的数据库记录和本地文件缺一个都不行。文件夹命名乱成一团默认命名模板是{date}_{title}_{id}自带作品 ID基本不会重名。如果担心作者改名导致目录分裂可以把author_dir设为nickname_uid兼顾直观和稳定。终端刷屏太多默认已经开启了progress.quiet_logs静默模式调试时再用-v打开详细日志也不迟。写在最后文章最后还是要认真提醒一句这个工具的本意是帮你在合规的前提下管理自己的个人数据和学习资料。请一定把它用在正途上——尊重创作者版权、不用于商业用途、不过度频繁地抓取。平台规则和接口策略随时可能变化功能偶尔失效属于正常的技术风险保持平常心就好。如果你正打算建立自己的抖音内容资源库不妨今天就动手试一试。从下载第一条视频开始到把整个收藏夹都搬到本地你会发现曾经那些想留留不住的遗憾原来可以这么简单地解决。【免费下载链接】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），仅供参考