抖音批量下载如何从零跑通？douyin-downloader 完整上手指南

抖音批量下载如何从零跑通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 是一个支持视频、图集、合集、音乐与作者主页的抖音批量下载工具核心能力是自动挑选无水印源、并发下载、失败重试与 SQLite 去重。本文解决的核心问题如何在一台干净机器上从克隆仓库走到批量无水印下载成功落盘并覆盖只抓到 20 条、Cookie 失效等常见卡点。上图是桌面版 Douzy 的链接下载工作台它与本仓库共用同一套 Python 后端命令行版的操作逻辑与之完全一致。前置检查确认 Python 环境与可选组件在仓库根目录确认 Python 版本python --version预期输出Python 3.8或更高。支持 macOS / Linux / Windows。以下组件仅在需要时安装浏览器兜底翻页受限时弹出浏览器人工过验证码与自动获取 Cookie 依赖 Playwright本文第三步会用到--serveREST 服务模式需要fastapi uvicorn。核心操作四步完成首次下载第一步克隆仓库并安装依赖git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt安装成功后终端无报错即可requirements.txt已包含 aiohttp、rich、pyyaml 等全部运行依赖。第二步基于示例生成 config.ymlcp config.example.yml config.ymlconfig.example.yml 包含全部配置项首次运行只需关注link下载链接、mode下载模式、cookies登录态三处其余项并发、画质、增量下载等保持默认即可。第三步获取登录 Cookiepip install playwright python -m playwright install chromium python -m tools.cookie_fetcher --config config.yml命令会弹出浏览器在其中登录抖音后回到终端按 EnterCookiemsToken、ttwid、odin_tt等自动写入config.yml的cookies段。判断标准终端不再等待输入且config.yml中cookies不再是YOUR_*占位值。第四步跑通第一个链接编辑config.yml把link改成一个视频地址然后运行python run.py -c config.yml预期输出依次为Database initialized数据库初始化、解析与下载进度最后出现总结行 Overall Summary 成功 1 / 失败 0 / 跳过 0在Downloaded/下出现对应.mp4文件即代表链路已跑通。按场景改配置从单条到主页批量下载单条视频、图文、合集或音乐link只写一条 URLmode可省略link: - https://www.douyin.com/video/7604129988555574538同样适用于/note/{note_id}图文、/collection/{mix_id}合集、/music/{music_id}音乐短链https://v.douyin.com/...会自动解析。批量下载作者主页作品把link换成主页地址并配置mode与numberlink: - https://www.douyin.com/user/MS4wLjABAAAAxxxx mode: - post number: post: 50number为 0 表示全量下载示例配置默认post: 1跑通后再按需调大。文件自动保存为无水印最高转码档video_quality: original可切换为原画探测模式。多模式合并下载mode: - post - like - mix - music跨模式自动去重同一个 aweme_id 在不同模式下不会重复下载。collect/collectmix当前登录账号收藏夹与收藏合集必须单独使用不能与post/like/mix/music混用。控制时间范围与增量下载start_time: 2026-01-01 # 格式 YYYY-MM-DD end_time: increase: post: trueincrease.post: true时磁盘上已存在主文件的作品会被跳过只补新作品设为false会重新下载并覆盖当前筛选范围内的文件。命令行直跑不修改配置文件一次性任务可全部通过参数传入追加到配置文件之后python run.py -c config.yml \ -u https://www.douyin.com/video/7604129988555574538 \ -t 8 \ -p ./Downloaded参数说明-u, --url追加下载链接可重复传入-c, --config指定配置文件默认config.yml-p, --path指定下载目录-t, --thread指定并发数默认 5-v, --verbose显示 info/warning/error 日志--version显示版本号按现象排查批量下载常见的三个卡点主页作品只抓到约 20 条这是翻页风控的常见现象。确保以下两项为true/false组合并在浏览器弹窗出现后手动完成验证、不要立即关闭窗口browser_fallback: enabled: true headless: false浏览器兜底目前仅针对post模式完整验证like/mix/music依赖 API 正常分页见 README.zh-CN.md 的限制说明。Cookie 失效重新获取任务中提示登录态失效时重新执行第三步的python -m tools.cookie_fetcher --config config.yml即可无需改代码。进度输出刷屏默认progress.quiet_logs: true会静默进度阶段的日志调试时再临时加--show-warnings或-v查看详细信息。查看下载历史sqlite3 dy_downloader.db SELECT aweme_id, title, author_name, datetime(download_time, unixepoch, localtime) FROM aweme ORDER BY download_time DESC LIMIT 20;预期输出为最近 20 条作品记录含标题、作者与本地时间。强制重新下载某作品程序通过数据库记录 本地文件双重检查决定是否跳过只删其中一样都不够rm -rf Downloaded/作者名/post/*_aweme_id/ sqlite3 dy_downloader.db DELETE FROM aweme WHERE aweme_id aweme_id;⚠️ 只删数据库保留文件不会触发重下只删文件保留数据库则会触发重下数据库有记录但本地缺文件视为需要重试。收尾验证确认下载结果并记住操作链路按顺序确认三处Downloaded/{作者名}/post/{日期}_{标题}_{aweme_id}/下存在非空.mp4终端总结行中跳过计数符合预期增量模式第二次运行应全部跳过Downloaded/download_manifest.jsonl追加了本次下载记录。全部通过后核心链路可以一句话复述装依赖 → 写 config.yml 的 link 与 Cookie →python run.py下载 → 在Downloaded/与数据库里验证。【免费下载链接】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），仅供参考