douyin-downloader 上手指南从配置 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-downloaderdouyin-downloader 是一个抖音批量下载工具支持视频、图文、合集、音乐等类型的去水印下载自带进度显示、失败重试、SQLite 去重和浏览器兜底。这篇上手教程面向第一次接触它的读者从安装、登录到发起第一个批量任务只保留必要的命令和配置。跟完一遍你会在本地得到按作者归档、带元数据的作品目录。先分清它现在能做什么边界在哪里适合谁用想把某个创作者主页的作品、合集或音乐整体保存下来的人需要按时间范围筛作品、连同评论一起留档做分析的人希望重复运行任务时不重复下载的人。它能做的事粘贴主页链接后按mode拉取作品列表并发下载无水印视频并自动挑选最高码率可同时保存封面、音乐、JSON 元数据和评论配合increase增量开关和数据库记录第二次运行只补新作品。此外还可选评论采集、视频转写、直播录制实验性、热搜榜与关键词搜索导出。一个必须知道的边界抖音在 2026 年 8-9 月逐步收紧了接口风控。CLI 直连 API 的单个作品、合集、音乐、点赞和收藏夹下载已被拦截主页作品post的 API 翻页同样被拒只能靠浏览器兜底playwright尝试读取页面数据。桌面版 Douzy 通过内置登录窗口代发请求不受该限制影响目前处于内测期需到项目的 Releases 页面下载安装文件。当前仍可直接调用的接口包括用户资料、关注列表、评论、直播、热搜榜和搜索。因此建议批量保存主页作品、点赞或收藏类内容优先用桌面版 Douzy走命令行路线的环境要先装好 playwright并保持浏览器兜底开启。Douzy 的左侧栏分两组下载管理包含链接下载、多链接队列、任务中心与作品档案账号内容包含关注、收藏与喜欢登录后可以同步这些数据并直接发起下载。如何完成第一次批量下载最小可用路径第一步获取代码git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader第二步安装依赖需要 Python 3.8 或更高版本pip install -r requirements.txt第三步安装浏览器引擎。浏览器兜底和自动获取 Cookie 都依赖它pip install playwright python -m playwright install chromium第四步从 配置模板 复制一份你自己的配置cp config.example.yml config.yml第五步获取 Cookie。运行 tools/ 下的抓取脚本python -m tools.cookie_fetcher --config config.yml按浏览器提示登录抖音回到终端按 Enter程序会把 Cookie 写进config.yml。成功的标志是文件里cookies:字段的占位符已变成真实值。第六步编辑config.yml只改这几行即可发起第一个任务link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx mode: - post number: post: 10 path: ./Downloaded/number.post控制本次下载数量填 10 足够验证流程0 表示不限。第一次运行不建议直接写 0主页可能有上千条作品全量运行耗时长且更容易触发风控。第七步启动任务python run.py -c config.yml成功的标志终端出现 Rich 进度条Downloaded/作者名/post/下生成若干按日期_标题_作品ID命名的子文件夹每个里面有 .mp4 和附带文件工作目录同时生成dy_downloader.db去重数据库。用桌面版的话任务中心可以直接查看今日成功与失败数、按状态筛选任务并对失败项单独重试。产出的目录长什么样默认folderstyle: true且命名模板为{date}_{title}_{id}时结构如下Downloaded/ ├── download_manifest.jsonl # 下载清单 ├── dy_downloader.db # 去重与历史数据库 └── 作者名/ └── post/ └── 2024-02-07_作品标题_作品ID/ ├── xxx.mp4 # 无水印视频 ├── xxx_cover.jpg # 封面 └── xxx_data.json # 作品元数据三点值得留意每个作品单独建文件夹命名模板必须包含{id}否则同名作品会互相覆盖。再次运行同一链接时数据库有记录且本地文件存在的作品会被跳过文件缺失则会重新补下。download_manifest.jsonl记录每条作品的结果任务失败后先查它。按你的目标找批量下载配置如果你用桌面版关注、收藏、喜欢这类账号任务不需要在配置里填链接左侧栏「账号内容」区域有对应入口可筛选出新作品后直接下载。命令行路线则对照下面的表把目标和配置一一对应你的目标要确认的配置完成标志批量保存某创作者主页作品link填主页链接mode: [post]number.post定数量Downloaded/作者名/post/下出现作品子文件夹重复运行只补新作品increase.post: true且database: true第二次运行跳过已下载项日志只出现新增作品只保存某段时间的作品start_time/end_time格式 YYYY-MM-DD输出目录里没有区间外的作品作品连同评论一起留档comments.enabled: true用max_comments限流视频旁生成*_comments.json省流量或存原画video_quality改为720p、lowest或original下载的 .mp4 码率与所选档位一致最常修改的 5 个配置项mode决定取什么内容post作品、like点赞、mix合集、music音乐。收藏夹模式collect/collectmix必须单独使用且只作用于当前登录账号。number.*各模式的数量上限0 为不限。新手从小数值起步确认稳定后再放大。increase.*增量开关依赖数据库记录。开启后同一份配置反复运行只补新作品适合定期抓取。start_time/end_time时间过滤格式 YYYY-MM-DD用来限定分析范围或控制磁盘占用。browser_fallback翻页被风控时启动浏览器读取页面数据。保持enabled: true、headless: false浏览器窗口弹出后手动完成验证不要立即关闭。批量下载任务卡住时先看这 4 项现象只能抓到约 20 条作品。原因翻页触发风控。处理确认browser_fallback.enabled: true且headless: false浏览器窗口出现后手动完成验证再等它继续翻页。现象任务中途报 403 或列表为空。原因多为 Cookie 失效。处理重新执行python -m tools.cookie_fetcher --config config.yml再登录一次。现象想重新下载某作品程序却跳过了。原因程序按「数据库记录 本地文件」双重判断。处理删除该作品的子文件夹并删除数据库中对应记录只删文件、保留数据库记录同样会触发重新下载。现象没有生成转写文件。原因转写只对视频作品生效图文不会生成。处理依次检查transcript.enabled是否为true、OPENAI_API_KEY是否有效、response_formats是否包含txt或json。下一步建议先用number.post: 10跑通一个小任务确认目录结构和去重行为再改成增量长期运行。想跟踪关注列表的新作品可以体验桌面版 Douzy 的关注同步与筛选。大批量运行前用thread控制并发用时间过滤限定范围把请求量保持在可控水平。本工具仅用于学习、研究、个人备份或合理授权范围内使用请尊重平台规则与创作者权益勿用于侵权或商业传播。【免费下载链接】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），仅供参考