抖音批量下载与直播回放保存保姆级指南：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上个月我在抖音追一场产品分析直播主讲人讲得正入神我才猛地想起直播一结束这些内容就没有回看入口了。手忙脚乱找录屏软件等配置好干货已经错过一大半。后来经人推荐用了 douyin-downloader 这款免费开源的抖音下载工具才把想存的存不下来、想批量抓的只能一个个点这两件麻烦事一并解决。它支持视频、图集、合集、音乐原声的批量下载也能把直播回放完整留档。这篇指南不堆功能清单按你遇到什么情况、该用哪个入口来讲尽量让你读完就能上手。一次没存下来的直播回放如果你也经历过直播结束就找不到回放或者收藏夹里躺了几十个想一口气存下来的博主主页那这个工具大概率对你胃口。douyin-downloader 的核心就一句话把抖音的链接丢给它它负责解析、下载、去重、按规则归档。你不需要懂接口、不需要管签名参数唯一要做的就是把链接粘贴进去或者写进一份配置文件。它把复制链接到文件落盘这件事做到了什么程度值得先说清楚单条视频和图文能下创作者主页能整站批量抓发布、点赞、合集、音乐分开管理直播间支持实时录制主播下播自动保留已录片段下载记录进 SQLite 数据库重复内容自动跳过遇到反爬卡住时还能自动切到浏览器兜底继续抓取。对普通用户来说它最直观的价值是省时间——过去要手动逐个保存的内容现在一个任务跑完文件已经按作者分好类躺在对应目录里了。先弄清它替你解决了什么用一句话概括适用人群凡是想把抖音内容存成自己的文件的人。比如喜欢囤知识类视频的学生和职场人靠收集素材做剪辑的创作者想给关注的博主做长期内容归档的重度用户甚至只是想留档自己作品的作者本人。它替你省掉三件琐事一是逐条手动下载的低效二是命名混乱导致日后找不到文件三是重复下载浪费存储空间。工具本身的定位是命令行优先、配置驱动。大部分行为都由一份 YAML 配置决定默认值已经能直接跑通进阶项按需打开即可。项目根目录的config.example.yml里对每个配置项都有注释说明完整使用细节写在USAGE.md想研究实现原理的可以直接翻core/目录的源码。对新手来说这些都不必急着看先把下面这条最短路径走通。最短上手路径安装、登录、第一次下载先把项目拉下来并装好依赖整个过程只需要三条命令git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt接着从示例配置复制一份自己的配置文件cp config.example.yml config.yml然后是整个流程里唯一需要动手的一步——登录认证。项目提供了一个自动获取 Cookie 的入口运行后会自动打开浏览器python -m tools.cookie_fetcher --config config.yml浏览器弹出后正常登录你的抖音账号登录完成回到终端按一下回车程序会把获取到的 Cookie 自动写进配置不需要手动复制粘贴那一长串字符。如果你更习惯自己处理也可以在配置里直接粘贴整串 Cookie或按msToken、ttwid等键值对逐项填写config.example.yml里给了两种写法的模板。到这一步就可以试第一次下载了先从单条链接开始最稳妥python run.py -c config.yml -u https://www.douyin.com/video/1234567890123456789命令跑完去配置里path指定的目录看一眼视频、封面和元数据 JSON 应该已经躺在里面。到这儿最短路径就走通了后面的内容都属于按需加装。想存什么就选对应的入口接下来的问题是你最想解决的需求是哪一个按目标对号入座比记功能列表省事得多。目标留住直播回放 → 打开录制功能直播是抖音里最过期不候的内容形态官方基本不提供回放。douyin-downloader 的录制功能就是为这个场景准备的只要把直播间链接放进link程序会按下面的配置持续录制同时支持 FLV 和 HLS 两种流格式主播中途下播也会把已经录下的部分完整保留不会前功尽弃。live: max_duration_seconds: 3600 # 0 表示录到主播下播 chunk_size: 65536 idle_timeout_seconds: 30使用方式同样简单python run.py -c config.yml -u https://live.douyin.com/123456789适合人群很明确追知识分享、技术教学、赛事直播又不想蹲守全程的人。挂一个录制任务忙完再看文件就行。目标囤完整位创作者的作品 → 用主页批量下载发现一个宝藏创作者想把他主页内容一次性存下来把主页链接放进配置用mode声明要抓哪些栏目——post是发布作品、like是点赞列表、mix是合集、music是音乐原声number控制每个栏目的数量上限link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx path: ./Downloaded/ mode: - post - like - mix - music number: post: 50 like: 20 increase: post: true like: true程序会自动为每个作者建立独立目录按栏目分开放置Downloaded/ └── 作者昵称_sec_uid/ ├── post/ # 发布作品 ├── like/ # 点赞作品 ├── mix/ # 合集内容 ├── music/ # 音乐原声 └── live/ # 直播回放increase项对应增量下载开启后程序会对照数据库里的历史记录只抓新出现的作品第二次运行基本就是补新而不是重下。对持续关注某位博主、隔段时间就跑一次任务的人来说这个开关值得长期开着。目标摸清作品反馈 → 开启评论采集如果你做内容调研、选题分析或者想了解某个作品在用户中的真实反应可以打开评论采集。它会在每个作品旁边额外生成一份*_comments.json把评论结构化存下来方便后续统计comments: enabled: true include_replies: false max_comments: 0 # 0 表示不限制数量 page_size: 20这份文件里既能看到评论文本也能拿到评论者的基础信息做简单的情绪分析或热词统计都够用。对普通囤内容的用户来说这项可以保持关闭它更适合有明确数据需求的人。目标收集更多数据 → 热搜、搜索与 API除了下载本身工具还附带几个偏数据采集的入口适合有额外需求的用户# 拉取抖音热搜榜并导出 JSONL python run.py --hot-board 30 # 按关键词搜索作品并导出 JSONL python run.py --search 猫咪 --search-max 100 # 以 REST API 服务模式运行 python run.py --serve --serve-port 8000热搜榜和搜索会导出 JSONL 数据文件供后续分析或二次处理REST 模式则把下载能力暴露成 HTTP 接口可以接到自己的脚本或系统里适合想自动化的人。把输出方式调成自己的习惯下载本身跑通之后大部分人接下来想做的就是让它按我的习惯存文件。下面这张表列出最常被调整的几项左侧是默认行为右侧是你可以改成的样子调整项默认你可以改成文件命名{date}_{title}_{id}用{author}、{year}、{type}等变量自由组合需保留{id}防重名作者目录仅昵称nicknamenickname_uid昵称ID直观且防重名推荐重度用户时间范围不过滤设start_time/end_time只下指定日期段重复内容数据库去重开启增量默认关打开各栏目的increase实现增量补新并发与重试线程 5、重试 3 次按机器性能调thread网络差时加大retry_times下载通知关闭接 bark / telegram / webhook完成或失败时推送网络代理不使用填proxy代理环境下必须配置其中通知推送是很多人的隐藏需求批量任务跑起来后不想一直盯着终端配好通知后下载完成或中途失败手机或群里就会收到消息可以干完别的事再回来收文件。卡住了按症状对号入座用得久了难免遇到问题。这里不按问答形式展开而是把高频情况整理成一张症状速查表出问题先对照症状找原因再按右侧处理症状常见原因处理方式作品数停在一个固定值如 20 条就抓不动平台对未登录/半登录状态有翻页限制打开配置里的浏览器兜底开关手动完成一次验证码后继续下载速度明显偏慢并发线程不足或网络时段不佳调高thread错开高峰时段必要时配置proxy提示 Cookie 失效、需要重新登录登录态过期重新运行python -m tools.cookie_fetcher --config config.yml想确认哪些作品下过、哪些还没下需要查询本地数据库用sqlite3 dy_downloader.db SELECT aweme_id, title, author_name FROM aweme ORDER BY download_time DESC LIMIT 20;查看近期记录找不到下载的文件在哪目录层级较深看配置里path指定的根目录每个作者一个独立子目录大部分问题都集中在登录态和平台限制这两类前者重取 Cookie 即可后者交给浏览器兜底去解决不用手动硬刚。命令行与桌面版怎么选很多人第一次接触会觉得命令行有门槛其实工具还提供了一款同源的桌面版 Douzy界面化和可视化程度高不少。两种方式各适合一类人直接对照下表选择维度命令行版桌面版 Douzy适合人群习惯终端、想写脚本自动化的人不想接触命令行的普通用户上手方式编辑 YAML 配置 运行命令粘贴链接、点选下载内容批量管理配置文件管理多链接支持同步关注列表批量勾选创作者进度查看终端进度条与日志可视化进度、任务中心、事件流历史档案SQLite 查询可视化筛选作者、关键词、日期成熟度功能最全、稳定处于内测期界面持续打磨判断标准很简单如果你日常工作本来就在终端里命令行版一步到位如果你是点鼠标更顺手的那类用户桌面版能把链接检测、关注同步、下载进度这些事都做成图形化操作。两者共用同一套后端数据格式和下载能力是一致的不存在桌面版功能阉割的问题。三条起点对应三种人文章最后按你的情况选一条最短的起步路径第一次接触的新手先复制config.example.yml跑通单条视频下载再试着把链接换成主页地址体验一次批量下载。已经跑通下载的进阶用户把增量下载、命名模板、时间筛选、通知推送逐项打开让工具进入托管式运行状态。有自动化需求的开发者研究core/下的下载流程实现或直接启用--serve的 REST 接口把下载能力接进自己的流程里。最后多说一句题外话工具本身是中立的但使用时要守住边界。下载内容用于个人学习、收藏和备份没有任何问题如果涉及公开传播或商用请先征得创作者同意。尊重版权才能让这些好用的开源工具走得更远。现在把第一条命令敲下去你的抖音内容收藏库就从这一行开始。【免费下载链接】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），仅供参考