抖音批量下载工具保姆级使用指南：从单条视频到直播回放录制一次搞定

抖音批量下载工具保姆级使用指南从单条视频到直播回放录制一次搞定【免费下载链接】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这个周末我想把关注的美食博主主页上 200 多条作品全部存下来还想找回昨晚错过的探店直播回放——手动保存太累回放又无处可看。后来我发现这类烦恼一个开源的抖音批量下载工具就能解决douyin-downloader 支持单视频、图文、合集、音乐下载也能一键批量保存作者主页全部作品甚至录制直播回放默认就去水印、自动挑最高清。听起来像要写一堆配置其实不用。这篇文章会带你从第一次下载走到进阶玩法全程只给关键命令和配置每步配一句大白话解释。动手之前先看清楚它能干什么一张表讲清能力边界。重点不是功能多而是实用使用场景支持情况一句话说明单条视频 / 图文 / 合集 / 音乐✅粘链接就能下抖音短链接✅v.douyin.com自动解析作者主页批量✅ 作品/点赞/合集/音乐一次搬空整个主页自己账号的收藏夹✅需要登录 Cookie直播录制✅ FLV/HLS主播下播数据自动保留评论采集✅每个作品生成独立 JSON热搜榜 / 关键词搜索✅结果导出 JSONL实用体现在三个默认生效的细节上优先选择无水印视频源从视频的码率列表里自动挑最高清下载后用 Content-Length 校验完整性文件不完整就自动清理重下。这三件事不需要你配置任何东西。10 分钟跑通第一次下载装好环境和依赖仓库地址先记一下https://gitcode.com/GitHub_Trending/do/douyin-downloadergit clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt大白话拉代码、装依赖三步到位。如果你后面想用浏览器兜底和自动获取 Cookie再多装一个 Playwright可选pip install playwright python -m playwright install chromium登录凭证让程序替你搞定python -m tools.cookie_fetcher --config config.yml这条命令会自动打开浏览器你登录一次抖音账号回到终端按一下回车Cookie 就自动写进配置了。之后再遇到登录过期重跑这一条就行。第一次下载粘一条链接试试python run.py -c config.yml -u https://www.douyin.com/video/7604129988555574538-u是临时追加的链接不想改配置文件也能直接下。跑完你会看到类似下面的界面视频、封面、头像各自有进度状态已经存在的文件会被自动标记跳过不会重复下载。真正的主角作者主页批量下载单视频只是热身。这个工具最常见的用法是把一个作者的全部内容搬回家比如你追的美食博主那 200 条作品、他整理的合集甚至他点赞过的视频。配置文件里这样写link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx mode: - post number: post: 50link作者主页链接mode下载什么——post作品、like点赞、mix合集、music音乐number下载多少条写 0 表示全量四种模式可以同时开跨模式还自动去重同一个作品在作品和合集里都出现只会下载一次。mode: - post - like - mix - music运行后你会看到批量下载进度逐个刷新每完成一个视频进度条就推进一格目录自动整理告别下载一坨乱下载的内容默认按作者 → 类型 → 作品组织成三级目录Downloaded/ └── 阿伟/ ├── post/2024-02-07_作品标题_aweme_id/ │ ├── ...mp4 │ ├── ..._cover.jpg │ └── ..._data.json ├── like/ ├── mix/ └── music/文件名里带了发布日期、标题和作品 ID日期用的是作品发布时间而不是下载时间这样整理历史内容时一眼就能看出先后顺序。命名模板也可以在配置里改成你喜欢的格式filename_template: {date}_{title}_{id} folder_template: {date}_{title}_{id}增量下载只搬新东西如果你把这个作者设成长期关注隔几天就想更新一次开增量模式就行increase: post: true database: truedatabase: true会把下载记录写进 SQLite默认生成dy_downloader.db配合本地文件做双重去重。下次再跑只下载新增的作品已有的直接跳过。想查下载历史也很简单sqlite3 dy_downloader.db SELECT aweme_id, title, author_name FROM aweme ORDER BY download_time DESC LIMIT 20;错过直播不用慌直播录制与回放保存直播是最容易错过了就没了的内容类型。这个工具可以录制正在进行的直播而且录到一半主播下播已录制的数据也会保留下来不会前功尽弃。link: - https://live.douyin.com/123456789 live: max_duration_seconds: 3600 # 最长录 1 小时0 表示录到主播下播运行后命令行会先列出直播间信息和清晰度选项选择后开始拉流录制录制结果存在Downloaded/{作者}/live/目录下包含 FLV 文件和一个*_room.json直播间元数据快照标题、房间号、时间都在里面。两个小提醒FLV 格式可以直接播放如果源是 HLS工具只保存 playlist 文件需要你用 ffmpeg 转一下才能播放。把下载升级成自动化流水线摸熟基础用法后下面这几个功能能帮你把偶尔手动下载变成有体系的资源管理。时间段筛选 热搜与搜索只想要某个时间段的内容start_time: 2024-01-01 end_time: 2024-12-31想知道平台最近有什么热门内容可存热搜榜和关键词搜索都支持结果导出成 JSONL方便后续分析python run.py --hot-board 30 python run.py --search 猫咪 --search-max 100评论采集需要分析评论区开启后每个作品会额外生成一份*_comments.jsoncomments: enabled: true include_replies: false # true 会多拉二级回复请求量增加 max_comments: 500 # 0 不限下载完成通知下载是耗时活不可能一直盯着终端。配置通知后任务完成会自动推送到你手机notifications: enabled: true on_success: true providers: - type: bark url: https://api.day.app/YOUR_DEVICE_KEYBark、Telegram、企业微信/飞书 Webhook 都支持多个 provider 并发推送单个失败不影响主流程。REST API把下载能力接到你自己的系统里如果想把下载集成进自动化工作流可以以服务模式运行pip install fastapi uvicorn python run.py --serve --serve-port 8000启动后通过 HTTP 提交下载任务POST /api/v1/download传一个{url: ...}就能拿到 job_id 并轮询状态。适合做收藏链接 → 自动下载这类小工具。新手最容易踩的 4 个坑坑 1只能抓到 20 条作品这是抖音翻页风控的常见现象。解决办法是让程序切到浏览器继续翻页browser_fallback: enabled: true headless: false # 弹出浏览器窗口方便你手动过验证码浏览器窗口弹出来后手动完成验证不要急着关窗口程序会自己接着跑。坑 2Cookie 失效提示登录过期时重新跑一遍自动获取命令就行——还记得吗就是python -m tools.cookie_fetcher --config config.yml那条。坑 3重复下载 / 想重新下载它靠数据库记录 本地文件双重判断所以想强制重下一个作品要同时删文件和数据库记录sqlite3 dy_downloader.db DELETE FROM aweme WHERE aweme_id aweme_id;只删数据库或只删文件都达不到重新下载的效果这点留意一下。坑 4直播 HLS 源不能直接播前面提过HLS 只保存 playlist需要用 ffmpeg 转成 mp4 再播放。命令行太硬核还有桌面版 Douzy如果你不想碰终端这个项目还基于同一套后端做了桌面版 Douzy。粘贴链接就能检测并下载界面长这样它还提供任务中心下载状态、历史记录、失败重试一目了然桌面版和命令行版共享同一套下载核心功能不缩水按自己的使用习惯选一个就行。下一步从哪里开始别想着一次掌握所有功能。我的建议先跑通单视频下载确认环境没问题再试着批量下载一个作者的作品感受进度条和目录整理确认稳定后开增量下载 数据库把它变成定期更新的习惯最后按需解锁直播录制、评论采集或 REST API。更完整的配置说明可以看仓库里的config.example.yml核心实现都在core/目录下想二次开发也可以从那里入手。最后提醒一句这个工具适合用来保存自己的内容、做学习研究和个人资料整理请遵守平台规则、尊重创作者版权不要用于商业用途或侵犯他人权益。你在使用中还遇到过什么奇怪的问题比如翻页卡住、文件缺失、某些链接解析失败——欢迎留言聊聊说不定你踩过的坑对别人也有帮助。【免费下载链接】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），仅供参考