抖音视频批量下载终极实测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手动存一条 30 秒的抖音视频复制链接、去水印、改文件名最快也要 1 分钟把 274 条作品这样逐条存下来基本等于搭上一个通宵。开源工具 douyin-downloader 专治抖音批量下载这个痛点去水印、支持视频/图集/合集/音乐/直播录制还自带去重、重试和进度条。读完本文你可以在 5 分钟内跑通第一条批量下载命令并拿到 4 个真实工作场景下可直接复制的配置。本文是一份面向普通用户的 douyin-downloader 实战教程不堆功能列表而是带着你从装环境、配 Cookie、写最小配置开始把下载这件事真正用起来。无论你是自媒体运营、学术研究者还是只想备份自己收藏的普通用户都适用。先看真实运行画面一次下载到底发生了什么第一次跑通命令后你会看到这样一个命令行界面画面分三个区域上方是下载配置总数、线程数、保存路径中间是批量下载进度每个文件的状态这里清晰写着跳过已存在下方是结果统计成功数量与用时。注意那个跳过已存在——它靠 SQLite 数据库记录 本地文件双重比对同一个作品下载过一次就自动跳过这正是后面所有增量玩法的地基。三分钟完成环境配置与 Cookie 获取动手之前先把环境准备好这一步只要三条命令。git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt如果你打算用浏览器兜底功能翻页被风控时自动开浏览器帮你过验证码或者想自动获取 Cookie再多装一个 Playwrightpip install playwright python -m playwright install chromium接下来是很多新手最容易卡住的一步——Cookie。工具已经帮你封装好了python -m tools.cookie_fetcher --config config.yml这个命令会自动打开浏览器你登录抖音后回到终端按一下回车Cookie 就会被自动写进配置文件全程不用手动复制粘贴。核心实现可以参考 tools/cookie_fetcher.py 和 auth/cookie_manager.py。一份最小配置跑通第一次抖音批量下载新建config.yml把下面这份配置粘贴进去替换链接即可link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx path: ./Downloaded/ mode: - post number: post: 50 thread: 5 retry_times: 3 database: true运行python run.py -c config.yml这份配置里的四个字段决定了你的下载体验mode: post表示下载作者发布的作品number.post: 50是数量上限改成0就是全量下载thread: 5控制并发database: true开启去重与历史记录。到这一步你已经完成了第一个真实的抖音视频批量下载任务。一个工具认得出八种抖音链接跑通第一次后你会发现link里能放的远不止用户主页。工具内置的链接解析模块会识别常见抖音地址类型核心逻辑在 core/url_parser.py链接类型示例配合的 mode单个短视频/video/7604129988555574538默认单个图文/note/7341234567890123456默认单个合集/collection/7341234567890123456默认单个音乐原声/music/7341234567890123456默认短链接v.douyin.com/xxxx自动解析作者主页/user/{sec_uid}post/like/mix/music直播间live.douyin.com/{房间号}直播录制我的收藏夹/user/self?showTabfavorite_collectioncollect/collectmix这里有一个容易忽略的细节同一个作品在不同模式下出现不会重复下载。比如某个视频既在作者主页、又在作者点赞列表里跨模式自动去重会帮你只存一份。接下来我们用四个真实场景把这套能力串起来用。场景一竞品追更只下新作品不重复需求背景做自媒体运营每天要盯 30 个竞品账号的新内容做拆解。以前的做法是挨个打开主页、判断哪个是新发的、再逐条下载一个上午就没了。配置做法把多个账号写进link同时开启增量下载让工具只补新作品link: - https://www.douyin.com/user/竞品账号A - https://www.douyin.com/user/竞品账号B mode: - post number: post: 0 # 0 不限制数量 increase: post: true # 只下载数据库里没有的新作品 folderstyle: true filename_template: {date}_{title}_{id}效果对比原来人工轮巡 30 个账号要40 分钟现在每天一条python run.py -c config.yml配合系统定时任务Linux 用 crontab、Windows 用任务计划程序在凌晨自动跑6 分钟跑完且只下载新增内容。加上filename_template按日期_标题_ID命名素材归档完全不需要二次整理。批量运行时你会看到这样的进度画面——每个文件逐条推进失败的自动重试已存在的自动跳过场景二建素材库按关键词与热搜批量抓取需求背景培训机构要建一个包含上千条优质案例的素材库按学科归类研究员则需要按话题采集样本。这类需求不关心谁发的只关心内容是什么。配置做法工具提供了两个命令行参数直接按内容抓取# 搜索猫咪相关作品最多 100 条结果落 JSONL python run.py --search 猫咪 --search-max 100 -p ./Downloaded/ # 拉取抖音热搜榜前 30 条 python run.py --hot-board 30 -p ./Downloaded/再配合评论采集和时间过滤把只下载视频升级成采集结构化数据start_time: 2024-01-01 end_time: 2024-12-31 comments: enabled: true include_replies: false max_comments: 500效果对比原来人工逐条搜索、记录互动数据300 条样本要抓一周现在按关键词 热搜批量跑半天拿到上千条每条作品旁边还会生成*_comments.json评论数据和完整元数据 JSON方便做多维分析。场景三直播录制不再错过任何一场重要直播需求背景运营需要录制竞品直播复盘话术老师要录下自己的直播课留档。手机录屏会占住手机、画质不稳定、容易中途断掉。配置做法直接在link里放直播间地址加上录制参数link: - https://live.douyin.com/123456789 live: max_duration_seconds: 3600 # 0 录到主播下播 chunk_size: 65536 idle_timeout_seconds: 30运行后工具会先拉取直播信息并让你选择清晰度再解析出推流地址开始录制效果对比录制的 FLV 文件会保存在Downloaded/{作者}/live/目录下并附带*_room.json直播间元数据快照。最实用的是断点保护——主播下播、网络空闲或你按 CtrlC 中断时已录制的字节会被完整保留不会前功尽弃。录制 2 小时直播人工录屏可能要占 10GB 手机空间这个方案直接落到硬盘画质更高。场景四备份收藏与点赞让数据真正属于你需求背景刷了 300 条收藏某天作品被作者删除或设为私密就再也找不回来了。手机相册空间也撑不住高清视频。配置做法使用当前登录账号的收藏夹链接批量同步到本地link: - https://www.douyin.com/user/self?showTabfavorite_collection mode: - collect number: collect: 0想看点赞过的作品把mode换成like配合number.like: 0全量拉取即可。注意一个细节collect模式只支持当前登录的账号而且必须单独使用不能和post/like混在一个配置里。效果对比原来收藏了 300 条、能随时打开看的可能不到一半现在一次性全量归档到硬盘每条作品连同封面、音乐、作者头像、JSON 元数据一起保存数据真正掌握在自己手里。下载完成的文件长什么样所有下载内容默认按作者 → 模式 → 日期_标题_ID三层结构组织Downloaded/ └── 作者名/ └── post/ └── 2024-02-07_作品标题_aweme_id/ ├── 视频.mp4 ├── 封面_cover.jpg ├── 音乐_music.mp3 ├── 元数据_data.json └── 头像_avatar.jpg在文件管理器里看就是按日期和标题自动分类好的文件夹一目了然每一条作品都是全家桶视频、封面、原声、作者头像、结构化元数据一应俱全。这正是它和普通在线解析站最大的区别——在线站给你一个 MP4 就结束了而这里拿到的是一个可直接进入素材库的完整条目。三个容易错过的高级能力基础玩法跑通后还有三个用到就是赚到的隐藏能力1. 视频转写transcript下载视频后自动调用转写接口生成文字稿图文不生效。只需在配置里打开开关并配置 API Key就会产出xxx.transcript.txt和xxx.transcript.json。做内容拆解、课程整理时等于白送一份逐字稿。2. REST API 服务模式python run.py --serve --serve-port 8000会把整个工具变成一个本地服务提供/api/v1/download、/api/v1/jobs/{job_id}等接口方便集成到自己的系统里。核心实现参考 server/app.py 和 server/jobs.py。3. 完成通知推送支持 Bark、Telegram、Webhook 三种渠道下载完成或失败时推送消息。批量任务挂着跑的时候手机上就能收到结果不用一直盯着终端。能力一句话价值在哪开启视频转写下载即出逐字稿transcript.*REST API嵌入你自己的系统--serve参数完成通知任务跑完自动喊你notifications.*浏览器兜底翻页风控时人工过验证browser_fallback.*不想敲命令桌面版 Douzy 用两张截图看懂如果你完全不想碰命令行项目还提供了一个基于同一套后端打造的桌面客户端Douzy目前内测中。粘贴链接点击检测链接工具会自动识别出这是博主主页还是合集然后选择要下载的内容类型下载任务完成后在任务中心里能看到每一条任务的发布者、类型、数量和状态失败的任务一目了然怎么选一句话要自动化、要定时、要嵌入脚本用命令行版只想粘贴-下载-查看用桌面版。两者共用同一套下载引擎和数据管理逻辑迁移成本几乎为零。藏在源码里的三重稳定保障把稳定性设计放在最后讲是因为它属于加分项而非上手必需。但它确实决定了批量下载能不能跑得长久双策略下载默认走 API 高速下载遇到接口异常自动降级为浏览器模拟模式保证任务不中断。这就是为什么它能保持较高下载成功率。失败重试 完整性校验指数退避重试1 秒、2 秒、5 秒递进下载后用 Content-Length 比对文件完整性不完整的自动清理并重试。节奏自律默认速率限制约 2 请求/秒、并发 5配合 SQLite 数据库去重既不会浪费资源也不会对平台造成压力。核心代码可参考 core/、control/、storage/database.py。避坑清单五个高频问题的处理办法1. 只能抓到 20 条作品这是翻页风控的常见现象。确保browser_fallback.enabled: true、headless: false浏览器弹窗出现后手动完成验证不要急着关窗口。2. Cookie 失效了重新跑一次python -m tools.cookie_fetcher --config config.yml工具会自动刷新并写回配置。3. 想看详细日志加参数运行python run.py -c config.yml -v显示 info 级别或--show-warnings。4. 想重新下载某个作品去重机制靠数据库记录 本地文件双重判断只删文件或只删数据库记录都不彻底。最省事的办法是删除对应作品的文件和数据库中的记录参考项目 README 中的清理命令或者直接换一个path目录。5. 下载慢先把thread从 5 调到 8 试一轮如果网络受限在配置里加proxy: http://127.0.0.1:7890。合规提醒边界在哪里技术是无罪的用法的边界要自己把握。douyin-downloader 设计用于个人学习、研究分析、备份自己可访问的内容等场景。请遵守以下原则不用于商业性内容分发或侵权二次传播不用于大规模爬取干扰平台服务不用于获取他人隐私信息尊重内容创作者的权益注明来源遵守平台的使用协议与相关法律法规项目在 README 中同样声明了免责条款使用者需自行承担相应风险与责任。行动清单今天就能做完的 5 件事装环境克隆仓库、安装依赖顺手装好 Playwright3 分钟取 Cookie运行python -m tools.cookie_fetcher登录一次2 分钟跑通首单用最小配置下载一个你喜欢的博主的 5 条作品确认文件全家桶完整5 分钟落地一个场景从上面的四个场景里挑一个最贴近你工作的套用配置跑一轮开启增量在配置里打开increase配合系统定时任务让素材库从此自动更新从一个通宵手动下载到一杯咖啡时间批量完成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），仅供参考 抖音视频批量下载终极实测：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手动存一条 30 秒的抖音视频复制链接、去水印、改文件名最快也要 1 分钟把 274 条作品这样逐条存下来基本等于搭上一个通宵。开源工具 douyin-downloader 专治抖音批量下载这个痛点去水印、支持视频/图集/合集/音乐/直播录制还自带去重、重试和进度条。读完本文你可以在 5 分钟内跑通第一条批量下载命令并拿到 4 个真实工作场景下可直接复制的配置。本文是一份面向普通用户的 douyin-downloader 实战教程不堆功能列表而是带着你从装环境、配 Cookie、写最小配置开始把下载这件事真正用起来。无论你是自媒体运营、学术研究者还是只想备份自己收藏的普通用户都适用。先看真实运行画面一次下载到底发生了什么第一次跑通命令后你会看到这样一个命令行界面画面分三个区域上方是下载配置总数、线程数、保存路径中间是批量下载进度每个文件的状态这里清晰写着跳过已存在下方是结果统计成功数量与用时。注意那个跳过已存在——它靠 SQLite 数据库记录 本地文件双重比对同一个作品下载过一次就自动跳过这正是后面所有增量玩法的地基。三分钟完成环境配置与 Cookie 获取动手之前先把环境准备好这一步只要三条命令。git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt如果你打算用浏览器兜底功能翻页被风控时自动开浏览器帮你过验证码或者想自动获取 Cookie再多装一个 Playwrightpip install playwright python -m playwright install chromium接下来是很多新手最容易卡住的一步——Cookie。工具已经帮你封装好了python -m tools.cookie_fetcher --config config.yml这个命令会自动打开浏览器你登录抖音后回到终端按一下回车Cookie 就会被自动写进配置文件全程不用手动复制粘贴。核心实现可以参考 tools/cookie_fetcher.py 和 auth/cookie_manager.py。一份最小配置跑通第一次抖音批量下载新建config.yml把下面这份配置粘贴进去替换链接即可link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx path: ./Downloaded/ mode: - post number: post: 50 thread: 5 retry_times: 3 database: true运行python run.py -c config.yml这份配置里的四个字段决定了你的下载体验mode: post表示下载作者发布的作品number.post: 50是数量上限改成0就是全量下载thread: 5控制并发database: true开启去重与历史记录。到这一步你已经完成了第一个真实的抖音视频批量下载任务。一个工具认得出八种抖音链接跑通第一次后你会发现link里能放的远不止用户主页。工具内置的链接解析模块会识别常见抖音地址类型核心逻辑在 core/url_parser.py链接类型示例配合的 mode单个短视频/video/7604129988555574538默认单个图文/note/7341234567890123456默认单个合集/collection/7341234567890123456默认单个音乐原声/music/7341234567890123456默认短链接v.douyin.com/xxxx自动解析作者主页/user/{sec_uid}post/like/mix/music直播间live.douyin.com/{房间号}直播录制我的收藏夹/user/self?showTabfavorite_collectioncollect/collectmix这里有一个容易忽略的细节同一个作品在不同模式下出现不会重复下载。比如某个视频既在作者主页、又在作者点赞列表里跨模式自动去重会帮你只存一份。接下来我们用四个真实场景把这套能力串起来用。场景一竞品追更只下新作品不重复需求背景做自媒体运营每天要盯 30 个竞品账号的新内容做拆解。以前的做法是挨个打开主页、判断哪个是新发的、再逐条下载一个上午就没了。配置做法把多个账号写进link同时开启增量下载让工具只补新作品link: - https://www.douyin.com/user/竞品账号A - https://www.douyin.com/user/竞品账号B mode: - post number: post: 0 # 0 不限制数量 increase: post: true # 只下载数据库里没有的新作品 folderstyle: true filename_template: {date}_{title}_{id}效果对比原来人工轮巡 30 个账号要40 分钟现在每天一条python run.py -c config.yml配合系统定时任务Linux 用 crontab、Windows 用任务计划程序在凌晨自动跑6 分钟跑完且只下载新增内容。加上filename_template按日期_标题_ID命名素材归档完全不需要二次整理。批量运行时你会看到这样的进度画面——每个文件逐条推进失败的自动重试已存在的自动跳过场景二建素材库按关键词与热搜批量抓取需求背景培训机构要建一个包含上千条优质案例的素材库按学科归类研究员则需要按话题采集样本。这类需求不关心谁发的只关心内容是什么。配置做法工具提供了两个命令行参数直接按内容抓取# 搜索猫咪相关作品最多 100 条结果落 JSONL python run.py --search 猫咪 --search-max 100 -p ./Downloaded/ # 拉取抖音热搜榜前 30 条 python run.py --hot-board 30 -p ./Downloaded/再配合评论采集和时间过滤把只下载视频升级成采集结构化数据start_time: 2024-01-01 end_time: 2024-12-31 comments: enabled: true include_replies: false max_comments: 500效果对比原来人工逐条搜索、记录互动数据300 条样本要抓一周现在按关键词 热搜批量跑半天拿到上千条每条作品旁边还会生成*_comments.json评论数据和完整元数据 JSON方便做多维分析。场景三直播录制不再错过任何一场重要直播需求背景运营需要录制竞品直播复盘话术老师要录下自己的直播课留档。手机录屏会占住手机、画质不稳定、容易中途断掉。配置做法直接在link里放直播间地址加上录制参数link: - https://live.douyin.com/123456789 live: max_duration_seconds: 3600 # 0 录到主播下播 chunk_size: 65536 idle_timeout_seconds: 30运行后工具会先拉取直播信息并让你选择清晰度再解析出推流地址开始录制效果对比录制的 FLV 文件会保存在Downloaded/{作者}/live/目录下并附带*_room.json直播间元数据快照。最实用的是断点保护——主播下播、网络空闲或你按 CtrlC 中断时已录制的字节会被完整保留不会前功尽弃。录制 2 小时直播人工录屏可能要占 10GB 手机空间这个方案直接落到硬盘画质更高。场景四备份收藏与点赞让数据真正属于你需求背景刷了 300 条收藏某天作品被作者删除或设为私密就再也找不回来了。手机相册空间也撑不住高清视频。配置做法使用当前登录账号的收藏夹链接批量同步到本地link: - https://www.douyin.com/user/self?showTabfavorite_collection mode: - collect number: collect: 0想看点赞过的作品把mode换成like配合number.like: 0全量拉取即可。注意一个细节collect模式只支持当前登录的账号而且必须单独使用不能和post/like混在一个配置里。效果对比原来收藏了 300 条、能随时打开看的可能不到一半现在一次性全量归档到硬盘每条作品连同封面、音乐、作者头像、JSON 元数据一起保存数据真正掌握在自己手里。下载完成的文件长什么样所有下载内容默认按作者 → 模式 → 日期_标题_ID三层结构组织Downloaded/ └── 作者名/ └── post/ └── 2024-02-07_作品标题_aweme_id/ ├── 视频.mp4 ├── 封面_cover.jpg ├── 音乐_music.mp3 ├── 元数据_data.json └── 头像_avatar.jpg在文件管理器里看就是按日期和标题自动分类好的文件夹一目了然每一条作品都是全家桶视频、封面、原声、作者头像、结构化元数据一应俱全。这正是它和普通在线解析站最大的区别——在线站给你一个 MP4 就结束了而这里拿到的是一个可直接进入素材库的完整条目。三个容易错过的高级能力基础玩法跑通后还有三个用到就是赚到的隐藏能力1. 视频转写transcript下载视频后自动调用转写接口生成文字稿图文不生效。只需在配置里打开开关并配置 API Key就会产出xxx.transcript.txt和xxx.transcript.json。做内容拆解、课程整理时等于白送一份逐字稿。2. REST API 服务模式python run.py --serve --serve-port 8000会把整个工具变成一个本地服务提供/api/v1/download、/api/v1/jobs/{job_id}等接口方便集成到自己的系统里。核心实现参考 server/app.py 和 server/jobs.py。3. 完成通知推送支持 Bark、Telegram、Webhook 三种渠道下载完成或失败时推送消息。批量任务挂着跑的时候手机上就能收到结果不用一直盯着终端。能力一句话价值在哪开启视频转写下载即出逐字稿transcript.*REST API嵌入你自己的系统--serve参数完成通知任务跑完自动喊你notifications.*浏览器兜底翻页风控时人工过验证browser_fallback.*不想敲命令桌面版 Douzy 用两张截图看懂如果你完全不想碰命令行项目还提供了一个基于同一套后端打造的桌面客户端Douzy目前内测中。粘贴链接点击检测链接工具会自动识别出这是博主主页还是合集然后选择要下载的内容类型下载任务完成后在任务中心里能看到每一条任务的发布者、类型、数量和状态失败的任务一目了然怎么选一句话要自动化、要定时、要嵌入脚本用命令行版只想粘贴-下载-查看用桌面版。两者共用同一套下载引擎和数据管理逻辑迁移成本几乎为零。藏在源码里的三重稳定保障把稳定性设计放在最后讲是因为它属于加分项而非上手必需。但它确实决定了批量下载能不能跑得长久双策略下载默认走 API 高速下载遇到接口异常自动降级为浏览器模拟模式保证任务不中断。这就是为什么它能保持较高下载成功率。失败重试 完整性校验指数退避重试1 秒、2 秒、5 秒递进下载后用 Content-Length 比对文件完整性不完整的自动清理并重试。节奏自律默认速率限制约 2 请求/秒、并发 5配合 SQLite 数据库去重既不会浪费资源也不会对平台造成压力。核心代码可参考 core/、control/、storage/database.py。避坑清单五个高频问题的处理办法1. 只能抓到 20 条作品这是翻页风控的常见现象。确保browser_fallback.enabled: true、headless: false浏览器弹窗出现后手动完成验证不要急着关窗口。2. Cookie 失效了重新跑一次python -m tools.cookie_fetcher --config config.yml工具会自动刷新并写回配置。3. 想看详细日志加参数运行python run.py -c config.yml -v显示 info 级别或--show-warnings。4. 想重新下载某个作品去重机制靠数据库记录 本地文件双重判断只删文件或只删数据库记录都不彻底。最省事的办法是删除对应作品的文件和数据库中的记录参考项目 README 中的清理命令或者直接换一个path目录。5. 下载慢先把thread从 5 调到 8 试一轮如果网络受限在配置里加proxy: http://127.0.0.1:7890。合规提醒边界在哪里技术是无罪的用法的边界要自己把握。douyin-downloader 设计用于个人学习、研究分析、备份自己可访问的内容等场景。请遵守以下原则不用于商业性内容分发或侵权二次传播不用于大规模爬取干扰平台服务不用于获取他人隐私信息尊重内容创作者的权益注明来源遵守平台的使用协议与相关法律法规项目在 README 中同样声明了免责条款使用者需自行承担相应风险与责任。行动清单今天就能做完的 5 件事装环境克隆仓库、安装依赖顺手装好 Playwright3 分钟取 Cookie运行python -m tools.cookie_fetcher登录一次2 分钟跑通首单用最小配置下载一个你喜欢的博主的 5 条作品确认文件全家桶完整5 分钟落地一个场景从上面的四个场景里挑一个最贴近你工作的套用配置跑一轮开启增量在配置里打开increase配合系统定时任务让素材库从此自动更新从一个通宵手动下载到一杯咖啡时间批量完成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），仅供参考