一次备份1000条抖音视频要多久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-downloaderdouyin-downloader 是一款开源的抖音批量下载工具解决手动保存视频又慢又带水印的问题主打去水印、视频/图文/合集/音乐多类型批量下载并内置并发加速、SQLite 去重和浏览器兜底。下文从一个真实任务出发完整走一遍它的上手流程和配置逻辑。从一次以为很简单的备份说起朋友要做一个美食博主的竞品分析需求很朴素把这位博主主页上的作品全部存下来无台标水印带发布时间方便后续按日期归档。他先试了手动方案——打开主页逐条点进视频等加载完用网页端右键另存。结果发现三点一是主页往下翻到 20 条左右就刷不动了二是网页右键存下来的视频带水印三是每条视频要命名、建文件夹干到第 15 条就放弃了。这个场景几乎概括了抖音内容采集的全部痛点翻页受限、水印残留、人工归档成本高。而 douyin-downloader 解决的正是这三件事。它不是一个只能下载单条视频的小脚本而是把解析链接 → 抓取列表 → 并发下载 → 去重登记 → 归档命名整条链路做成了配置化的流水线。第一条命令从拿到工具到跑通下载先克隆并安装依赖git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt安装之后不用急着研究代码项目根目录的run.py就是入口。第一次使用需要给工具配 Cookie用于通过平台的接口鉴权项目里已经提供了自动获取脚本python cookie_extractor.py跑完会在本地生成可用的登录态文件。接下来写最小配置复制项目里的config.example.yml改成这样link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx path: ./Downloaded/ mode: - post number: post: 100 thread: 5 retry_times: 3 database: true运行python run.py -c config.yml就这么几行配置工具会完成解析主页链接 → 拉取该博主最近的 100 条作品 → 按 5 线程并发下载 → 每成功一条写入 SQLite 登记 → 按作者名/post/日期_标题_视频id的目录结构归档。首次跑通的体验比预期省事得多。配置文件拆解五个旋钮控制下载行为这个工具的复杂度几乎全部收敛在 YAML 配置里。看懂下面五组配置就等于掌握了大半功能。链接类型与下载模式一条配置适配四种内容link不只支持用户主页还支持单条视频链接、图文笔记链接、短链v.douyin.com/...会自动先解析再下载、合集链接、音乐链接、甚至直播间链接。链接类型不同mode的语义也不同链接类型mode 可选值作用用户主页/user/xxxpost下载博主发布的作品用户主页like下载博主公开点赞的内容用户主页mix下载博主创建的所有合集用户主页music下载博主使用过的原声音乐合集链接/mix/xxx无需 mode直接下载该合集全部视频直播间链接/live/xxx无需 mode录制直播流对应到项目代码里每种模式都有独立的策略实现比如用户主页批量下载在core/user_downloader.py合集在core/mix_downloader.py音乐在core/music_downloader.py直播在core/live_downloader.py由core/downloader_factory.py按链接类型自动选择。数量与增量全量备份还是只补新的number.post: 100限制最多下载 100 条。更有用的是increase字段number: post: 100 like: 50 increase: post: trueincrease: true开启增量模式工具会先查 SQLite 里已经下载过的视频 id只下载新出现的作品。配合定时任务就可以实现每天自动补抓博主新发的视频而不必每次全量重下。这是做长期监控类任务的刚需。并发与重试批量下载提速的两个参数thread: 5是并发线程数retry_times: 3是失败重试次数。从实测看把thread从 1 提到 5100 条视频的耗时大致可以从线性翻页的十几分钟压缩到三到五分钟量级受网络带宽限制。retry_times对偶发的网络抖动很有效——抖音接口偶发超时是常态重试几次能显著提升成功率。两个参数都放在control/目录下实现rate_limiter.py控制请求频率避免被风控retry_handler.py管理重试退避。时间过滤与文件命名归档的隐形功臣start_time: 2025-01-01 end_time: 2025-12-31 filename_template: {date}_{title}_{id} folderstyle: truestart_time/end_time按作品发布时间过滤只下载指定时间窗口内的内容。filename_template支持{date} {title} {id} {author} {like_count}等变量模板里强制要求包含{id}防止重名覆盖。folderstyle: true时每个作品单独建目录视频、封面、音乐、元数据 JSON 分文件存放Downloaded/ └── 美食博主/ └── post/ └── 2025-06-01_深夜食堂系列_7344xxxx/ ├── 2025-06-01_深夜食堂系列_7344xxxx.mp4 ├── 2025-06-01_深夜食堂系列_7344xxxx_cover.jpg ├── 2025-06-01_深夜食堂系列_7344xxxx_music.mp3 └── 2025-06-01_深夜食堂系列_7344xxxx_data.json文件名里的日期用的是作品发布时间而不是下载时间这个细节对按时间归档非常关键——否则增量补抓时旧视频会以新日期重新落盘破坏时间线。Cookie 与浏览器兜底翻页被卡的兜底方案这是工具最有价值的两个设计。Cookie 配置支持三种方式cookies: auto自动获取、直接粘贴整串 Cookie 字符串、或按msToken/ttwid/odin_tt等键值对提供。Cookie 失效时CLI 会检测到登录态异常并提示重新获取不会静默失败。相关逻辑在auth/目录cookie_manager.py、ms_token_manager.py和tools/cookie_fetcher.py。浏览器兜底browser_fallback解决的是翻页风控。抖音接口对主页列表翻页有限制通常抓到 20 条左右就不再返回数据。此时工具会自动启动一个 Playwright 驱动的浏览器模拟真人滚动页面把作品 id 收集全再回头通过详情接口补齐每个视频的下载地址browser_fallback: enabled: true headless: false max_scrolls: 240headless: false时浏览器窗口会弹出如果遇到验证码手动完成一次验证后滚动继续窗口不要急着关。这套API 为主、浏览器补漏的混合策略是它下载成功率高于纯 API 或纯浏览器方案的关键实现代码在core/下的浏览器采集逻辑里。去重机制像图书馆的查重登记簿批量下载最怕重复浪费带宽和磁盘。这个项目做了两层去重思路很像图书馆的查重登记簿数据库去重SQLite默认dy_downloader.db里维护aweme表记录每个作品 id 的下载状态download_history表记录每次任务的总数、成功数和配置快照。重复提交同一个链接直接跳过。文件系统去重文件名模板强制包含{id}同一作品天然只能落盘一次即使数据库被误删也能靠文件名识别。另外每次任务结束后还会生成一份download_manifest.jsonl下载清单每行一条 JSON记录日期、作品 id、作者、标题、标签、文件路径。这份清单相当于任务的发货单后续要做数据统计或内容检索直接读它就行不用去翻文件系统。进阶功能速览评论、转写、通知与 API这几个能力不需要全部配齐但值得知道它们存在用到时能省大量时间。评论采集每个作品额外生成一份*_comments.json支持拉取二级回复可限制条数适合做舆情分析或教学素材。comments: enabled: true max_comments: 500视频转写调用 OpenAI 语音转写接口把视频语音变成文字稿输出 txt 和 json 两种格式适合做课程内容、访谈记录的文本化。transcript: enabled: true model: gpt-4o-mini-transcribe api_key_env: OPENAI_API_KEY完成通知支持 bark、telegram、webhook 三种渠道。批量任务跑在后台时下载完成或失败会自动推送到手机。webhook 可以对接企业微信机器人长任务结束直接群里收到消息。REST API 服务模式配置段server可以把工具以服务方式启动外部系统通过 HTTP 接口提交下载任务、查询进度适合把下载能力集成到自己的后台系统里。在douyin-downloader/server/app.py和server/jobs.py可以看到任务队列和状态管理的实现。桌面客户端仓库的img/desktop/目录里可以看到配套桌面版 Douzy 的界面截图基于同一套后端逻辑提供图形化操作。四个最常见的坑和对应的解法坑一只抓到 20 条作品。这是翻页风控的典型表现。确认browser_fallback.enabled: true如果还不行把headless设为false让浏览器弹出后手动完成验证。坑二Cookie 失效报登录态错误。重跑python cookie_extractor.py刷新 Cookie。项目在 CLI 层cli/main.py实现了登录失效检测会明确提示而不是闷头报错。坑三个别视频下载失败。视频可能已被删除或设为私密属于正常现象。工具会记录失败并继续处理剩余任务不阻塞整体。想看失败原因用python run.py -c config.yml --verbose看详细日志。坑四文件名乱、目录乱。大多数情况是没设置filename_template和author_dir。author_dir支持nickname直观、sec_uid稳定唯一、nickname_uid两者兼顾三种重度用户推荐最后一种。结语从第一条命令到自动化流水线回到开头的任务手动下载 15 条视频耗时一小时且带水印用 douyin-downloader 配好 Cookie 和模式后100 条作品几分钟内完成、无水印、按发布时间归档、进数据库去重。这个差距正是它存在的意义。如果你也想试试接下来只需要做三件事克隆项目pip install -r requirements.txt装好依赖跑一次python cookie_extractor.py获取登录态从config.example.yml复制一份配置填一个你自己的主页链接或视频链接python run.py -c config.yml启动。先跑通一条视频再逐步打开mode、increase、browser_fallback、transcript这些开关。工具的能力边界会在你实际使用中一点点清晰起来。【免费下载链接】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），仅供参考 一次备份1000条抖音视频要多久？douyin-downloader批量下载实测与配置拆解
一次备份1000条抖音视频要多久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-downloaderdouyin-downloader 是一款开源的抖音批量下载工具解决手动保存视频又慢又带水印的问题主打去水印、视频/图文/合集/音乐多类型批量下载并内置并发加速、SQLite 去重和浏览器兜底。下文从一个真实任务出发完整走一遍它的上手流程和配置逻辑。从一次以为很简单的备份说起朋友要做一个美食博主的竞品分析需求很朴素把这位博主主页上的作品全部存下来无台标水印带发布时间方便后续按日期归档。他先试了手动方案——打开主页逐条点进视频等加载完用网页端右键另存。结果发现三点一是主页往下翻到 20 条左右就刷不动了二是网页右键存下来的视频带水印三是每条视频要命名、建文件夹干到第 15 条就放弃了。这个场景几乎概括了抖音内容采集的全部痛点翻页受限、水印残留、人工归档成本高。而 douyin-downloader 解决的正是这三件事。它不是一个只能下载单条视频的小脚本而是把解析链接 → 抓取列表 → 并发下载 → 去重登记 → 归档命名整条链路做成了配置化的流水线。第一条命令从拿到工具到跑通下载先克隆并安装依赖git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt安装之后不用急着研究代码项目根目录的run.py就是入口。第一次使用需要给工具配 Cookie用于通过平台的接口鉴权项目里已经提供了自动获取脚本python cookie_extractor.py跑完会在本地生成可用的登录态文件。接下来写最小配置复制项目里的config.example.yml改成这样link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx path: ./Downloaded/ mode: - post number: post: 100 thread: 5 retry_times: 3 database: true运行python run.py -c config.yml就这么几行配置工具会完成解析主页链接 → 拉取该博主最近的 100 条作品 → 按 5 线程并发下载 → 每成功一条写入 SQLite 登记 → 按作者名/post/日期_标题_视频id的目录结构归档。首次跑通的体验比预期省事得多。配置文件拆解五个旋钮控制下载行为这个工具的复杂度几乎全部收敛在 YAML 配置里。看懂下面五组配置就等于掌握了大半功能。链接类型与下载模式一条配置适配四种内容link不只支持用户主页还支持单条视频链接、图文笔记链接、短链v.douyin.com/...会自动先解析再下载、合集链接、音乐链接、甚至直播间链接。链接类型不同mode的语义也不同链接类型mode 可选值作用用户主页/user/xxxpost下载博主发布的作品用户主页like下载博主公开点赞的内容用户主页mix下载博主创建的所有合集用户主页music下载博主使用过的原声音乐合集链接/mix/xxx无需 mode直接下载该合集全部视频直播间链接/live/xxx无需 mode录制直播流对应到项目代码里每种模式都有独立的策略实现比如用户主页批量下载在core/user_downloader.py合集在core/mix_downloader.py音乐在core/music_downloader.py直播在core/live_downloader.py由core/downloader_factory.py按链接类型自动选择。数量与增量全量备份还是只补新的number.post: 100限制最多下载 100 条。更有用的是increase字段number: post: 100 like: 50 increase: post: trueincrease: true开启增量模式工具会先查 SQLite 里已经下载过的视频 id只下载新出现的作品。配合定时任务就可以实现每天自动补抓博主新发的视频而不必每次全量重下。这是做长期监控类任务的刚需。并发与重试批量下载提速的两个参数thread: 5是并发线程数retry_times: 3是失败重试次数。从实测看把thread从 1 提到 5100 条视频的耗时大致可以从线性翻页的十几分钟压缩到三到五分钟量级受网络带宽限制。retry_times对偶发的网络抖动很有效——抖音接口偶发超时是常态重试几次能显著提升成功率。两个参数都放在control/目录下实现rate_limiter.py控制请求频率避免被风控retry_handler.py管理重试退避。时间过滤与文件命名归档的隐形功臣start_time: 2025-01-01 end_time: 2025-12-31 filename_template: {date}_{title}_{id} folderstyle: truestart_time/end_time按作品发布时间过滤只下载指定时间窗口内的内容。filename_template支持{date} {title} {id} {author} {like_count}等变量模板里强制要求包含{id}防止重名覆盖。folderstyle: true时每个作品单独建目录视频、封面、音乐、元数据 JSON 分文件存放Downloaded/ └── 美食博主/ └── post/ └── 2025-06-01_深夜食堂系列_7344xxxx/ ├── 2025-06-01_深夜食堂系列_7344xxxx.mp4 ├── 2025-06-01_深夜食堂系列_7344xxxx_cover.jpg ├── 2025-06-01_深夜食堂系列_7344xxxx_music.mp3 └── 2025-06-01_深夜食堂系列_7344xxxx_data.json文件名里的日期用的是作品发布时间而不是下载时间这个细节对按时间归档非常关键——否则增量补抓时旧视频会以新日期重新落盘破坏时间线。Cookie 与浏览器兜底翻页被卡的兜底方案这是工具最有价值的两个设计。Cookie 配置支持三种方式cookies: auto自动获取、直接粘贴整串 Cookie 字符串、或按msToken/ttwid/odin_tt等键值对提供。Cookie 失效时CLI 会检测到登录态异常并提示重新获取不会静默失败。相关逻辑在auth/目录cookie_manager.py、ms_token_manager.py和tools/cookie_fetcher.py。浏览器兜底browser_fallback解决的是翻页风控。抖音接口对主页列表翻页有限制通常抓到 20 条左右就不再返回数据。此时工具会自动启动一个 Playwright 驱动的浏览器模拟真人滚动页面把作品 id 收集全再回头通过详情接口补齐每个视频的下载地址browser_fallback: enabled: true headless: false max_scrolls: 240headless: false时浏览器窗口会弹出如果遇到验证码手动完成一次验证后滚动继续窗口不要急着关。这套API 为主、浏览器补漏的混合策略是它下载成功率高于纯 API 或纯浏览器方案的关键实现代码在core/下的浏览器采集逻辑里。去重机制像图书馆的查重登记簿批量下载最怕重复浪费带宽和磁盘。这个项目做了两层去重思路很像图书馆的查重登记簿数据库去重SQLite默认dy_downloader.db里维护aweme表记录每个作品 id 的下载状态download_history表记录每次任务的总数、成功数和配置快照。重复提交同一个链接直接跳过。文件系统去重文件名模板强制包含{id}同一作品天然只能落盘一次即使数据库被误删也能靠文件名识别。另外每次任务结束后还会生成一份download_manifest.jsonl下载清单每行一条 JSON记录日期、作品 id、作者、标题、标签、文件路径。这份清单相当于任务的发货单后续要做数据统计或内容检索直接读它就行不用去翻文件系统。进阶功能速览评论、转写、通知与 API这几个能力不需要全部配齐但值得知道它们存在用到时能省大量时间。评论采集每个作品额外生成一份*_comments.json支持拉取二级回复可限制条数适合做舆情分析或教学素材。comments: enabled: true max_comments: 500视频转写调用 OpenAI 语音转写接口把视频语音变成文字稿输出 txt 和 json 两种格式适合做课程内容、访谈记录的文本化。transcript: enabled: true model: gpt-4o-mini-transcribe api_key_env: OPENAI_API_KEY完成通知支持 bark、telegram、webhook 三种渠道。批量任务跑在后台时下载完成或失败会自动推送到手机。webhook 可以对接企业微信机器人长任务结束直接群里收到消息。REST API 服务模式配置段server可以把工具以服务方式启动外部系统通过 HTTP 接口提交下载任务、查询进度适合把下载能力集成到自己的后台系统里。在douyin-downloader/server/app.py和server/jobs.py可以看到任务队列和状态管理的实现。桌面客户端仓库的img/desktop/目录里可以看到配套桌面版 Douzy 的界面截图基于同一套后端逻辑提供图形化操作。四个最常见的坑和对应的解法坑一只抓到 20 条作品。这是翻页风控的典型表现。确认browser_fallback.enabled: true如果还不行把headless设为false让浏览器弹出后手动完成验证。坑二Cookie 失效报登录态错误。重跑python cookie_extractor.py刷新 Cookie。项目在 CLI 层cli/main.py实现了登录失效检测会明确提示而不是闷头报错。坑三个别视频下载失败。视频可能已被删除或设为私密属于正常现象。工具会记录失败并继续处理剩余任务不阻塞整体。想看失败原因用python run.py -c config.yml --verbose看详细日志。坑四文件名乱、目录乱。大多数情况是没设置filename_template和author_dir。author_dir支持nickname直观、sec_uid稳定唯一、nickname_uid两者兼顾三种重度用户推荐最后一种。结语从第一条命令到自动化流水线回到开头的任务手动下载 15 条视频耗时一小时且带水印用 douyin-downloader 配好 Cookie 和模式后100 条作品几分钟内完成、无水印、按发布时间归档、进数据库去重。这个差距正是它存在的意义。如果你也想试试接下来只需要做三件事克隆项目pip install -r requirements.txt装好依赖跑一次python cookie_extractor.py获取登录态从config.example.yml复制一份配置填一个你自己的主页链接或视频链接python run.py -c config.yml启动。先跑通一条视频再逐步打开mode、increase、browser_fallback、transcript这些开关。工具的能力边界会在你实际使用中一点点清晰起来。【免费下载链接】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），仅供参考