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这篇指南带你把 douyin-downloader 这套抖音去水印批量下载工具在自己电脑上跑起来一条链接试水一个主页链接整页搬运作品、图集、合集、音乐原声都能无水印落盘重复下载会自动跳过。先说结果一次主页批量下载长什么样先看成果。下面这张图是任务跑完后的记录面板一个主页任务 24 件作品全部完成一个合集任务 18 件完成还有一条失败记录——两个作品已不可用工具把失败原因也如实标了出来。谁成了、谁挂了、耗时多久扫一眼就有数。这就是后面所有操作要达到的效果你只管贴链接剩下的选源、去水印、命名、归档、去重它自己完成。它是什么一句话定位douyin-downloader 是一个 Python 写的命令行工具专门解决想整页存下某个抖音账号的作品却只能一条一条手动保存的问题。适合做素材收集、竞品分析、个人备份的人前提是你看得懂终端命令不需要读源码。它的边界也很明确以接口抓取为主、浏览器兜底为辅直播录制是实验性功能收藏夹类模式只认你 Cookie 对应的那个登录账号。另外项目里还套了一个桌面 GUI 版 Douzy闭测中和 CLI 共用同一套后端——贴链接、看任务、管档案它把命令行那套流程做成了界面能力全景一张表看清它能接什么活你手上的链接 / 需求工具怎么接备注单个视频www.douyin.com/video/...直接下载默认挑无水印源最常用图文作品/note/或/gallery/整组图片下载图文按图集处理合集/collection/、/mix/按合集批量下载音乐/music/优先直取音频取不到就下第一关联视频分享短链v.douyin.com/...自动还原成真实地址再下手机上复制的短链可直接用作者主页/user/...按 mode 抓post/like/mix/music批量核心能力自己的收藏夹collect/collectmix模式需登录 Cookie且只能单独用直播间live.douyin.com/...自动录制下播保留已录部分实验性评论、热搜榜、关键词搜索输出 JSON / JSONL 文件做文本分析用下载时还顺手带一份元数据可选封面、音乐、头像、JSON 文件按作者 / 模式 / 日期_标题_ID自动分层归档进度条、失败重试、断点保留都有。环境准备三条命令装好要求不高Python 3.8 以上macOS / Linux / Windows 都行。git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt如果你后面要用浏览器兜底或自动抓 Cookie强烈建议装后面会用到再补一个浏览器内核pip install playwright python -m playwright install chromium怎么算装好了跑python run.py --version能正常打印版本号就说明环境没问题。Cookie 配置最常见的失败原因就是它过期了先说结论后面 80% 的突然下不动了都是 Cookie 过期重跑一次自动获取就能解决先记住这个。为什么需要 Cookie抖音网页要识别你是谁才肯把数据给你这串身份凭证就存在浏览器的 Cookie 里。工具给你两条路自动获取推荐。终端里跑python -m tools.cookie_fetcher --config config.yml它会弹出一个浏览器窗口你正常扫码登录抖音回到终端按回车Cookie 就被写进 config.yml 了。底层逻辑可以看 tools/cookie_fetcher.py。手动粘贴。自动方式不顺手时登录抖音网页版打开浏览器开发者工具把 Cookie 整段复制填进配置文件的cookies字段。提醒collect/collectmix这种抓自己收藏夹的模式必须走登录 Cookie抓公开视频和主页作品时Cookie 主要是降低被限流的概率。主流程走通从一条链接到搬空一个主页这一节只有一条主线改配置文件 → 运行 → 看结果。先拿单条试水跑通之后把链接换成主页其余命令完全不变。第 1 步复制示例配置。cp config.example.yml config.ymlconfig.example.yml 里每个字段都有中文注释照着改即可。第 2 步单条视频试跑。打开 config.yml把最顶上的link换成任意一个视频链接其他保持默认link: - https://www.douyin.com/video/7604129988555574538 path: ./Downloaded/运行python run.py -c config.yml你会看到初始化、解析链接、下载几段进度条走完最后输出一张统计成功几条、耗时多久、存在哪。文件落在Downloaded/作者名/post/日期_标题_ID/里视频本体之外按你的开关还会存封面、音乐、JSON 元数据。懒人也可以不动配置文件直接用命令行参数临时指定python run.py -c config.yml -u https://www.douyin.com/video/7604129988555574538 -t 8 -p ./Downloaded-u追加链接、-t并发数、-p保存目录。第 3 步同一条命令换链接就是批量。单条跑通后把link换成作者主页地址加上mode和numberlink: - https://www.douyin.com/user/MS4wLjABAAAAxxxx path: ./Downloaded/ mode: - post # 作者发布的全部作品 number: post: 0 # 0 全量写 50 就只下前 50 条再跑一次python run.py -c config.yml这个主页的作品就开始整页往本地搬。mode可以同时写post/like/mix/music几行一次抓取把多类内容都带回来同一个作品跨模式也不会重复下载。桌面版把同样的主页作品列表 直接下载做成了可视界面CLI 用户不需要它但能帮你理解批量任务长什么样第 4 步验收归档结构。打开Downloaded/目录默认长这样Downloaded/ └── 作者名/ └── post/ └── 2024-02-07_视频标题_视频ID/ ├── 视频.mp4 └── 可选封面 / 音乐 / JSON按作者、模式、日期标题分层之后找素材不用翻文件属性。进阶场景四种直接能用的玩法直播录制场景。遇到不想错过的直播场次把直播间链接填进link配好时长上限link: - https://live.douyin.com/123456789 live: max_duration_seconds: 3600 # 0 一直录到主播下播 idle_timeout_seconds: 30 # 流空闲多久判定结束主播下播、网络断了甚至你手动 CtrlC已经录到的部分都会保留成正式 FLV 文件不会白录。注意这是实验性功能HLS 源目前只存播放列表需要可播文件要自己过一遍 ffmpeg。热搜榜与关键词搜索场景。做选题调研时两条命令把数据落成 JSONL省掉手工翻页python run.py --hot-board 20 -p ./Downloaded python run.py --search 猫咪 --search-max 100 -p ./Downloaded收藏夹场景。想把自己账号收藏的视频整批存下来link: - https://www.douyin.com/user/self?showTabfavorite_collection mode: - collect # 收藏夹里的视频collectmix 是收藏夹里的合集 number: collect: 0注意collect/collectmix必须单独使用不能和post等模式混写且只认你 Cookie 对应的账号。桌面版对应的我的收藏与合集界面长这样评论采集场景。做用户研究时给每个作品附带一份评论 JSON方便后续做文本分析comments: enabled: true include_replies: false # true 会连二级回复一起抓请求量更大 max_comments: 500 # 0 不限产物是媒体文件旁边的*_comments.json。另外提一句时间过滤start_time/end_time格式YYYY-MM-DD可以只抓某个时间段内的作品适合只要今年发的这类需求。调优参数为什么长期用要这么调用一周之后真正影响体验的就是这几个字段。thread并发数默认 5。它决定同时下载几个任务。为什么建议家用网络别往上调并发一高请求密集平台侧限流的概率就变大反而越调越慢。5 左右是速度和稳定之间的平衡点发现失败变多就往下减。number.post等分模式数量0 不限。为什么建议先写个小数字第一次抓一个几百条的大号之前先post: 10跑一遍确认 Cookie 有效、归档正常再改成 0 全量。翻车成本从下几百条降为下十条。increase.post等增量开关默认 true。判定标准是磁盘上主媒体文件已存在就跳过而不是数据库。为什么重要它让你可以每周跑一遍同一个主页配置只补新发的内容做定期同步。反过来把某模式设为 false 表示强制重下并覆盖配合start_time能只重刷某个时间段。video_quality默认 highest。抖音每条视频返回多档码率。highest只在转码档里挑最高档不额外请求original会多花一次探测请求去找上传原片——原片可能比最高转码档大好几倍适合要精剪的场景纯归档选默认即可省时省流量。browser_fallback.headless: false务必保持。正常翻页走接口一旦触发风控工具会自动切浏览器模式继续抓。为什么不能改成无头模式翻页受限后往往要弹验证码只有有界面的窗口才能人工处理无头模式下这一步会卡死。问题速查高频坑先备好答案Q主页抓取只拿到 20 条左右就停了典型的分页风控。确认browser_fallback.enabled: true且headless: false然后在弹出的浏览器窗口里手动完成验证别急着关。这是最常见的抓不全原因。Q某天突然大面积报错第一反应Cookie 过期了重跑python -m tools.cookie_fetcher --config config.yml。第二反应那条内容本身被删除或设了私密——这类谁都下不了跳过即可。Q某个视频想重新下载它是数据库记录 本地文件双重校验去重的两边都得动删掉本地对应目录再用 sqlite3 打开dy_downloader.db从aweme表里按aweme_id删掉那条记录下次运行就会重新抓。只删数据库留文件不会触发重下只删文件留数据库反而会触发重下。Q下载慢大概率是并发开太高被限流了把thread调低试试再检查网络本身有条件就配上proxy字段。Q进度输出太吵配置里progress.quiet_logs: true默认会压掉进度阶段的日志调试时临时加--show-warnings或-v看完整日志。落地路径今天就能做完的四件事把环境跑通clone 仓库、装依赖python run.py --version能打印版本号即过关。把凭证配上跑一次python -m tools.cookie_fetcher --config config.yml扫码、回车配置文件里出现 Cookie 即成功。用单条视频试水cp config.example.yml config.ymllink换成一个视频 URLpython run.py -c config.yml等统计面板出结果。升格到批量同一个配置文件里把link换成关注的主页、mode: post、number.post: 0再跑一次——你的第一个整页素材库就有了。写在最后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），仅供参考
