抖音批量下载实战指南从单条视频到整个主页的去水印下载【免费下载链接】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 是一个用 Python 写的抖音批量下载工具。它把去水印视频、图集、合集、原声音乐以及整个主页的作品一次性拉到本地用限速、重试和 SQLite 记录保证批量任务跑得稳、断了能续。截图来自基于同一套后端构建的 Douzy 桌面版展示数据为演示内容。为什么批量下载抖音作品没那么简单单条视频其实好下难的是批量。平台对单页返回的数据量有限制请求频率一高接口就开始报错Cookie 过期会让整个任务直接中断中断之后重跑又可能把同样的视频下第二遍。你要的不是一段拿到视频地址的脚本而是一套同时处理限速、登录态和去重的系统。快速上手三步跑通第一个任务环境只需要 Python 3.8 以上。装依赖、复制示例配置、运行pip install -r requirements.txt cp config.example.yml config.yml python run.py -c config.yml最小可用的配置只有三处link里放链接path填保存目录mode选模式post/like/mix/music。不想改配置时也可以直接用-u参数把链接从命令行传进去配合-t调并发数。跑通一次之后下面四个设计决定了它能不能长期稳定干活。核心设计拆解Cookie 自动获取不手抄让浏览器代劳从浏览器开发者工具里手抄 Cookie 是最容易出错的环节。Cookie 获取工具用 Playwright 拉起一个真实浏览器你扫码登录结束后它自动把 Cookie 写回配置文件只保留接口需要的关键字段如 msToken、ttwidpip install playwright python -m playwright install chromium python -m tools.cookie_fetcher --config config.yml之后 Cookie 失效就重跑这一条命令刷新不用再去翻浏览器。限速与重试2 次/秒的克制1、2、5 秒的等待批量下载稳定的核心是不贪快。限速模块用令牌桶控制所有 API 请求默认 2 次/秒每次请求之间还会加随机抖动避免间隔过于规整。重试模块在失败时做退避等待第一次等 1 秒第二次等 2 秒第三次等 5 秒默认最多重试 3 次。两者配合多数瞬时错误网络抖动、接口偶发限流会被静默吸收只有真正救不回来才会报错。浏览器兜底翻页被限制时切换滚动加载主页作品翻页走 API 时有风控风险只返回约 20 条就停。项目的兜底方案是browser_fallback.enabled: true且非无头模式下翻页被卡住就打开浏览器由你手动完成可能的验证然后滚动加载。默认最多滚动 240 轮留 600 秒等待验证。目前该路径对post模式验证完整like/mix/music仍依赖 API 分页。去重与增量按磁盘文件判断而不是数据库批量任务跑完多半还要再跑。下载器用数据库记录 本地文件双重检查决定是否跳过。开启增量increase.post: true后只要磁盘上存在非空媒体文件就直接跳过删掉文件则下次重新下载不需要去清 SQLite 表。这让中断重跑变得自然同一条配置直接再执行一遍即可。效果与实测从卡在 20 条到整夜无人值守体感上的收获主要两处。一是单视频下载不再需要把链接丢给第三方网站去水印程序自动选无水印源并从码率阶梯里挑最高的一档。二是批量任务可控某个主页只拉到 20 条就停时先查浏览器兜底是否开启、弹窗验证是否做完大多数拉不全是风控而不是程序 bug。进度条按视频、封面、音乐分项显示配合progress.quiet_logs: true后终端不会被重复日志刷屏挂着跑一夜也不难受。文件按作者/模式/日期_标题_id组织跑完能直接按创作者定位到对应作品。常见问题速查Q怎么只拉到 20 条作品A翻页触发了风控。确认browser_fallback.enabled: true、headless: false弹窗出现时手动完成验证再让它继续。Q下载慢能再快一点吗Athread控制并发下载默认 5可以调高但 API 请求受 2 次/秒的限速约束那是共享瓶颈别指望靠加线程突破。QCookie 过期任务全报错A重跑python -m tools.cookie_fetcher --config config.yml扫码登录后 Cookie 会自动写回配置。Q重跑任务已下载的内容会下第二遍吗A默认按数据库加本地文件双重检查跳过。确实想重新下载时本地文件和数据库记录要一起删只删其中一个结果会不一致。进阶调优时间过滤start_time/end_time只拉指定区间内的作品格式YYYY-MM-DD评论采集comments.enabled: true每条视频额外产出一份评论 JSON完成通知配置 Bark、Telegram 或 Webhook任务结束手机上有提醒REST 服务--serve把程序变成 HTTP 服务供别的系统提交下载任务这些全是可选项按需开启即可不必全开。注意事项与合规工具用于个人学习、研究和管理自己的数据。请控制请求频率不要在短时间内高频刷同一个主页下载内容的版权属于创作者未经同意不要二次传播或商用。平台接口随时可能变动功能失效属于正常技术风险。延伸阅读README.zh-CN.md完整中文文档与配置字段说明PROJECT_SUMMARY.md项目架构总览LICENSEMIT 许可证建议从一条单视频配置开始跑确认文件落地正常后再逐步打开批量和增量选项。【免费下载链接】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），仅供参考