10 分钟跑通抖音批量下载无水印保存、增量追更与风控兜底全解【免费下载链接】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 是一款抖音批量下载工具无水印保存视频支持按主页、点赞、合集、音乐、收藏夹抓取可附带封面、原声、元数据、评论与语音转写。适合需要整理某位创作者内容或备份自己收藏夹的用户从克隆代码到跑通一次试下载约 10 分钟。快速上手一条最短路径跑通下载前置要求只有一条Python 3.8。整条链路是克隆 → 装依赖 → 配 Cookie → 跑下载按下面顺序执行即可git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt pip install playwright python -m playwright install chromium cp config.example.yml config.yml倒数第二行装的是 Cookie 自动获取和浏览器兜底所需的 Chromium最后一行生成实际使用的config.yml。接下来获取 Cookiepython -m tools.cookie_fetcher --config config.yml浏览器会弹出抖音登录页登录完成后回到终端按 EnterCookie 由脚本自动写入配置文件不需要你手动找字段。最后启动下载python run.py -c config.yml终端显示进度条任务结束后文件落在Downloaded/目录。不想敲命令的话桌面版 Douzy 与 CLI 共用同一套后端在界面里粘贴链接即可开始下载还能同步关注与收藏、在任务中心跟踪每个任务的状态。config.yml 怎么改四个功能域整份配置按功能域拆成四块拉取范围、文件落地形态、附加数据、兜底与通知。只改你关心的字段其余保持默认。拉取范围mode 与 numberlink→ 默认是模板里的示例主页 → 换成你的目标主页链接一行一个。mode决定拉什么、number下对应字段决定拉多少0 表示全量模式内容数量字段post用户发布的作品number.postlike用户点赞的作品number.likemix合集内作品number.mixmusic音乐原声number.musiccollect当前 Cookie 账号的收藏夹number.collectmode支持逐行写多个值同时拉取相同 ID 的作品跨模式自动去重collect必须单独使用link 需指向https://www.douyin.com/user/self?showTabfavorite_collection。start_time/end_time→ 默认空 → 填YYYY-MM-DD后只拉该日期区间内的作品。文件落地形态目录树与命名模板folderstyle→ 默认 true → 保持开启时按作者 / 模式 / 作品三层归档Downloaded/ └── 作者昵称/ └── post/ └── 2024-06-15_舞蹈教学_7604129988555574538/ ├── 7604129988555574538.mp4 ├── 7604129988555574538_cover.jpg ├── 7604129988555574538_music.mp3 └── 7604129988555574538_data.json默认只生成视频本体后三个文件分别由cover、music、json开关控制打开才生成json存的是该作品的元数据。filename_template→ 默认{date}_{title}_{id}→ 决定作品文件夹名可选变量有{id}、{title}、{author}、{author_id}、{date}、{time}、{type}、{mode}等。{id}建议永远保留它是防不同作品重名覆盖的保险丝去掉它两个同标题作品会互相覆盖。作者目录想更稳把author_dir从nickname改为nickname_uid目录名变成昵称_sec_uid重名账号不会合并、改名账号不会分裂。完整目录与字段说明见 README.zh-CN.md。附加数据评论与转写comments.enabled→ 默认 false → 改为 true 后每个作品多生成一份*_comments.jsonmax_comments限制条数0 表示不限。transcript.enabled→ 默认 false → 开启后对视频作品做语音转写依赖 OpenAI 密钥export OPENAI_API_KEYsk-xxxx完成后作品目录内多出一份.transcript.txt与.transcript.json图文作品不生成转写文件。兜底与通知是另外两个功能域写法上都是一个总开关 细节项。browser_fallback.enabled→ 默认 true → 保持开启后API 翻页被风控拦截时会切到浏览器继续拉取把headless设为 false 时验证以弹窗形式出现手动完成认证且不要立即关闭浏览器。该机制目前只完整验证过post模式。notifications.enabled→ 默认 false → 改为 true 后按providers配置推送type支持 webhook企业微信/飞书/钉钉机器人、bark、telegramon_failure控制失败时是否也发各 provider 并发推送单个失败不阻塞主下载。按目标选玩法四种典型场景各配一小节照抄对应字段即可。只追新作品目标每次运行只补上新发布的作品。increase: post: true database: trueincrease.post模板里默认已开每次运行跳过数据库已记录且磁盘已有文件的旧作品只下新增内容database必须保持 true。改为 false 则会在当前数量与时间筛选范围内重新下载并覆盖旧文件。归档评论与语音文本目标把每个作品的评论和口播文字一起留下来。comments: enabled: true max_comments: 500 transcript: enabled: true response_formats: [txt, json]效果视频作品目录内多出一份转写 txt 与 json外加一份评论 json图文作品只有评论、没有转写。转写前记得先导出OPENAI_API_KEY环境变量。翻页被风控后怎么续拉目标只拉到约 20 条就被拦时换浏览器接着翻。browser_fallback: enabled: true headless: false效果翻页受阻自动切到浏览器弹窗出现验证时手动完成认证期间不要关窗。目前仅post模式完整验证过。下载完成要提醒目标批量任务跑完或失败时主动收到消息。notifications: enabled: true on_failure: true providers: - type: webhook url: 你的webhook地址效果任务结束即推送providers 里可并列 webhook、bark、telegram各通道并发发出单通道失败不影响主流程。出问题先查这五处先对照下面五条绝大多数下载不动都能定位。速度慢或频繁中断 → 多为网络波动或并发过高 → 把thread降到 3并在proxy里配置代理。只拉到约 20 条就停 → 翻页触发风控 → 确认browser_fallback.enabled: true且headless: false在弹窗中手动完成验证。下载失败或提示未登录类错误 → Cookie 失效 → 重新执行python -m tools.cookie_fetcher --config config.yml。新旧作品重名或互相覆盖 → 命名模板漏了{id}→ 把filename_template改回{date}_{title}_{id}。全量拉取时磁盘占满 → 数量不限量且画质偏高 → 用number.post限制数量或start_time/end_time做时间过滤再调低video_quality。最后说清边界这个工具只适合个人学习、研究与数据备份。下载内容涉及创作者版权再次分发或商业用途必须先取得授权下载行为同样要遵守抖音平台的服务协议与风控规则。若平台策略调整导致部分接口失效属于正常技术风险重新获取 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），仅供参考
