抖音批量下载工具 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运营同事小周上周还在为竞品盘点加班一个个复制链接、逐个下载、再手动处理水印200 条素材折腾了一晚上。这周他换了 douyin-downloader这个开源的抖音批量下载工具一条命令跑完同样的事情顺带把封面、音乐和元数据一起归档。本文把它从安装到进阶玩法完整走一遍照着做你十分钟内就能完成第一次下载。一句话说清它是什么douyin-downloader 是一个面向实用场景的抖音下载工具粘贴单个视频、图文、合集、音乐链接能下丢一个作者主页进去也能按作品、点赞、合集、音乐等模式批量拉取。默认自带进度条、失败重试、数据库去重、完整性校验和浏览器兜底也就是说它不只是能下而是围绕稳定、不重复、不中断做了不少工程打磨。适合谁内容运营、短视频研究者、需要长期跟进某位作者更新的普通用户。它支持 Windows / macOS / LinuxPython 3.8 以上即可运行本地部署没有使用门槛。三步完成环境与配置十分钟跑通首次下载整个上手过程可以压缩成三步装依赖、取 Cookie、写配置然后运行每一步都有明确反馈不需要额外摸索。第一步安装依赖git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt第二行进入项目目录第三行安装全部依赖。如果之后想用自动获取 Cookie 或浏览器兜底功能再补装浏览器环境pip install playwright python -m playwright install chromium第二步获取 Cookie访问抖音接口需要登录态。工具内置的抓取脚本会自动打开浏览器引导你登录抖音登录后回到终端按回车Cookie 会被自动写进配置文件python -m tools.cookie_fetcher --config config.yml如果自动方式失败也可以手动登录抖音网页版从浏览器开发者工具里复制 Cookie 字符串粘进配置两种方式二选一即可。第三步写配置并运行复制一份最小配置只保留最常用的选项cp config.example.yml config.ymllink: - https://www.douyin.com/video/7604129988555574538 # 想下载的视频链接 path: ./Downloaded/ # 保存目录 music: true # 同时下载原声 cover: true # 同时下载封面 json: true # 保存元数据 JSON thread: 5 # 并发下载数然后启动下载python run.py -c config.yml看到进度条滚动、文件落盘第一次下载就成功了。单链接体验到此为止但这个工具的真正价值在批量场景下面用一个完整案例带你走一遍。一个案例走到底把一位博主的全部作品收进本地假设你是美食类账号运营需要把某位对标博主的全部作品存下来做逐条拆解。需求很明确作品全要、只要视频、顺便把评论也抓下来做反馈分析。配置文件这样写link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx # 博主主页 path: ./Downloaded/ mode: - post # 只下发布作品 number: post: 0 # 0 表示不限数量全量抓取 thread: 5 comments: enabled: true # 顺手采集评论 include_replies: false max_comments: 500运行后工具会自动解析主页、翻页抓取作品列表再按并发数逐个下载。命令行界面实时显示总进度和每个文件的状态已存在的内容会直接跳过下载完成后文件按作者名 → 模式 → 日期_标题_ID三层结构自动归档每个作品文件夹里除了视频本体还有封面图、原声、JSON 元数据评论则以独立 JSON 文件放在旁边整个过程不需要你盯着屏幕失败任务按指数退避自动重试网络中断后重跑时已下载的会被跳过。这正好引出它最有价值的一类玩法——长期增量追更。进阶技巧从能下到下得聪明掌握基础下载后下面 7 个技巧基本能覆盖绝大多数实际需求按需选用即可。技巧 1增量下载只追新不重复给配置加上increase.post: true并保持database: true工具会以 SQLite 里的下载记录为基准每次只下载新发布的作品。博主一天更三条你就每天补三条本地素材库永远和线上同步。技巧 2翻车时启用浏览器兜底批量抓取翻页时偶尔会遇到平台风控典型表现是只能抓到前 20 条。把browser_fallback.enabled设为true、headless设为false触发时会弹出浏览器让你人工完成验证验证通过后继续抓取。注意弹窗出现后要手动操作不要立刻关闭窗口。技巧 3评论采集做反馈分析开启comments.enabled后每个作品都会生成*_comments.json需要看楼中楼时把include_replies设为true。做竞品分析和舆情观察时这比手工截图评论高效得多。技巧 4热搜榜与关键词搜索找选题不开下载也能用它的搜索能力python run.py --hot-board 30 -p ./Downloaded python run.py --search 猫咪 --search-max 100 -p ./Downloaded前者把热搜榜导出为带时间戳的 JSONL 快照后者按关键词搜作品并落盘。两者都适合内容团队做选题参考输出文件分别在hot_board/和search/目录下。技巧 5直播录制重要场次不丢把直播间链接写进配置并配上live参数段就能以 FLV 流实时录制link: - https://live.douyin.com/123456789 live: max_duration_seconds: 3600 # 0 表示录到主播下播 chunk_size: 65536 idle_timeout_seconds: 30录制时会先探测可用清晰度再开始拉流主播下播或手动中断时已录内容会保留下来技巧 6定时任务实现全自动更新配合系统自带的任务调度增量下载可以完全无人值守。Linux/macOS 用 crontab 每天凌晨跑一次python run.py -c config.ymlWindows 用任务计划程序指向同一命令。再叠加技巧 7 的通知下载完成第一时间就知道。技巧 7下载完成推送通知在配置里声明notifications段支持 Bark、Telegram 和通用 Webhook企业微信、飞书、钉钉的机器人地址都能用。所有启用的渠道并发推送单个失败不影响主流程——批量任务跑在夜里时第二天醒来就能看到结果。技巧 8给视频自动生成文字稿开启transcript.enabled并配置 OpenAI 转写接口后视频下载完会自动生成txt和json两种转写文件方便检索视频内容。注意目前只对视频作品生效图文不会生成密钥建议用环境变量OPENAI_API_KEY提供。避坑指南五个高频问题与对应解法现象原因解法只能抓到 20 条翻页触发风控开启browser_fallback弹窗后人工过验证提示 Cookie 失效登录态过期重跑python -m tools.cookie_fetcher --config config.yml想重新下载却不执行双重去重机制生效同时清理本地文件与数据库记录具体见下文进度条疯狂刷屏阶段日志未静音保持progress.quiet_logs: true转写文件没生成前置条件不满足检查 enabled、是否为视频作品、密钥是否有效这里最容易踩的是重新下载工具靠数据库记录 本地文件双重判断去重只删一边都不会触发重下。比如要重下某个作品需要先删掉本地对应目录再执行sqlite3 dy_downloader.db DELETE FROM aweme WHERE aweme_id aweme_id;。想查看下载历史也可以用同样方式直接查询数据库。生态与延伸命令行之外还有哪些入口除了命令行项目还提供了几个延伸入口可以根据使用习惯选择桌面版 Douzy内测中基于同一套后端打造粘贴链接即可开始下载支持同步关注列表、可视化任务中心和 SQLite 历史档案适合不习惯命令行的用户。桌面版的下载界面长这样链接一贴就能开始REST API 服务模式python run.py --serve --serve-port 8000可起一个本地服务提供下载任务提交、状态查询、健康检查等接口方便接入自己的系统或脚本。Docker 部署仓库自带 Dockerfile把配置和下载目录挂载进容器即可运行适合在服务器上长期挂着跑。工程质量项目用 pytest 维护了较完整的测试用例并带 CI 自动检查这也是它敢把去重、重试、完整性校验这些逻辑做成默认行为的原因。想参与讨论或反馈问题可以加入 README 中附的 QQ 群项目采用 MIT 协议二次开发和商用都比较自由功能细节以官方文档为准。现在就可以开始别被上面的技巧吓到——你只需要一条真实链接就能起步克隆项目、装依赖、抓一次 Cookie、把链接写进配置、运行。五分钟内看到第一个文件落盘之后再去解锁批量下载和增量追更。最后提醒一句合规边界这个工具适合个人学习、素材整理和数据分析请勿用于商业性内容分发、侵权二次传播或干扰平台正常服务。下载的内容注明来源遵守平台规则工具才能长期稳定地为你所用。【免费下载链接】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），仅供参考