抖音批量下载实用手册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 是一款开源的抖音批量下载工具主打无水印下载、双重去重与完整素材归档适合需要长期收集视频素材的个人创作者、运营和研究团队。这篇文章按从零到一的实操路线展开怎么装、怎么配、怎么用以及最常见的几个坑怎么绕过去读完就能跑通自己的第一条下载任务。一个内容运营的早晨收素材不该花掉半天先还原一个很常见的画面。早上十点运营小林坐到工位今天要收集一批竞品账号的新视频用于选题分析。她打开抖音网页版一个一个点进主页翻到作品列表逐个复制链接再用在线解析站挨个转出无水印地址最后手动改名、手动归类。二十条视频下来一个多小时没了中途还有几条提示解析失败请刷新重试。这不是个例。手动收集素材的麻烦本质上来自三件事链路长找链接、解析、下载、命名是四段割裂的操作每段都要人工介入重复多同一个视频今天下载明天又下载硬盘里堆满重复文件却不知道信息薄只存下来一个 MP4发布时间、点赞数、作者信息全丢了后期做分析无据可查。douyin-downloader 把上面这四段操作合并成一次配置、一条命令同时顺手解决了重复与信息丢失的问题。下面的内容就围绕它到底怎么做到来展开。工具摸底一条命令背后藏着哪些能力在动手之前先对它的能力有个整体认知。下表是主要功能的一张全景图后面每一节都会对应展开。能力维度具体内容链接识别单视频、图文、合集、音乐、直播以及短链自动解析批量模式作者主页作品/点赞/合集/原声收藏夹与收藏合集下载质量优先无水印源自动挑选最高码率防重复SQLite 数据库去重 本地文件名去重跨模式自动去重资产保存视频、封面、音乐、头像、JSON 元数据、可选评论稳定性失败重试、速率限制、下载完整性校验、浏览器兜底扩展功能直播录制、视频转写、热搜榜、关键词搜索、通知推送、REST API运行形态命令行、YAML 配置、桌面版内测、Docker三十分钟从零跑通第一次下载这一节按实际动手顺序来跟着做即可。第一步装好运行环境项目要求 Python 3.8 及以上Windows、macOS、Linux 都支持。克隆仓库后安装依赖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第二步准备配置与登录凭证把仓库里的示例配置复制成自己的配置cp config.example.yml config.yml抖音接口需要 Cookie 才能正常访问。推荐用自动方式获取——它会自动打开浏览器登录后回到终端按一下回车Cookie 就被写进配置了python -m tools.cookie_fetcher --config config.yml如果自动获取不顺利也可以手动登录抖音网页版从浏览器开发者工具里复制整串 Cookie粘贴到配置文件的对应位置两种方式都支持。第三步一条命令启动批量下载一份最小可用的配置长这样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终端里会出现实时进度条逐个展示当前正在处理的作品和统计结果跑完一次下载大概就是几十秒到几分钟的量级。四种批量模式覆盖九成下载需求很多人的第一反应是我只需要下单个视频。这个工具对单条链接同样友好link字段里放什么地址就按什么类型处理/video/{id}下载单个视频/note/{id}、/gallery/{id}下载单个图文/collection/{id}、/mix/{id}下载整个合集/music/{id}下载音乐原声缺失时回退到该音乐下的首条作品v.douyin.com/...这类短链也能自动解析成真实地址。真正体现批量价值的是作者主页。把链接换成用户主页地址再声明要抓的内容类型即可link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx mode: - post # 作品 - like # 点赞 - mix # 合集 - music # 原声四种模式可以叠加使用同一个作品在不同模式下不会重复下载。当前登录账号自己的收藏夹也有专门入口/user/self?showTabfavorite_collection配合collect、collectmix两种模式可以把收藏的作品和合集整体备份下来。数量用number控制例如post: 50表示只取前 50 条post: 0表示不限制、全量抓取。下载不等于白下载视频之外的数字资产对做内容分析的人来说单纯拿到 MP4 价值有限。douyin-downloader 默认会把一套完整的数字档案落到本地视频文件优先无水印、最高码率源封面图与作者头像原声音乐文件一份 JSON 格式的完整元数据包含发布时间、标题、点赞数等字段可选的作品评论数据以*_comments.json形式保存在媒体文件旁边。评论采集在配置里开启即可comments: enabled: true include_replies: false # 设为 true 会连带抓取每条评论的二级回复 max_comments: 500 # 0 表示不限量 page_size: 20如果你还需要把视频转成文字稿可以打开转写功能它会调用 OpenAI 的转写接口为每个视频生成.txt和.json两种格式的文稿transcript: enabled: true model: gpt-4o-mini-transcribe response_formats: - txt - json api_key_env: OPENAI_API_KEY下载目录的观感大致如下——每个作品一个带日期和标题的文件夹视频、封面、JSON 各归其位日后检索和归档都省事。三个高频坑位与自救指南用这类工具八成问题集中在三个地方。逐一说明原因和对应处理办法。坑位一Cookie 失效下载全线报错抖音的 Cookie 有时效过期后接口会拒绝访问。工具本身会做失效检测一旦发现异常重新跑一遍自动获取流程即可python -m tools.cookie_fetcher --config config.yml日常使用建议把 Cookie 获取作为一个定期动作而不是一次性动作尤其是隔几天才用一次的情况。坑位二翻页被风控只拿到前 20 条这是抖音分页接口的常见限制。工具内置了浏览器兜底策略当 API 翻页受限时会自动拉起浏览器模拟滚动把剩下的作品数据补全。配置里确认这两项开启且不要用无头模式browser_fallback: enabled: true headless: false浏览器弹窗出现后如果遇到验证码手动过一下再继续不要立刻关掉窗口。坑位三下载到一半失败文件不完整网络波动、平台限速、作品被删除都可能导致单个任务中断。工具做了三层防护失败自动重试按 1 秒、2 秒、5 秒退避、下载后比对文件大小、不完整的文件自动清理并重下。整体上单条失败不会拖垮整个任务队列日志里能看到具体是哪一步出的问题必要时用-v参数跑一遍拿详细输出python run.py -c config.yml -v提速与调优让并发、重试、增量各司其职跑通一次之后可以按自己的网络条件逐步调优。以下配置项是最常用的几个旋钮# 并发与重试 thread: 8 # 并发下载数带宽充足可调高一般 5-10 为宜 retry_times: 5 # 失败重试次数 proxy: http://127.0.0.1:7890 # 有代理需求时配置 # 只下载新内容增量模式依赖数据库记录 increase: post: true like: true # 按发布时间过滤 start_time: 2026-01-01 end_time: 2026-08-01两个容易被忽略的细节命名模板可以完全自定义变量包括日期、作者、标题、作品 ID、点赞数、评论数等例如{date}_{author}_{title}_{id}作者目录默认用昵称_sec_uid形式既好认又不会撞名。通知推送如果下载任务是夜间批量跑的可以在完成后通过 Bark、Telegram 或 Webhook 收到消息不用一直盯着终端。四类用户的上手配置速查表不同用途的人最优配置组合不太一样。这里按场景整理了一份速查表可以直接对着抄用户类型核心配置说明内容创作者多主页链接 post/like模式 increase每天增量同步竞品新作品研究/数据采集--search 关键词或--hot-board Ncomments.enabled关键词搜索、热搜榜导出 JSONL配合评论数据做样本分析培训资料库多主页 post/mix 时间过滤 转写按学科归档合集转文字稿方便检索直播记录直播间链接 live配置定时录制下播自动保留已录内容直播录制的配置示例如下。主播下播、网络空闲或手动中断时已经录到的字节都会被保留link: - https://live.douyin.com/123456789 live: max_duration_seconds: 3600 # 0 表示录到主播下播 chunk_size: 65536 idle_timeout_seconds: 30关键词搜索和热搜榜是研究场景的常用入口结果以 JSONL 文件落地方便后续导入分析工具python run.py --search 猫咪 --search-max 100 -p ./研究数据/ python run.py --hot-board 30 -p ./研究数据/从命令行到桌面版再到对外开放的 API命令行足够灵活但对不熟悉终端的人仍有一定门槛。项目基于同一套后端开发了桌面客户端 Douzy内测中把常用的操作做成了可视化界面粘贴链接即可检测并选择下载内容任务中心能逐条查看状态作品档案支持按作者和关键词筛选历史记录。如果想把下载能力接进自己的系统还可以用 REST API 服务模式运行提供任务提交、状态查询、健康探针等接口方便集成到现有工作流里pip install fastapi uvicorn python run.py --serve --serve-port 8000最后工具是手段规则是底线整篇文章走下来其实可以总结成一句话把找链接、解析、下载、命名、归档这条手工链路交给一个会去重、会重试、会归档的工具去自动完成。安装、配置、跑通第一次下载总共不超过半小时之后每天只是把链接丢进去、等结果、收通知。需要提醒的是抖音平台对内容下载和抓取有自己的规则请仅在合法合规的前提下使用尊重原创作者的权益下载的内容用于个人学习或正当用途不要用于批量搬运、二次分发等违规场景。工具的频率控制、速率限制等设计本身就是对平台规则的尊重使用者更应保持克制。技术只是提高效率的杠杆用在哪里、用到什么程度始终取决于使用者自己。【免费下载链接】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），仅供参考