抖音批量下载工具实战指南：4步跑通从Cookie配置到批量下载，增量更新与直播录制一次讲清

抖音批量下载工具实战指南4步跑通从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这篇文章以开源的抖音批量下载工具 douyin-downloader 为主角它能把抖音作者主页、合集、音乐按你的设置批量下载优先选取无水印源并默认带进度展示、指数退避重试、SQLite 去重和浏览器兜底。适合想把某位博主的作品完整存下来、之后还能定期更新收藏的人。能力地图这个工具能做什么能力一句话说明适用场景单个视频 / 图文/video/{id}、/note/{id}短链自动解析下载一条分享链接单个合集/collection/{mix_id}自动展开全部作品保存整套系列教程作者主页批量/user/{sec_uid}mode: post/like/mix/music归档博主发布、点赞、合集自己的收藏夹mode: collect/collectmix必须单独使用备份登录账号的收藏音乐下载优先原声文件缺失时回退到该音乐下首条作品建原声曲库直播录制live.douyin.com/{room_id}录 FLV/HLS中断保留已录部分录关键场次直播评论采集每作品输出*_comments.json可含二级回复研究作品下的评论热搜 / 关键词搜索--hot-board/--search结果落 JSONL收集话题素材增量 去重SQLite 记录 本地文件名双重去重定期更新收藏不重复下载浏览器兜底翻页被风控时开浏览器辅助可人工过验证只拿到 20 条时配置模板 是读这个项目最好的起点里面字段都有注释基本可以照着改。首次运行四步跑通第一个视频下载第一步拿代码、装依赖程序主体在仓库的douyin-downloader/子目录里需要 Python 3.8git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader/douyin-downloader pip install -r requirements.txt第二步复制配置文件cp config.example.yml config.yml第一次只需改四处把目标链接放进link定好保存目录指定模式和数量link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx # 作者主页 path: ./Downloaded/ # 保存目录 mode: - post # 下载发布的作品 number: post: 50 # 数量上限0 表示不限第三步获取 Cookie抖音接口需要登录态内置工具会打开浏览器让你扫码登录成功后自动写回配置pip install playwright python -m playwright install chromium python -m tools.cookie_fetcher --config config.yml登录完成后回终端按 Enterconfig.yml的cookies字段会自动更新。第四步运行python run.py -c config.yml终端会滚动 Rich 进度条结束输出成功数量和保存位置。下载完的目录按「作者 / 模式 / 作品」分层每个作品一个文件夹Downloaded/ ├── 作者名/post/ │ └── 2024-02-07_作品标题_作品ID/ │ ├── video.mp4 │ ├── cover.jpg │ ├── music.mp3 │ └── data.json └── download_manifest.jsonl # 全量下载清单高频配置字段速查只列最常用的字段其余都有合理默认值按需再改。字段默认值作用何时需要改modepost采集模式post/like/mix/music要下点赞、合集、音乐时number.mode示例为 1各模式数量上限0 不限限制批量规模时start_time/end_time空时间过滤格式YYYY-MM-DD只整理某个时间段时thread5并发下载数下载慢或被限流时调低proxy空HTTP/HTTPS 代理网络受限时databasetrueSQLite 去重与历史记录想增量下载就保持开启increase.modefalse增量下载开关定期更新收藏时browser_fallback.enabledtrue翻页风控时浏览器兜底只拿到 20 条时保持开启retry_times3失败重试次数网络不稳时可加大live.max_duration_seconds0直播录制上限0 录到主播下播限定录制时长时两个容易踩的坑collect/collectmix只作用于当前登录账号自己的收藏夹不能和另外四种模式混用增量下载依赖database: true关库就没有增量。值得单独配置的三个场景增量更新只下新作品能做什么数据库记住已下载的作品再次运行只抓新发布的老内容直接跳过。怎么配database: true # 增量依赖 SQLite 记录 increase: post: true # 只下载新发布的作品 start_time: 2026-01-01 # 可选只下这个日期之后的什么时候用关注某个博主、想每周刷新一次存档时不用每次都全量重跑。直播录制关键场次不落空能做什么贴一个直播间链接就开始录中断或下播时已录字节会保留。怎么配link: - https://live.douyin.com/123456789 live: max_duration_seconds: 3600 # 0 录到主播下播什么时候用重要直播场次产物在Downloaded/{作者}/live/FLV 可直接播放HLS 源需要 ffmpeg 后处理。完成通知不用守着装能做什么下载跑完后推送到手机成功失败都推。怎么配notifications: enabled: true providers: - type: bark # 也支持 telegram / webhook url: https://api.day.app/YOUR_KEY # 换成自己的推送地址什么时候用后台跑大批量合集收到推送就说明任务结束了。最容易卡住的四个问题只能拿到 20 条视频现象主页采集总是停在 20 条。原因翻页被风控API 分页被掐断。解决确认browser_fallback.enabled: true且headless: false弹出浏览器窗口后手动完成验证再让它继续。提示需要登录现象报「需要登录」类错误。原因Cookie 过期或账号在别处重新登录导致失效。解决重跑python -m tools.cookie_fetcher --config config.yml重新拿 Cookie。下载慢或失败多现象进度条挪得慢任务反复重试。原因并发过高或网络受限。解决把thread调到 3 再试必要时配置proxy: http://127.0.0.1:7890。想重新下载却被跳过现象重跑显示「跳过已存在」没有生成新文件。原因数据库记录 本地文件名双重去重同时在起作用。解决两处都要删——Downloaded/里对应作品的文件夹以及数据库里该作品的记录只删其中一处可能不生效。边界与礼仪个人使用下载内容仅用于个人存档、学习和研究不要商用或二次传播。控制请求频率默认 2 请求/秒、并发 5不建议调高并发去和平台对抗。保管好 Cookieconfig.yml里带登录态别分享给别人也别提交进任何仓库。如果不想碰终端基于同一套后端还有一个桌面客户端 Douzy粘贴链接就能开始下载整个工具就是一个配置文件加一条运行命令链接和 Cookie 给到位换回一个整理好的本地存档更多配置项和场景以仓库里的 README.zh-CN.md 为准。【免费下载链接】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），仅供参考