抖音批量下载工具终极教程免费开源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。这是一个免费开源、跨平台Windows / macOS / Linux的抖音下载工具用 Python 编写能做的远不止存个视频那么简单。一句话定位douyin-downloader 是一款免费开源的抖音批量下载工具下载无水印高清视频支持视频、图集、合集、音乐、直播、评论采集还能自动去重、失败重试和同类工具最大的区别是全家桶式的完整度与工程化的健壮性。你不需要懂代码。跟着下面的三步起跑十分钟内就能跑通第一条下载任务。三步起跑从零到第一次下载成功第一步拿到项目代码在终端里执行git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader提示项目代码托管在 GitCode 上公开、免费任何人都可以查看完整源码。第二步安装依赖建议先确认你的电脑已安装 Python 3.8 及以上版本然后执行pip install -r requirements.txt如果你希望使用浏览器兜底和自动获取 Cookie这两个进阶能力再补装 Playwrightpip install playwright python -m playwright install chromium第三步获取 Cookie 并首次运行第一次使用需要配置 Cookie——它是访问抖音接口的通行证。好在工具提供了自动获取方式cp config.example.yml config.yml python -m tools.cookie_fetcher --config config.yml命令会弹出浏览器窗口你登录一次抖音回到终端按回车Cookie 就自动写进配置了。之后修改config.yml把链接换成你想下载的内容link: - https://www.douyin.com/video/1234567890123456789 # 换成你的视频链接 path: ./Downloaded/ # 下载保存目录保存后运行python run.py -c config.yml稍等片刻你就会看到类似下面的进度界面视频、封面、音乐逐项下载最后统计出成功 / 跳过 / 耗时。图下载完成后工具会展示作品数量、跳过记录与耗时统计跑通这一条你就已经完成了 90% 的入门。接下来我们直接进入真实场景。场景实战用任务驱动而不是背功能清单场景一备份心仪博主的所有作品小林现在要做的第一件事就是把那位要注销的博主的全部作品存下来。这不需要一条条复制链接只要把用户主页链接放进配置link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx # 博主主页地址 mode: - post # post作品 / like点赞 / mix合集 / music音乐 number: post: 0 # 0 表示不限制数量全部下载 thread: 5 # 并发数网络好可以调到 8~10然后运行python run.py -c config.yml。工具会自动翻页拉取主页上的所有作品并发下载并且自动挑选无水印、最高码率的视频源。如果想同时备份这个博主的点赞列表、他创建的合集、他使用的原声只需把mode展开mode: - post - like - mix - music跨模式还内置了去重同一条作品无论出现在哪个模式下都只会下载一次不会浪费磁盘。下载完成后的目录是自动整理好的每个作品一个文件夹日期、标题、ID 一目了然Downloaded/ └── 博主名/ └── post/ └── 2024-02-07_作品标题_123456789/ ├── 2024-02-07_作品标题_123456789.mp4 ├── ..._cover.jpg # 封面 ├── ..._music.mp3 # 背景音乐 ├── ..._avatar.jpg # 作者头像 └── ..._data.json # 完整元数据图每个作品一个独立文件夹视频、封面、音乐、元数据整齐归档场景二直播没赶上下次自动录制朋友约你周五晚上出去玩可那位主播偏偏周五直播。没关系douyin-downloader 支持直播录制你只要把直播间链接放进配置link: - https://live.douyin.com/123456789 live: max_duration_seconds: 3600 # 0 表示录到主播下播为止 idle_timeout_seconds: 30 # 网络空闲多久视为结束运行时工具会读取直播间信息让你选择清晰度如 FULL_HD1 高清 / SD1 / SD2图直播录制前可选择清晰度工具自动获取推流地址录制过程有几个贴心的细节主播下播、网络空闲或你按 CtrlC 中断时已录制的部分都会保留不会因为中断而前功尽弃。录好的文件保存在Downloaded/作者名/live/目录下同时附带一份直播间元数据快照*_room.json。场景三做内容研究顺便把评论也带走如果你是做内容分析、竞品研究、选题调研的人这个场景会特别对味。工具提供了三个研究型能力采集评论——下载作品时同时抓取评论甚至包含二级回复comments: enabled: true include_replies: true # 是否抓取每条评论的回复请求量更大 max_comments: 500 # 0 表示不限采集结果会以*_comments.json的形式保存在作品文件夹旁方便你用脚本做文本分析。导出热搜榜——想知道今天抖音在热什么一条命令即可python run.py --hot-board 30 -p ./Downloaded # 输出./Downloaded/hot_board/20260424_221530.jsonl关键词搜索——按关键词搜索作品并导出结果python run.py --search 猫咪 --search-max 100 -p ./Downloaded # 输出./Downloaded/search/猫咪_20260424_221530.jsonl三个能力都直接输出结构化数据JSONL是喂给分析流程的理想格式。场景四备份自己的收藏夹收藏了 300 条平台改版后找不到入口了——别慌收藏夹也能整批备份。链接使用当前登录账号的收藏页地址link: - https://www.douyin.com/user/self?showTabfavorite_collection mode: - collect # collect收藏作品 / collectmix收藏合集 number: collect: 0 # 0 表示全部注意收藏夹模式collect / collectmix只支持当前 Cookie 登录的账号且需要单独使用不要与 post / like 等模式混在一起。避坑指南新手最常踩的 5 个坑坑 1主页只能抓到 20 条作品就停了现象明明博主有几百条作品却只下载了十几二十条。原因翻页触发平台风控接口不再返回更多数据。解法开启浏览器兜底它会启动真实浏览器继续翻页必要时弹窗让你手动过验证码browser_fallback: enabled: true headless: false # 保持非无头模式方便人工验证弹窗出现后不要急着关窗口手动完成滑块或验证码工具会继续抓取剩余作品。坑 2运行报 403或提示 Cookie 失效现象请求被拒绝日志出现鉴权类报错。解法重新执行一次 Cookie 获取命令更新配置python -m tools.cookie_fetcher --config config.ymlCookie 有时效建议定期刷新如果开了代理确认proxy配置正确如http://127.0.0.1:7890。坑 3提示已跳过想重新下载某条作品现象明明删了文件重跑还是被跳过。原因工具通过数据库记录 本地文件双重去重只删一边不够。解法两边一起清理。假设要重下某条aweme_id# 删除本地文件目录目录名中包含 aweme_id rm -rf Downloaded/作者名/post/*_aweme_id/ # 删除数据库记录 sqlite3 dy_downloader.db DELETE FROM aweme WHERE aweme_id aweme_id;坑 4直播录完只有一个 playlist 文件播不了现象直播源是 HLS 时只保存了.m3u8列表文件。原因HLS 源需要二次处理合成。解法优先选择 FLV 源可直接播放如果只有 HLS用 ffmpeg 转一下ffmpeg -i playlist.m3u8 -c copy output.mp4坑 5日志刷屏进度条看花眼现象终端信息量太大进度条被日志打断。解法默认配置里已经开启了静默模式确认progress.quiet_logs: true只有调试时才临时加--show-warnings或-v查看详细日志。进阶提效技巧技巧 1增量下载只抓新作品关注一个日更博主每天全量重跑太浪费。开启增量后工具会通过数据库判断哪些作品已下载只拉取新增部分increase: post: true database: true # 增量依赖数据库记录适合配合定时任务实现每天自动备份新作品。技巧 2下载完成手机立刻收到通知长任务总不能一直盯着终端。工具支持下载完成后的推送支持 Bark、Telegram、Webhook企业微信 / 飞书 / 钉钉机器人通用notifications: enabled: true on_success: true on_failure: true providers: - type: bark url: https://api.day.app/YOUR_DEVICE_KEY - type: webhook url: https://qyapi.weixin.qq.com/cgi-bin/webhook/send?keyxxx技巧 3把工具变成你自己的下载 API装了fastapi uvicorn之后工具能以 REST API 服务模式运行方便集成到自己的系统里pip install fastapi uvicorn python run.py --serve --serve-port 8000然后你可以 POST 一个 JSON 提交下载任务轮询任务状态做自己的下载中台POST /api/v1/download 提交 {url: ...}返回 job_id GET /api/v1/jobs/{job_id} 查询任务状态与计数 GET /api/v1/health 健康检查技巧 4让下载的视频自动转成文字稿这个功能很现代视频下载完成后自动调用 OpenAI 的转写接口生成字幕文本和 JSON适合做视频内容检索、剪辑备稿transcript: enabled: true model: gpt-4o-mini-transcribe api_key_env: OPENAI_API_KEY # 或直接在 api_key 填写注意转写仅对视频作品生效图文不会生成需要先设置好可用的 API Key。技巧 5想要图形界面试试桌面版 Douzy不喜欢命令行也没关系。项目配套了桌面客户端Douzy基于同一套后端界面更直观——粘贴链接即可下载、可视化跟踪进度、查看 SQLite 历史记录图桌面版下载界面粘贴链接、检测链接、选择下载类型图任务中心按任务管理状态支持打开目录、查看详情图实时进度页百分比、事件流、排队状态一目了然桌面版目前处于内测阶段感兴趣的读者可以关注项目 Releases 页面的安装包。横向对比它和同类工具差在哪很多读者可能用过 yt-dlp或者各种抖音去水印在线站。我们把它们放在一张表里客观对比维度douyin-downloaderyt-dlp在线去水印网站开源免费✅ 完全开源✅ 开源❌ 多为商业站抖音适配深度✅ 专为抖音设计视频/图集/合集/音乐/直播全覆盖⚠️ 通用工具抖音接口适配不稳定⚠️ 通常只支持单视频用户主页批量✅ post/like/mix/music 全模式⚠️ 部分支持受限明显❌ 不支持去重与增量✅ SQLite 本地文件双重去重❌ 无❌ 无评论采集/热搜/搜索✅ 内置❌ 无❌ 无数据安全✅ 本地运行你的 Cookie 不外传✅ 本地运行❌ 需上传链接甚至授权结论如果你的需求是偶尔存个视频在线站够用如果你要的是批量、稳定、可管理、可研究的抖音内容下载douyin-downloader 是更合适的选型。yt-dlp 是优秀的通用下载器但在抖音深度适配 批量管理这个细分赛道上本项目做得更专、更全。社区与成长开源项目的生命力douyin-downloader 是一个持续维护的开源项目采用 MIT License代码完全公开透明。项目有完善的自动化测试与 CI/CD文档齐全含中英文 README、配置文件示例、使用说明。你可以在 GitCode 项目主页查看源码、Issue 与 Releases。如果你在使用中遇到问题可以先去项目文档README.zh-CN.md、USAGE.md里找答案如果你有功能建议或发现了 Bug欢迎在项目仓库提交 Issue如果你是开发者更欢迎提交代码一起完善这个工具。现在去下载你的第一段视频回到文章开头的小林。那天晚上他用 douyin-downloader 跑了一夜把那位博主几年的作品、合集、原声全部备份下来。博主注销那天小林在群里发了一句话内容不会消失只要你愿意动手保存。工具再好也只是工具。价值在你自己手里——那些你真正在意、反复回味的作品值得拥有一个本地副本。现在你已经掌握了安装、配置、场景实战和避坑要点剩下的就是动手试一次。在终端里敲下python run.py -c config.yml把第一段视频存进你的硬盘吧。欢迎把使用体验、踩过的坑或者想要的特性告诉我们你的反馈会让这个开源项目变得更好。项目官方仓库GitCode 上的GitHub_Trending/do/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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考