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-downloaderdouyin-downloader 是一个基于 Python 的抖音批量下载工具支持无水印视频、图文、合集、音乐原声的下载内置进度展示、失败重试、SQLite 去重和 Playwright 浏览器兜底。你既可以把它当作命令行工具接入自己的脚本也可以通过配套的 Douzy 桌面版完成日常下载。它适合谁先对号入座再决定要不要往下读如果你偶尔需要保存几个抖音视频README 里提到的 Douzy 桌面版粘贴链接、看进度、管理本地作品档案可能就够了本文重点放在命令行版上。如果你属于下面两类人这套 CLI 工具会更对你的胃口内容归档者定期备份某个博主主页的作品、合集或原声音乐需要断点续传和去重不想重复下载数据整理者要把下载结果按作者、日期组织成可检索的目录结构甚至导出 JSON 元数据、评论或转写文本并嵌进自己的自动化流程。需要提前知道的一点是抖音接口风控目前会阻止 CLI 下载单个视频、合集、音乐、喜欢和收藏主页作品可以靠 Playwright 浏览器兜底但不保证成功。仓库在 README 里对此有明确标注建议你先读一下 config.example.yml 顶部的说明再开始配置。从克隆到跑通最小启动路径整个过程四步装依赖、配置登录、改配置、运行。以下命令都假设你已装好 Python 3.9。先克隆仓库并安装依赖Playwright 的 Chromium 用于 Cookie 抓取和浏览器兜底git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader python -m pip install -r requirements.txt python -m pip install playwright python -m playwright install chromium然后复制配置模板启动交互式 Cookie 抓取——它会打开浏览器让你登录抖音回到终端按 Enter 保存cp config.example.yml config.yml python -m tools.cookie_fetcher --config config.yml打开 config.example.yml 对照修改把示例link换成目标博主主页保留已保存的 Cookie确认这几个关键字段link: - https://www.douyin.com/user/YOUR_SEC_UID path: ./Downloaded/ mode: [post] number: post: 10 # 0 表示不限数量 increase: post: true # 跳过已下载作品最后运行第一条下载命令python run.py -c config.yml跑完之后去./Downloaded/看一眼默认按「作者名/post/日期_标题_aweme_id/」组织目录视频、封面、JSON 都带统一前缀旁边还有一个逐行追加的download_manifest.jsonl清单。全部参数可以用python run.py --help查看常用的是-u追加链接、-t调并发、-v开详细日志。核心能力拆解三个值得了解的机制增量下载与磁盘去重它做了什么同一个博主重复跑任务时已下载过的作品直接跳过磁盘上的文件丢了还会自动补下。内部怎么实现每个下载模式有独立的increase.*开关判断依据是磁盘上的非空主媒体文件而不是数据库——PROJECT_SUMMARY.md 里写明 SQLite 只记录历史不参与跳过判断redownload_missing_files控制文件缺失时是否补下。你如何开启默认就是开着的increase.post: trueredownload_missing_files: true是推荐组合。需要覆盖重下时把increase.post设为false即可不需要清空数据库。多模式下载与下载器工厂它做了什么mode列表决定这次任务抓什么——post主页作品、like喜欢、mix合集、music原声音乐、collect收藏可以叠加各自的数量上限在number.*里独立设置。内部怎么实现core/ 下用工厂模式把 URL 类型映射到具体下载器core/downloader_factory.py用户主页再经注册发现机制分发到 core/user_modes/ 里的各模式策略新增一种模式不用改主流程。你如何开启在配置里把mode: [post, music]、number.music: 0不限这样组合起来即可。并发、限速与浏览器兜底它做了什么批量下载时保持稳定的吞吐失败自动重试API 翻页被截断时切换 Playwright 浏览器滚动页面补全作品列表。内部怎么实现control/ 提供三个协作组件——令牌桶限速器、指数退避重试器、异步队列工作池由thread、retry_times两个配置项驱动。浏览器兜底行为由browser_fallback段控制max_scrolls决定最多滚动多少屏。你如何开启默认thread: 5、retry_times: 3、browser_fallback.enabled: true。主页作品只抓到少量时保持headless: false在弹出的浏览器里手动完成验证。运行流程文字版 读配置 → 初始化 Cookie 与 API 客户端 → 解析链接类型 → 拉取作品列表时间/数量/类型筛选 → 并发下载媒体文件限速 重试 → 写 JSON 元数据 / manifest 清单 / SQLite 历史顺带一提画质有专门开关video_qualityhighest默认最高转码档、original探测上传原片失败自动回退、lowest或指定分辨率如1080p匹配不到会自动降级。拿来就能用的场景三段照抄的配置场景一只归档某博主最近一个月的视频带上封面和元数据。加日期范围和产物开关start_time: 2026-09-08 end_time: 2026-10-08 video: true cover: true json: true number: post: 0场景二只留音乐原声做本地音频素材库。把视频关掉、音乐打开video: false music: true音乐模式下每个作品的原声会作为独立音频保存如果后续还要语音转写config.example.yml 里的transcript段可以接 OpenAI 兼容接口音频抽取本身走内置 ffmpeg 静态二进制见 core/audio_extraction.py。场景三长期任务跑在服务器上失败有通知。用仓库自带的 Dockerfile 构建镜像它默认把/app/Downloaded挂为数据卷、python run.py -c config.yml作为入口同时在配置里打开notifications.enabled并配 bark / telegram / webhook 任一渠道批量任务完成或失败时会推送到手机。常见坑与 FAQCookie 失效了怎么办重新跑一遍python -m tools.cookie_fetcher --config config.yml在弹出的浏览器里登录保存即可。不要指望反复重试来绕过风控。主页只抓到少量作品是不是坏了大概率是接口翻页被风控截断。保持browser_fallback.enabled: true和headless: false在浏览器窗口里手动完成验证后回到终端继续。README 明确提示这不保证成功属于当前风控下的已知限制。想覆盖重下但又不想清库怎么做只把对应模式的increase.post改成false文件会被重新下载并覆盖当前筛选范围内的内容数据库保留原样。下载的文件命名混乱文件名和目录名由filename_template/folder_template控制可用变量包括{id}、{title}、{author}、{date}等模板里必须保留{id}防止重名覆盖作者目录层还有author_dir三种命名策略可选。日志看不出问题在哪加-v参数跑详细日志python run.py -c config.yml -v。项目现状与参与方式这个项目处于持续活跃状态核心下载链路、增量去重、浏览器兜底都有对应的 tests/ 测试模块覆盖架构脉络可以直接读 PROJECT_SUMMARY.md 和 AGENTS.md。想参与贡献的话本地先跑python -m pip install -e .[dev]然后python -m pytest tests/加ruff check .保持测试和检查全绿再提 PR。项目采用 MIT 许可证也声明了仅用于学习和个人数据管理的使用边界归档前留意版权和平台规则。【免费下载链接】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），仅供参考