抖音批量下载工具完整教程主页、合集、音乐一次跑通断点续传与增量下载详解【免费下载链接】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 是一个免费的开源抖音批量下载工具支持单条视频、用户主页作品、抖音合集下载和音乐原声的批量保存自带进度展示、失败重试、SQLite 去重和浏览器回退。这篇教程以完整跑通一次为目标先让一条链路走通再逐个讲清配置项的作用最后把常见的三类问题讲透。先跑通一次两条入口的差别项目里有两版可执行入口职责不一样。稳定版DouYinCommand.py直接读取当前目录的config_douyin.yml适合单条视频和常规批量场景增强版downloader.py同样读配置文件默认config.yml兼容config_simple.yml但多一组命令行参数不用改 YAML 就能临时覆盖配置-u直接指定 URL、-p改保存路径、--auto-cookie自动获取 Cookie、--cookie手动传入 Cookie 字符串。git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt首次使用建议从一条短视频链接开始把number里的数量限制到 3 条左右确认目录里能看到视频文件、封面和metadata.json后再上主页链接这样任何配置错误都能很快定位。把 Cookie 配对自动与手动两条路抖音接口需要登录态工具把这一步做成了两个脚本。自动方式用cookie_extractor.py底层是 Playwright需pip install playwright playwright install运行后弹出浏览器窗口手动登录Cookie 会被提取并写入配置文件手动方式用get_cookies_manual.py自己从浏览器开发者工具里复制 Cookie 后填入。配置文件里 Cookie 有三种写法cookies: auto走自动获取、粘贴整串 Cookie 字符串、或写成键值对按优先级从上到下选一种切换时注释掉其余即可。命令行也可以传--cookie msTokenxxx; ttwidyyy临时指定。Cookie 里含登录信息不要分享带它的配置文件。一份配置里真正要动的几个字段最小可用配置只需要三行link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx - https://v.douyin.com/xxxxx/ path: ./Downloaded/其余字段默认值就能工作需要时再改link是唯一的必选项单条视频、主页、合集、音乐链接可以混在一个列表里批量处理。mode仅对主页链接生效取值post作品或like点赞默认post。number按类型限制条数0表示不限制increase打开增量下载后同一链接第二次跑只会补拉新发布的内容。start_time/end_time按YYYY-MM-DD格式筛选某个时间段的发布留空则不过滤。music、cover、json、folderstyle控制是否同时保存原声音频、封面、元数据 JSON以及是否每个视频一个文件夹。thread是并发线程数retry_times是重试次数网络不稳时可以一起调。去重、断点续传和直播录制database: true开启 SQLite 去重每次下载的记录入库重跑同一链接时已存在的内容会被直接跳过不重复占用空间。断点续传也靠这套机制中断后重跑即从上次进度继续进度区里每一项跳过原因都写得明白。直播录制只认直播流链接程序会取出推流地址并列出清晰度供选择拿到地址后交给下载工具保存配置里可用live.max_duration_seconds: 3600这类字段限制最长录制 1 小时。项目还提供一个桌面版本粘贴链接、勾选作品/喜欢/合集后在任务中心按进行中 / 已完成 / 失败跟踪每个任务的状态。三类高频问题现象、原因、处理只拿到前 20 条视频。现象是主页作品停在 20 条左右。原因是抖音的翻页限制。处理启用浏览器回退、手动完成验证码并适当降低并发数。下载速度慢或超时。原因通常是并发过高或网络受限。处理把thread调小或在配置里加proxy指向本地代理。Cookie 突然失效。现象是接口开始拒绝请求、批量失败。原因可能是 Cookie 过期或被重置。处理重新运行python cookie_extractor.py提取覆盖配置文件里的旧值。打开项目内部构造看看V1 的链路集中在apiproxy/douyin/urls.py解析链接类型core/orchestrator.py编排任务queue_manager.py与rate_limiter.py管队列和请求节奏database.py负责去重记录strategies/下按API 优先、浏览器兜底的策略协作retry_strategy.py处理失败重试。V2 的douyin-downloader/目录职责更细core/url_parser.py解析链接core/downloader_factory.py把任务分派给视频、主页、合集、音乐各自的处理器core/user_modes/下按 post/like/mix/music 等策略执行control/负责限流与重试storage/database.py管去重auth/cookie_manager.py管 Cookie 生命周期。边界与建议工具适合个人学习、研究和收藏下载内容不要商用或二次传播Cookie 含个人信息要妥善保管并发别拉太高。日常使用上先用一个小合集或number: 3跑通全流程配置文件留一份备份Cookie 失效的重新入口就是cookie_extractor.py想让某位博主的存档长期保持更新把increase和start_time组合起来定期跑一次即可。【免费下载链接】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），仅供参考
