Douzy 上手指南抖音作品批量下载与本地归档【免费下载链接】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 的桌面版 Douzy 就是面向这类场景的视频、图文、合集、音乐均支持无水印下载可整站抓取作者主页本地按作者与日期归档配合 SQLite 数据库去重进度与任务状态可实时跟踪。它是一套 Python 项目以 CLI 为先、YAML 配置驱动适合个人收藏、研究素材备份以及小团队管理内容资产。 安装、登录并跑通首次下载环境要求 Python 3.8跨 macOS、Linux、Windows。拿到项目源码后把装依赖、建配置、取 Cookie、启动压成一条流程内置的 Cookie 工具会拉起浏览器按提示登录抖音后回到终端回车程序自动把认证信息写进配置文件随后即可运行入口脚本。pip install -r requirements.txt cp config.example.yml config.yml python -m tools.cookie_fetcher --config config.yml python run.py -c config.yml认证信息只保存在本地不上传到任何服务器。启动后有两条常用路径一是用配置文件批量跑二是给单次任务追加命令行参数覆盖默认值例如-u追加链接、-t调并发、-p改输出目录。若后续要启用浏览器兜底或自动取 Cookie再补装playwright并下载 chromium 浏览器。Douzy 链接下载工作台粘贴视频、图文、主页或合集链接即可开始 批量下载作者主页作品并规范目录最高频的需求是把某位作者主页的作品整批收下来。在link填入主页链接mode选post用number.post控制数量填 0 表示全量。link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx mode: - post number: post: 50默认folderstyle: true每个作品会单独建一个子目录视频、封面、音乐与 JSON 元数据落在同一处目录根部还会生成一份download_manifest.jsonl汇总清单。Downloaded/ └── 创作者A/ └── 2024-06-15_作品标题_id/ ├── video.mp4 ├── cover.jpg └── data.json命名相关有几个值得留意的开关filename_template决定文件名可用变量含{id}、{title}、{author}、{date}等模板里务必保留{id}以防重名互相覆盖author_dir可设为nickname_uid用“昵称_sec_uid”作作者目录避免重名作者被合并、改名后又分裂成两个目录video_quality控制画质可选original探测原片、highest取最高转码档、lowest省流量或直接指定1080p这类分辨率匹配不到时自动降级。同一aweme_id即便在多个模式下出现也只会被下载一次。Douzy 关注管理界面按新作品筛选博主、添加备注并触发批量下载 启用增量下载并跳过已知作品要做持续更新的内容库核心是定期运行时跳过已下载的作品。把increase对应模式设为true依赖database: true程序会先查数据库、再比对本地文件名双重确认后才判断是否跳过。redownload_missing_files控制磁盘文件缺失时的行为为true时文件丢失会补下为false时只要数据库有记录就跳过。increase: post: true comments: enabled: true include_replies: true把评论采集一并打开产出更完整comments.enabled: true会为每个作品额外生成*_comments.jsoninclude_replies: true会连二级回复一起抓取请求量更大max_comments可为每个作品设上限。两者叠加后新增作品自动入库并附带评论形成可持续累积的素材库若某个作品只想重下需同时删掉本地文件与数据库记录只删其一不会触发。Douzy 收藏与喜欢界面同步账号内容并按合集批量下载 启用浏览器兜底以突破翻页限制批量抓取最常见的卡点是翻页风控典型症状是只取到 20 条作品。Douyin Downloader 的应对是浏览器兜底当 API 翻页被拒时自动切到浏览器模拟滚动读取页面自身发出的作品列表请求继续翻页。browser_fallback: enabled: true headless: false保持headless: false会显示浏览器窗口弹出验证时人工完成、不要立即关窗max_scrolls限定最大滚动次数idle_rounds控制判定无新内容的空闲轮次wait_timeout_seconds是整体超时上限。兜底生效后任务中心会汇总各任务状态、成功与失败条数失败项可单独重试而不必整批重来。Douzy 任务中心查看任务状态、成功失败统计与重试入口 启用语音转写与完成通知需要深度分析视频内容的场景可开启转写transcript.enabled: truemodel: gpt-4o-mini-transcriberesponse_formats填txt与jsonapi_key_env: OPENAI_API_KEY从环境变量读取密钥。视频旁会生成.transcript.txt和.transcript.json启用数据库时还会在transcript_job表里记录成功、失败或跳过状态。注意转写只对视频作品生效图文不会产出。跑长时间任务时建议配上完成通知notifications.enabled: trueproviders可同时列bark、telegram、webhook三类它们会并发推送单个通道失败不会阻塞主下载任务结束即把结果推送到手机省得守在终端前。 配置项与下载模式速查下载模式可组合使用其中collect、collectmix仅对当前已登录账号生效且必须单独使用不能与其余模式混用模式用途post作者发布的主页作品like作者点赞过的作品mix合集内容music音乐原声collect当前账号收藏夹单独用collectmix当前账号收藏合集单独用高频配置项一览配置项说明thread并发下载数默认 5不稳时调低retry_times失败重试次数默认 3指数退避start_time / end_time时间过滤格式 YYYY-MM-DDdatabase启用 SQLite 去重与下载历史database_path数据库文件路径默认 dy_downloader.dbproxyAPI 与媒体下载的 HTTP/HTTPS 代理download_pinned是否包含主页置顶作品progress.quiet_logs进度阶段静默日志减少刷屏 排障下载失败与速度问题常见现象与对应处理只能取到 20 条— 属翻页风控开browser_fallback.enabled: true、保持headless: false弹窗后手动过验证。速度慢或不稳— 调低thread并发、启用proxy、提高retry_times。Cookie 失效— 重跑python -m tools.cookie_fetcher --config config.yml。没生成转写文件— 依次确认transcript.enabled为true、对象是视频而非图文、密钥有效、response_formats含txt或json。想重下某作品— 删掉含 aweme_id 的本地文件并删除数据库对应记录只删数据库不生效因为程序还扫描文件名去重。进度条刷屏— 置progress.quiet_logs: true。上手路径建议先下单个视频确认 Cookie 有效再试作者主页十几二十条最后叠加增量、评论、转写等选项。若要长期跑可交给系统定时任务用increase只补新增。本工具仅限个人学习、研究与数据备份内容版权均归创作者本人勿用于商业目的或侵害他人权益由此产生的风险由使用者自行承担。【免费下载链接】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），仅供参考