抖音批量下载全攻略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 去重。无论你是想备份学习资料还是定期整理关注创作者的全部作品这篇 douyin-downloader 使用教程都能让你在半小时内跑通第一个下载任务。凌晨两点她只花三分钟备份了一周的直播回放小周是一家在线教育公司的内容运营每天的工作之一是把当天的课程直播保存成回放素材。工具倒是现成的——录屏软件、浏览器插件、手动下载各来一套。可一套流程下来一场 40 分钟的直播要折腾将近半小时录屏容易录进弹窗网页缓存下载经常断流文件名还是乱码归档时全靠肉眼辨认。直到同事把 douyin-downloader 丢给她。她把直播间链接粘贴进配置文件运行一条命令去倒杯水回来FLV 文件已经按照作者名 / 直播标题 / 日期的目录结构整齐躺好。更让她意外的是周末她想把一位讲剪辑的老师近半年的作品全部留存原以为要熬个大夜结果同样一条命令几百个视频按发布、点赞、合集、音乐分类自动归位重复内容一个没下。她感叹的不是工具很强大而是原来这种事可以不用人盯。这正是这类抖音下载工具存在的意义把重复劳动交给程序把时间还给人。一句话定位它是什么能解决什么问题简单说douyin-downloader 是一个粘贴链接就能下的抖音资源管理器。你给它一个视频链接、一个用户主页链接或一个直播间链接它负责解析、去水印、挑选最高码率、下载媒体文件、整理目录并把每一次下载记进数据库避免下次重复劳动。核心能力具体表现适合谁单条内容下载视频、图文、合集、音乐链接即贴即下只想保存一两条的普通用户作者主页批量下载post / like / mix / music 四种模式全量抓取想建立个人素材库的收藏党直播回放录制FLV / HLS 双协议主播下播自动保留已录数据课程、讲座、赛事记录者评论采集每个作品额外输出*_comments.json做内容分析和运营复盘的人热搜与搜索热搜榜、关键词结果导出 JSONL追热点、找选题的创作者REST API 服务HTTP 接口提交下载任务想接入自动化流程的开发者上手难度上普通用户只需要会改 YAML 配置想要并发、代理、通知这些进阶能力配置项也都有现成开关。下文先带你完整跑通第一次下载再进入具体场景。第一次运行从安装到出片的完整路径先说明环境需要 Python 3.8 以上macOS、Linux、Windows 都支持。整个过程不需要写一行 Python 代码。第一步把项目克隆到本地并安装依赖。在终端里执行git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt第二步生成配置文件并自动获取 Cookie。抖音接口需要身份凭证项目提供了自动获取方式省去手动从浏览器开发者工具里翻 Cookie 的麻烦cp config.example.yml config.yml python -m tools.cookie_fetcher --config config.yml运行第二条命令后会自动弹出浏览器你正常登录抖音回到终端按 Enter程序会把 Cookie 写进配置。如果之后遇到 Cookie 失效重新跑一遍这条命令即可。第三步把想下的链接写进配置。用任意编辑器打开config.yml把link换成你的目标link: - https://www.douyin.com/video/7604129988555574538 # 想下载的视频 path: ./Downloaded/ # 保存目录 thread: 5 # 并发下载数默认 5第四步运行并观察进度。python run.py -c config.yml命令行会以 Rich 进度条展示每个任务的状态下载完成的作品会自动附带封面、音乐、头像和一份 JSON 元数据。整个过程体验下来最直观的感受是省心链接解析失败会自动重试下载不完整的文件会被自动清理后重新拉取进度条不再刷屏干扰。画面里你能看到工具在启动时打印的配置摘要、抓取到的作品数量、线程数以及跳过已存在的去重提示——这意味着同一文件不会因为重复运行命令而再次下载。场景一批量归档一位创作者的全部历史作品什么时候需要它你关注了一位宝藏博主想把他过去半年的作品全部留存用于学习或二次创作或者你想长期跟踪某类账号定期增量同步新内容。配置文件的mode就是为此设计的它控制抓取主页的哪几类内容link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx # 作者主页链接 mode: - post # 发布的作品 - like # 点赞的作品 - mix # 合集内容 - music # 音乐原声作品 number: post: 0 # 0 表示全量下载可改成具体数字限制数量 database: true首次使用建议把number.post设成 20 先试跑确认目录结构和清晰度符合预期后再改成 0 全量拉取。下载完成后目录会自动整理成作者名 / 模式 / 作品名的层级每个作品独立成文件夹Downloaded/ └── 讲师昵称/ ├── post/ # 2026-03-01_直播切片技巧_732xxx/ 内含 mp4、封面、音乐、data.json ├── like/ ├── mix/ └── music/批量任务会并行推进进度条实时显示每个作品的完成情况失败项自动重试最终给出成功数与耗时统计。真正让人放心的是增量下载机制。开启increase开关后工具会结合数据库记录和本地文件双重判断只下载新增作品不会把整个主页再拉一遍increase: post: true like: true mix: true music: true对于需要定期同步的账号这套全量首跑 增量跟进的组合几乎是零维护成本。下载完成的文件在资源管理器里按日期和标题命名一眼就能找到目标内容。场景二定时保存直播回放与评论数据直播是抖音上信息密度最高的内容形式之一但也是最容易转瞬即逝的。douyin-downloader 的直播录制功能解决的就是这个问题把直播间链接放进配置录到主播下播为止。link: - https://live.douyin.com/123456789 # 直播间链接 live: max_duration_seconds: 0 # 0 一直录到主播下播也可设 3600 限制 1 小时 chunk_size: 65536 # 流分块大小保持默认即可 idle_timeout_seconds: 30 # 流空闲 30 秒视为结束录制得到的 FLV 文件保存在Downloaded/{作者}/live/目录同时会附带一份*_room.json记录直播间元数据。最贴心的一点是容错设计无论主播下播、网络空闲还是你手动中断已录制的数据都会被保留不会因为意外中断而前功尽弃。录制之外另一个高频需求是评论采集。如果你在做账号运营或竞品分析想了解用户对某条作品的真实反馈可以这样开启comments: enabled: true include_replies: false # 设为 true 会额外抓取每条评论的二级回复 max_comments: 0 # 0 不限数量 page_size: 20每个作品旁边会生成一份*_comments.json评论、作者、时间字段齐全方便后续导入表格或做文本分析。对内容创作者来说这份数据比截图存档有价值得多。场景三热搜、搜索、API 与通知把下载器接进你的流程当你不满足于手动下几个视频就可以开始把下载器当作一条自动化流水线来用。追热点和找选题可以用内置的热搜榜与关键词搜索功能# 拉取抖音热搜榜前 30 条导出为 JSONL 快照 python run.py --hot-board 30 -p ./Downloaded # 搜索猫咪相关内容最多取 100 条 python run.py --search 猫咪 --search-max 100 -p ./Downloaded结果会写入hot_board/和search/目录下的带时间戳 JSONL 文件作为历史留档或进一步分析的素材。把下载能力开放成服务则适合需要二次开发的场景。安装两个可选依赖后下载器就变成一个本地 REST 服务pip install fastapi uvicorn python run.py --serve --serve-port 8000之后任何程序都可以通过 HTTP 接口提交任务接口用途POST /api/v1/download提交{url: ...}返回任务 IDGET /api/v1/jobs/{job_id}查询单个任务状态与计数GET /api/v1/jobs列出最近任务GET /api/v1/health健康检查探针这就意味着你可以把抖音下载接进自己的定时脚本、消息机器人甚至是 Web 后台实现每天凌晨自动同步指定账号新作品这类无人值守流程。下载完成的通知推送则让长任务不再需要盯着屏幕。支持 Bark、Telegram 和企业微信/飞书/钉钉的 Webhooknotifications: enabled: true on_success: true on_failure: true providers: - type: bark url: https://api.day.app/YOUR_DEVICE_KEY # 换成你的 Bark 设备码任务跑完手机收到推送你才知道该去整理素材了。如果还想更进一步可选的视频转写功能能在下载后调用语音识别接口直接输出逐字稿用于做字幕或文字稿。图形界面不想敲命令也能用的 Douzy 桌面版命令行确实灵活但对不熟悉终端的朋友仍有门槛。项目团队基于同一套后端打造了桌面版 Douzy当前内测中把核心能力搬进了可视化界面粘贴链接即刻开始、同步关注列表、实时查看进度、SQLite 档案管理、自定义命名规则。CLI 和桌面版共用同一套后端逻辑也就是说你在命令行里调通的配置思路在桌面版里同样成立。选择哪种形态取决于你习惯键盘还是鼠标。常见问题速查与优化建议Q为什么只能抓到 20 条作品这是抖音翻页风控的常见表现。解决方案确认配置中browser_fallback.enabled: true且headless: false当浏览器自动弹出时手动完成验证码后不要立即关闭窗口程序会继续翻页抓取。QCookie 失效了怎么办重新执行一次自动获取命令即可无需手动复制粘贴python -m tools.cookie_fetcher --config config.yml。Q下载速度慢或总是失败先看网络时段再调并发。thread可以适当调大但建议控制在 10 以内避免触发风控如果身处受限网络配置proxy参数为本地代理地址即可。Q如何查看下载历史开启database: true后可用 SQLite 直接查询sqlite3 dy_downloader.db SELECT aweme_id, title, author_name FROM aweme ORDER BY download_time DESC LIMIT 20;Q想重新下载某个作品怎么办程序通过数据库记录 本地文件双重检查判断是否跳过。删除对应文件的目录并清掉数据库记录即可触发重下两个条件缺一不可。优化建议清单大批量任务分时段分批跑别一次性压满按作者 / 类型 / 用途规划保存目录配合命名模板{date}_{title}_{id}让文件名自带时间信息重要内容定期备份数据库和文件目录一并留存。资源延伸与行动号召项目的完整说明在仓库的 README 和使用文档里config.example.yml是带注释的配置模板几乎每个配置项都有示例core/目录是下载核心逻辑想深入理解实现原理可以从这里读起tests/下有七十多个自动化测试覆盖了配置加载、去重、直播录制等关键路径是了解功能边界的好材料。如果你是第一次接触这类工具建议从下面这条命令开始你的第一个任务git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt然后复制配置、跑一次 Cookie 获取把一条视频链接放进link字段运行python run.py -c config.yml。十分钟之内你就能亲手验证批量下载 去水印 自动归档到底是什么体验。最后提醒一句下载工具解决的是效率问题但使用边界同样重要。请遵守平台规则尊重创作者版权下载内容仅用于个人学习、备份与合理引用不要用于任何商业或侵权用途。技术是工具怎么用取决于你。【免费下载链接】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-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 去重。无论你是想备份学习资料还是定期整理关注创作者的全部作品这篇 douyin-downloader 使用教程都能让你在半小时内跑通第一个下载任务。凌晨两点她只花三分钟备份了一周的直播回放小周是一家在线教育公司的内容运营每天的工作之一是把当天的课程直播保存成回放素材。工具倒是现成的——录屏软件、浏览器插件、手动下载各来一套。可一套流程下来一场 40 分钟的直播要折腾将近半小时录屏容易录进弹窗网页缓存下载经常断流文件名还是乱码归档时全靠肉眼辨认。直到同事把 douyin-downloader 丢给她。她把直播间链接粘贴进配置文件运行一条命令去倒杯水回来FLV 文件已经按照作者名 / 直播标题 / 日期的目录结构整齐躺好。更让她意外的是周末她想把一位讲剪辑的老师近半年的作品全部留存原以为要熬个大夜结果同样一条命令几百个视频按发布、点赞、合集、音乐分类自动归位重复内容一个没下。她感叹的不是工具很强大而是原来这种事可以不用人盯。这正是这类抖音下载工具存在的意义把重复劳动交给程序把时间还给人。一句话定位它是什么能解决什么问题简单说douyin-downloader 是一个粘贴链接就能下的抖音资源管理器。你给它一个视频链接、一个用户主页链接或一个直播间链接它负责解析、去水印、挑选最高码率、下载媒体文件、整理目录并把每一次下载记进数据库避免下次重复劳动。核心能力具体表现适合谁单条内容下载视频、图文、合集、音乐链接即贴即下只想保存一两条的普通用户作者主页批量下载post / like / mix / music 四种模式全量抓取想建立个人素材库的收藏党直播回放录制FLV / HLS 双协议主播下播自动保留已录数据课程、讲座、赛事记录者评论采集每个作品额外输出*_comments.json做内容分析和运营复盘的人热搜与搜索热搜榜、关键词结果导出 JSONL追热点、找选题的创作者REST API 服务HTTP 接口提交下载任务想接入自动化流程的开发者上手难度上普通用户只需要会改 YAML 配置想要并发、代理、通知这些进阶能力配置项也都有现成开关。下文先带你完整跑通第一次下载再进入具体场景。第一次运行从安装到出片的完整路径先说明环境需要 Python 3.8 以上macOS、Linux、Windows 都支持。整个过程不需要写一行 Python 代码。第一步把项目克隆到本地并安装依赖。在终端里执行git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt第二步生成配置文件并自动获取 Cookie。抖音接口需要身份凭证项目提供了自动获取方式省去手动从浏览器开发者工具里翻 Cookie 的麻烦cp config.example.yml config.yml python -m tools.cookie_fetcher --config config.yml运行第二条命令后会自动弹出浏览器你正常登录抖音回到终端按 Enter程序会把 Cookie 写进配置。如果之后遇到 Cookie 失效重新跑一遍这条命令即可。第三步把想下的链接写进配置。用任意编辑器打开config.yml把link换成你的目标link: - https://www.douyin.com/video/7604129988555574538 # 想下载的视频 path: ./Downloaded/ # 保存目录 thread: 5 # 并发下载数默认 5第四步运行并观察进度。python run.py -c config.yml命令行会以 Rich 进度条展示每个任务的状态下载完成的作品会自动附带封面、音乐、头像和一份 JSON 元数据。整个过程体验下来最直观的感受是省心链接解析失败会自动重试下载不完整的文件会被自动清理后重新拉取进度条不再刷屏干扰。画面里你能看到工具在启动时打印的配置摘要、抓取到的作品数量、线程数以及跳过已存在的去重提示——这意味着同一文件不会因为重复运行命令而再次下载。场景一批量归档一位创作者的全部历史作品什么时候需要它你关注了一位宝藏博主想把他过去半年的作品全部留存用于学习或二次创作或者你想长期跟踪某类账号定期增量同步新内容。配置文件的mode就是为此设计的它控制抓取主页的哪几类内容link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx # 作者主页链接 mode: - post # 发布的作品 - like # 点赞的作品 - mix # 合集内容 - music # 音乐原声作品 number: post: 0 # 0 表示全量下载可改成具体数字限制数量 database: true首次使用建议把number.post设成 20 先试跑确认目录结构和清晰度符合预期后再改成 0 全量拉取。下载完成后目录会自动整理成作者名 / 模式 / 作品名的层级每个作品独立成文件夹Downloaded/ └── 讲师昵称/ ├── post/ # 2026-03-01_直播切片技巧_732xxx/ 内含 mp4、封面、音乐、data.json ├── like/ ├── mix/ └── music/批量任务会并行推进进度条实时显示每个作品的完成情况失败项自动重试最终给出成功数与耗时统计。真正让人放心的是增量下载机制。开启increase开关后工具会结合数据库记录和本地文件双重判断只下载新增作品不会把整个主页再拉一遍increase: post: true like: true mix: true music: true对于需要定期同步的账号这套全量首跑 增量跟进的组合几乎是零维护成本。下载完成的文件在资源管理器里按日期和标题命名一眼就能找到目标内容。场景二定时保存直播回放与评论数据直播是抖音上信息密度最高的内容形式之一但也是最容易转瞬即逝的。douyin-downloader 的直播录制功能解决的就是这个问题把直播间链接放进配置录到主播下播为止。link: - https://live.douyin.com/123456789 # 直播间链接 live: max_duration_seconds: 0 # 0 一直录到主播下播也可设 3600 限制 1 小时 chunk_size: 65536 # 流分块大小保持默认即可 idle_timeout_seconds: 30 # 流空闲 30 秒视为结束录制得到的 FLV 文件保存在Downloaded/{作者}/live/目录同时会附带一份*_room.json记录直播间元数据。最贴心的一点是容错设计无论主播下播、网络空闲还是你手动中断已录制的数据都会被保留不会因为意外中断而前功尽弃。录制之外另一个高频需求是评论采集。如果你在做账号运营或竞品分析想了解用户对某条作品的真实反馈可以这样开启comments: enabled: true include_replies: false # 设为 true 会额外抓取每条评论的二级回复 max_comments: 0 # 0 不限数量 page_size: 20每个作品旁边会生成一份*_comments.json评论、作者、时间字段齐全方便后续导入表格或做文本分析。对内容创作者来说这份数据比截图存档有价值得多。场景三热搜、搜索、API 与通知把下载器接进你的流程当你不满足于手动下几个视频就可以开始把下载器当作一条自动化流水线来用。追热点和找选题可以用内置的热搜榜与关键词搜索功能# 拉取抖音热搜榜前 30 条导出为 JSONL 快照 python run.py --hot-board 30 -p ./Downloaded # 搜索猫咪相关内容最多取 100 条 python run.py --search 猫咪 --search-max 100 -p ./Downloaded结果会写入hot_board/和search/目录下的带时间戳 JSONL 文件作为历史留档或进一步分析的素材。把下载能力开放成服务则适合需要二次开发的场景。安装两个可选依赖后下载器就变成一个本地 REST 服务pip install fastapi uvicorn python run.py --serve --serve-port 8000之后任何程序都可以通过 HTTP 接口提交任务接口用途POST /api/v1/download提交{url: ...}返回任务 IDGET /api/v1/jobs/{job_id}查询单个任务状态与计数GET /api/v1/jobs列出最近任务GET /api/v1/health健康检查探针这就意味着你可以把抖音下载接进自己的定时脚本、消息机器人甚至是 Web 后台实现每天凌晨自动同步指定账号新作品这类无人值守流程。下载完成的通知推送则让长任务不再需要盯着屏幕。支持 Bark、Telegram 和企业微信/飞书/钉钉的 Webhooknotifications: enabled: true on_success: true on_failure: true providers: - type: bark url: https://api.day.app/YOUR_DEVICE_KEY # 换成你的 Bark 设备码任务跑完手机收到推送你才知道该去整理素材了。如果还想更进一步可选的视频转写功能能在下载后调用语音识别接口直接输出逐字稿用于做字幕或文字稿。图形界面不想敲命令也能用的 Douzy 桌面版命令行确实灵活但对不熟悉终端的朋友仍有门槛。项目团队基于同一套后端打造了桌面版 Douzy当前内测中把核心能力搬进了可视化界面粘贴链接即刻开始、同步关注列表、实时查看进度、SQLite 档案管理、自定义命名规则。CLI 和桌面版共用同一套后端逻辑也就是说你在命令行里调通的配置思路在桌面版里同样成立。选择哪种形态取决于你习惯键盘还是鼠标。常见问题速查与优化建议Q为什么只能抓到 20 条作品这是抖音翻页风控的常见表现。解决方案确认配置中browser_fallback.enabled: true且headless: false当浏览器自动弹出时手动完成验证码后不要立即关闭窗口程序会继续翻页抓取。QCookie 失效了怎么办重新执行一次自动获取命令即可无需手动复制粘贴python -m tools.cookie_fetcher --config config.yml。Q下载速度慢或总是失败先看网络时段再调并发。thread可以适当调大但建议控制在 10 以内避免触发风控如果身处受限网络配置proxy参数为本地代理地址即可。Q如何查看下载历史开启database: true后可用 SQLite 直接查询sqlite3 dy_downloader.db SELECT aweme_id, title, author_name FROM aweme ORDER BY download_time DESC LIMIT 20;Q想重新下载某个作品怎么办程序通过数据库记录 本地文件双重检查判断是否跳过。删除对应文件的目录并清掉数据库记录即可触发重下两个条件缺一不可。优化建议清单大批量任务分时段分批跑别一次性压满按作者 / 类型 / 用途规划保存目录配合命名模板{date}_{title}_{id}让文件名自带时间信息重要内容定期备份数据库和文件目录一并留存。资源延伸与行动号召项目的完整说明在仓库的 README 和使用文档里config.example.yml是带注释的配置模板几乎每个配置项都有示例core/目录是下载核心逻辑想深入理解实现原理可以从这里读起tests/下有七十多个自动化测试覆盖了配置加载、去重、直播录制等关键路径是了解功能边界的好材料。如果你是第一次接触这类工具建议从下面这条命令开始你的第一个任务git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt然后复制配置、跑一次 Cookie 获取把一条视频链接放进link字段运行python run.py -c config.yml。十分钟之内你就能亲手验证批量下载 去水印 自动归档到底是什么体验。最后提醒一句下载工具解决的是效率问题但使用边界同样重要。请遵守平台规则尊重创作者版权下载内容仅用于个人学习、备份与合理引用不要用于任何商业或侵权用途。技术是工具怎么用取决于你。【免费下载链接】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），仅供参考 
