抖音批量下载工具完整上手指南一次搞定直播回放、作者主页与合集下载【免费下载链接】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 之前我的抖音内容抢救史堪称一部血泪史用在线解析网站下载到一半弹窗广告、跳转赌博页文件还可能带水印手动一个个右键保存五十个作品存了快一小时命名还全是乱码更别提直播回放了——根本没有离线入口。后来我意识到这类需求其实极其规律把链接交给程序程序负责解析、下载、去重、归档。而命令行工具恰恰是干这种事最靠谱的形态——没有花哨的界面开销逻辑清晰还能批量调度。下面我就把从零跑通一次的完整流程走给你看。二、从零到第一个下载成果一次完整体验第一次运行前必做的 3 件事拿到项目代码后先别急着跑命令按顺序做这三件事能省掉后面 80% 的报错。第一装依赖。项目根目录的requirements.txt里列好了全部依赖一条命令装完pip install -r requirements.txt第二准备登录凭证。抖音的接口需要登录态但项目把这个过程做成了半自动它会自动打开浏览器你手动扫码登录一次回车后凭证就被抓取并写入配置文件python -m tools.cookie_fetcher --config config.yml这一步很关键——很多下载工具卡就卡在不会搞 Cookie这个命令把最劝退的一步变成了扫码回车完成。第三确认配置文件。打开config.example.yml或复制成config.yml它长这样link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx mode: - post # 下载作者发布的作品 number: post: 50 # 最多下载最近 50 个 path: ./Downloaded/ thread: 5 # 5 个并发线程 database: true # 开启 SQLite 去重看不懂没关系后面每一项我都会讲到。先按默认配置跑通再说。跑通第一个任务下载某个作者的主页配置里的link填上作者主页链接然后执行python run.py -c config.yml屏幕上会依次出现链接解析 → 拉取作品列表 → 逐条下载 → 汇总结果。第一次看到那个实时进度条和跳过已存在的提示时我莫名有种解压的快感——它真的在认真干活。看看你的第一个战利品下载完成后到Downloaded/目录下你会发现文件被整理得清清楚楚Downloaded/ └── 作者名/ └── post/ └── 2026-02-07_作品标题_aweme_id/ ├── 2026-02-07_作品标题_aweme_id.mp4 ├── 2026-02-07_作品标题_aweme_id_cover.jpg ├── 2026-02-07_作品标题_aweme_id_music.mp3 ├── 2026-02-07_作品标题_aweme_id_avatar.jpg └── 2026-02-07_作品标题_aweme_id_data.json每个作品一个独立文件夹视频、封面、音乐、头像、原始 JSON 元数据一应俱全。文件名里的日期用的是作品发布时间而不是下载时间——这一点太重要了意味着你的资源库天然按时间线排列找历史内容一目了然。如果你更喜欢图形界面项目还附带了一个桌面版在douyin-downloader/img/desktop/里有完整界面截图可以参考支持粘贴链接、同步关注列表、可视化任务管理体验同样顺畅。命令行和桌面版各有所长我个人的习惯是批量任务用命令行日常零散下载用桌面版。三、最打动我的四个亮点工具能跑通只是及格真正让我留下来的是下面这四件事。1. 增量下载 SQLite 去重再也不怕重复劳动为什么需要它创作者每天都在更新你不可能记住昨天下载到哪一条。全量重下既浪费时间又污染资源库。它带来什么改变开启database: true后每次下载都会写入一个 SQLite 数据库默认dy_downloader.db。再配合increase开关程序只下载数据库里没有的新作品increase: post: true # 作者主页增量下载 like: true # 点赞列表增量下载 database: true怎么用起来我把它做成了一个每周例行备份周五晚上跑一次新增的内容自动入库旧作品全部跳过全程不用管。配合download_manifest.jsonl清单文件每行一条 JSON记录日期、作者、标题、标签、文件路径整个下载历史可追溯、可检索比手动记笔记靠谱多了。2. 直播回放录制错过直播不再遗憾为什么需要它直播是抖音上最易逝的内容——下播即焚回放未必保留。如果是教学、发布会、比赛解说这类内容错过就是永久损失。它带来什么改变把链接从www.douyin.com/video/...换成live.douyin.com/房间号工具会解析直播间信息、探测清晰度然后开始录制link: - https://live.douyin.com/123456789 live: max_duration_seconds: 3600 # 最长录 1 小时0 录到主播下播怎么用起来我在录制一场游戏赛事直播时它自动探测到了 FULL_HD 高清流主播中途下播后录制数据也被完整保留还生成了直播间元数据快照。主播下播不丢数据这个细节只有真正丢过直播的人才知道有多贴心。3. 浏览器兜底翻页限制不再是死胡同为什么需要它抖音对 API 接口有严格的翻页限制很多下载工具下载到 20 条左右就罢工了。这不是工具的错是平台机制。它带来什么改变douyin-downloader 内置了browser_fallback兜底策略——当 API 采集受限时自动切换到真实浏览器模式通过滚动页面抓取作品 ID再补齐详情。相当于给工具装了一条备用通道browser_fallback: enabled: true headless: false # 显示浏览器窗口便于手动过验证怎么用起来我第一次下载一个发布了 274 个作品的账号时API 模式只拉到约 20 条就提示受限正当我准备放弃时程序自动弹出了浏览器开始滚动采集最终把全部 274 条都收进来了。4. 下载完成通知任务结束手机先知道为什么需要它批量下载动辄几十分钟你不可能一直盯着终端。能不能下完叫我它带来什么改变开启通知后任务完成或失败都会推送消息支持 Bark、Telegram、Webhooknotifications: enabled: true on_success: true providers: - type: bark url: https://api.day.app/YOUR_DEVICE_KEY怎么用起来我把任务安排成下班前启动到家看手机通知里会带上成功/失败/跳过的统计数字。那种到家刚好收到完成通知的体验是真的省心。四、避坑与实战心得我替你踩过的坑工具再好用起来也有讲究。下面这几条是我实际使用中撞出来的经验。坑一只下载到 20 条以为是工具坏了。我一开始以为下载不全是 bug后来才明白这是 API 翻页限制。解法就一句话确保browser_fallback.enabled为 true让它自动接管。如果你看到浏览器弹出来别关等它跑完。坑二Cookie 失效导致大面积失败。有一次批量下载到一半全部报未登录。别慌重新跑一遍抓取命令即可python -m tools.cookie_fetcher --config config.yml新版还支持检测到登录失效后自动重新登录并重试基本不用手动干预。坑三命名混乱下载完找不到东西。默认命名模板{date}_{title}_{id}已经很能打但如果你经常下载同一作者的内容建议把作者目录命名从默认的nickname改成nickname_uidauthor_dir: nickname_uid昵称直观sec_uid 保证唯一两者结合可以避免作者改名后目录分裂的问题。这个参数在桌面版的设置界面里也能直接改。心得先跑单条再上批量。换新电脑或新网络环境时我永远先用单个视频链接验证一遍确认 Cookie 有效、网络通畅再丢大批量任务进去。磨刀不误砍柴工。心得善用时间过滤只下你需要的。有些作者内容跨度好几年全量下载没意义。用时间窗口精准收割start_time: 2026-01-01 end_time: 2026-08-01我备份一位技术博主的教程时就是这么做的——只保留今年的内容省了一半流量和磁盘。五、快问快答Q我真的需要命令行工具吗它难不难A不难。你要做的就三件事装依赖、跑一次抓 Cookie 的命令、填链接。剩下的它全包了。而且桌面版可以完全替代命令行操作怕黑屏的话先从桌面版入手。Q下载速度慢怎么提速A先把thread从默认的 5 提到 8 试试同时确认retry_times设了重试默认 3 次以应对网络波动。如果还慢检查是不是用了代理——proxy参数配置不当反而会拖慢速度。Q会不会把整个作者的所有内容都下载下来A默认不会。number.post控制数量download_pinned默认 false 表示不下载置顶作品加上时间过滤和增量开关你可以精确控制下什么、下多少。Q下载的作品带水印吗A工具默认优先抓取无水印的原始视频流同时附带封面、音乐、头像等素材。当然最终能不能拿到无水印版本取决于当时接口返回的数据。Q下载记录存在哪怎么查A默认存在dy_downloader.dbSQLite。想快速查看最近的下载历史可以用一条 SQLsqlite3 dy_downloader.db SELECT aweme_id, title, author_name FROM aweme ORDER BY download_time DESC LIMIT 20;桌面版的作品档案页面也能可视化浏览支持按作者、标题关键词、发布时间筛选。六、接下来你可以走得更远到这里你已经能用 douyin-downloader 完成绝大多数日常需求了。如果想再进一步有几条清晰的进阶路径玩转多模式组合一次任务同时下载作者的作品、点赞、合集和音乐用mode: [post, like, mix, music]一条配置全搞定尝试评论采集开启comments配置后每个作品会生成独立的评论 JSON做内容分析或舆情研究都很有用接入 REST API安装fastapi uvicorn后用python run.py --serve --serve-port 8000把下载能力变成 HTTP 服务集成进自己的自动化工作流热搜与搜索python run.py --hot-board 30拉取热搜榜python run.py --search 关键词 --search-max 100按关键词搜索作品灵感收集利器。想深入理解它怎么运作可以翻翻项目的核心源码目录douyin-downloader/core/下载主流程、URL 解析、API 客户端或者看config.example.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-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 之前我的抖音内容抢救史堪称一部血泪史用在线解析网站下载到一半弹窗广告、跳转赌博页文件还可能带水印手动一个个右键保存五十个作品存了快一小时命名还全是乱码更别提直播回放了——根本没有离线入口。后来我意识到这类需求其实极其规律把链接交给程序程序负责解析、下载、去重、归档。而命令行工具恰恰是干这种事最靠谱的形态——没有花哨的界面开销逻辑清晰还能批量调度。下面我就把从零跑通一次的完整流程走给你看。二、从零到第一个下载成果一次完整体验第一次运行前必做的 3 件事拿到项目代码后先别急着跑命令按顺序做这三件事能省掉后面 80% 的报错。第一装依赖。项目根目录的requirements.txt里列好了全部依赖一条命令装完pip install -r requirements.txt第二准备登录凭证。抖音的接口需要登录态但项目把这个过程做成了半自动它会自动打开浏览器你手动扫码登录一次回车后凭证就被抓取并写入配置文件python -m tools.cookie_fetcher --config config.yml这一步很关键——很多下载工具卡就卡在不会搞 Cookie这个命令把最劝退的一步变成了扫码回车完成。第三确认配置文件。打开config.example.yml或复制成config.yml它长这样link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx mode: - post # 下载作者发布的作品 number: post: 50 # 最多下载最近 50 个 path: ./Downloaded/ thread: 5 # 5 个并发线程 database: true # 开启 SQLite 去重看不懂没关系后面每一项我都会讲到。先按默认配置跑通再说。跑通第一个任务下载某个作者的主页配置里的link填上作者主页链接然后执行python run.py -c config.yml屏幕上会依次出现链接解析 → 拉取作品列表 → 逐条下载 → 汇总结果。第一次看到那个实时进度条和跳过已存在的提示时我莫名有种解压的快感——它真的在认真干活。看看你的第一个战利品下载完成后到Downloaded/目录下你会发现文件被整理得清清楚楚Downloaded/ └── 作者名/ └── post/ └── 2026-02-07_作品标题_aweme_id/ ├── 2026-02-07_作品标题_aweme_id.mp4 ├── 2026-02-07_作品标题_aweme_id_cover.jpg ├── 2026-02-07_作品标题_aweme_id_music.mp3 ├── 2026-02-07_作品标题_aweme_id_avatar.jpg └── 2026-02-07_作品标题_aweme_id_data.json每个作品一个独立文件夹视频、封面、音乐、头像、原始 JSON 元数据一应俱全。文件名里的日期用的是作品发布时间而不是下载时间——这一点太重要了意味着你的资源库天然按时间线排列找历史内容一目了然。如果你更喜欢图形界面项目还附带了一个桌面版在douyin-downloader/img/desktop/里有完整界面截图可以参考支持粘贴链接、同步关注列表、可视化任务管理体验同样顺畅。命令行和桌面版各有所长我个人的习惯是批量任务用命令行日常零散下载用桌面版。三、最打动我的四个亮点工具能跑通只是及格真正让我留下来的是下面这四件事。1. 增量下载 SQLite 去重再也不怕重复劳动为什么需要它创作者每天都在更新你不可能记住昨天下载到哪一条。全量重下既浪费时间又污染资源库。它带来什么改变开启database: true后每次下载都会写入一个 SQLite 数据库默认dy_downloader.db。再配合increase开关程序只下载数据库里没有的新作品increase: post: true # 作者主页增量下载 like: true # 点赞列表增量下载 database: true怎么用起来我把它做成了一个每周例行备份周五晚上跑一次新增的内容自动入库旧作品全部跳过全程不用管。配合download_manifest.jsonl清单文件每行一条 JSON记录日期、作者、标题、标签、文件路径整个下载历史可追溯、可检索比手动记笔记靠谱多了。2. 直播回放录制错过直播不再遗憾为什么需要它直播是抖音上最易逝的内容——下播即焚回放未必保留。如果是教学、发布会、比赛解说这类内容错过就是永久损失。它带来什么改变把链接从www.douyin.com/video/...换成live.douyin.com/房间号工具会解析直播间信息、探测清晰度然后开始录制link: - https://live.douyin.com/123456789 live: max_duration_seconds: 3600 # 最长录 1 小时0 录到主播下播怎么用起来我在录制一场游戏赛事直播时它自动探测到了 FULL_HD 高清流主播中途下播后录制数据也被完整保留还生成了直播间元数据快照。主播下播不丢数据这个细节只有真正丢过直播的人才知道有多贴心。3. 浏览器兜底翻页限制不再是死胡同为什么需要它抖音对 API 接口有严格的翻页限制很多下载工具下载到 20 条左右就罢工了。这不是工具的错是平台机制。它带来什么改变douyin-downloader 内置了browser_fallback兜底策略——当 API 采集受限时自动切换到真实浏览器模式通过滚动页面抓取作品 ID再补齐详情。相当于给工具装了一条备用通道browser_fallback: enabled: true headless: false # 显示浏览器窗口便于手动过验证怎么用起来我第一次下载一个发布了 274 个作品的账号时API 模式只拉到约 20 条就提示受限正当我准备放弃时程序自动弹出了浏览器开始滚动采集最终把全部 274 条都收进来了。4. 下载完成通知任务结束手机先知道为什么需要它批量下载动辄几十分钟你不可能一直盯着终端。能不能下完叫我它带来什么改变开启通知后任务完成或失败都会推送消息支持 Bark、Telegram、Webhooknotifications: enabled: true on_success: true providers: - type: bark url: https://api.day.app/YOUR_DEVICE_KEY怎么用起来我把任务安排成下班前启动到家看手机通知里会带上成功/失败/跳过的统计数字。那种到家刚好收到完成通知的体验是真的省心。四、避坑与实战心得我替你踩过的坑工具再好用起来也有讲究。下面这几条是我实际使用中撞出来的经验。坑一只下载到 20 条以为是工具坏了。我一开始以为下载不全是 bug后来才明白这是 API 翻页限制。解法就一句话确保browser_fallback.enabled为 true让它自动接管。如果你看到浏览器弹出来别关等它跑完。坑二Cookie 失效导致大面积失败。有一次批量下载到一半全部报未登录。别慌重新跑一遍抓取命令即可python -m tools.cookie_fetcher --config config.yml新版还支持检测到登录失效后自动重新登录并重试基本不用手动干预。坑三命名混乱下载完找不到东西。默认命名模板{date}_{title}_{id}已经很能打但如果你经常下载同一作者的内容建议把作者目录命名从默认的nickname改成nickname_uidauthor_dir: nickname_uid昵称直观sec_uid 保证唯一两者结合可以避免作者改名后目录分裂的问题。这个参数在桌面版的设置界面里也能直接改。心得先跑单条再上批量。换新电脑或新网络环境时我永远先用单个视频链接验证一遍确认 Cookie 有效、网络通畅再丢大批量任务进去。磨刀不误砍柴工。心得善用时间过滤只下你需要的。有些作者内容跨度好几年全量下载没意义。用时间窗口精准收割start_time: 2026-01-01 end_time: 2026-08-01我备份一位技术博主的教程时就是这么做的——只保留今年的内容省了一半流量和磁盘。五、快问快答Q我真的需要命令行工具吗它难不难A不难。你要做的就三件事装依赖、跑一次抓 Cookie 的命令、填链接。剩下的它全包了。而且桌面版可以完全替代命令行操作怕黑屏的话先从桌面版入手。Q下载速度慢怎么提速A先把thread从默认的 5 提到 8 试试同时确认retry_times设了重试默认 3 次以应对网络波动。如果还慢检查是不是用了代理——proxy参数配置不当反而会拖慢速度。Q会不会把整个作者的所有内容都下载下来A默认不会。number.post控制数量download_pinned默认 false 表示不下载置顶作品加上时间过滤和增量开关你可以精确控制下什么、下多少。Q下载的作品带水印吗A工具默认优先抓取无水印的原始视频流同时附带封面、音乐、头像等素材。当然最终能不能拿到无水印版本取决于当时接口返回的数据。Q下载记录存在哪怎么查A默认存在dy_downloader.dbSQLite。想快速查看最近的下载历史可以用一条 SQLsqlite3 dy_downloader.db SELECT aweme_id, title, author_name FROM aweme ORDER BY download_time DESC LIMIT 20;桌面版的作品档案页面也能可视化浏览支持按作者、标题关键词、发布时间筛选。六、接下来你可以走得更远到这里你已经能用 douyin-downloader 完成绝大多数日常需求了。如果想再进一步有几条清晰的进阶路径玩转多模式组合一次任务同时下载作者的作品、点赞、合集和音乐用mode: [post, like, mix, music]一条配置全搞定尝试评论采集开启comments配置后每个作品会生成独立的评论 JSON做内容分析或舆情研究都很有用接入 REST API安装fastapi uvicorn后用python run.py --serve --serve-port 8000把下载能力变成 HTTP 服务集成进自己的自动化工作流热搜与搜索python run.py --hot-board 30拉取热搜榜python run.py --search 关键词 --search-max 100按关键词搜索作品灵感收集利器。想深入理解它怎么运作可以翻翻项目的核心源码目录douyin-downloader/core/下载主流程、URL 解析、API 客户端或者看config.example.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），仅供参考