
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 开发会开终端就够。先跑通一条命令下完第一条作品跑通后的样子是这样的终端里进度条走完Downloaded/目录下出现作者名/post/日期_标题_作品ID/子目录里面的 mp4 就是无水印原片而不是 App 里保存的带水印版本。在跑到这一步之前需要完成 4 个前置动作拿到项目并安装依赖要求 Python 3.8 以上macOS / Linux / Windows 均可git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt复制一份配置模板这是后面所有命令读取的唯一输入文件cp config.example.yml config.yml安装浏览器自动化依赖Playwright一个控制真实浏览器的库自动获取 Cookiepip install playwright python -m playwright install chromium python -m tools.cookie_fetcher --config config.yml这一步会自动弹出抖音网页你扫码登录后回到终端按 EnterCookie网页版登录凭证工具靠它读取作品数据就写进 config.yml 了。手动从浏览器复制 Cookie 容易漏字段不推荐。首次运行python run.py -c config.yml示例配置里number.post是 1所以第一次只下 1 条作品专门用来验证环境是否配好。这条命令背后做了什么刚才那条命令做的事可以拆成三段读配置、拉列表、落盘。读配置。config.example.yml 里每一项都有注释核心的是link抖音链接示例里是一个作者主页、mode下载模式示例为post即作者作品、number每种模式的下载条数上限、cookies登录凭证。加载逻辑在 config/config_loader.py缺省的项会取默认值你不必一次看懂全部字段。拉列表。工具按发布时间倒序翻作者的作品列表number.post: 1就只取第 1 条0表示不限条数。每条视频自动选用无水印源并根据video_quality默认highest从多档码率里挑合适画质。落盘。文件按「作者名 / 模式 / 作品」三级目录整理默认落在path指定的./Downloaded/下同时 SQLite一个本地数据库文件这里就是dy_downloader.db会记下已下载的作品。数据库记录和磁盘文件双重核对是后面「增量下载」不重复下载的基础。全量存档一个创作者的作品默认配置只下 1 条全量存档要改三处link换成目标作者主页number.post改成 0不限条数按需打开封面、原声、元数据开关。作品按发布时间倒序拉取开关打开后对应文件会和 mp4 一起保存在作品子目录里。link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx path: ./Downloaded/ mode: - post number: post: 0 # 0 表示不限条数 video: true cover: true music: true json: true video_quality: highest # 可选 original / highest / lowest / 指定分辨率注意作者作品量大时建议先把number.post设成具体数字比如 100验证流程确认目录和画质没问题再放开为 0。每周只补新作品增量下载创作者持续更新时你想每周跑一次同一份配置只拿新增作品已有的不再下一遍。打开数据库和增量开关即可其余配置保持不动。database: true database_path: dy_downloader.db increase: post: true原理每次运行前工具先查dy_downloader.db里有没有这条作品的记录再核对磁盘上主文件是否还在两者都确认才跳过。所以判断以本地媒体文件存在为准——你删掉文件下次会重新下载只删数据库记录则不会触发重下。只下载某个月份的作品只想留上个月发布的作品时不用爬完整主页填两个日期边界工具翻到早于start_time的作品后会提前停下省掉大量翻页。start_time: 2026-08-01 end_time: 2026-08-31注意日期格式固定为YYYY-MM-DDend_time包含当天整天不需要写下一天。把下载能力接进自己的工作流视频内容转成文字想让每条视频附带文字稿开启转写功能。它会调用 OpenAI 的音频转写接口对每条视频作品在同目录生成.transcript.txt和.transcript.json两个文件图文作品不会转写。transcript: enabled: true api_key_env: OPENAI_API_KEY密钥通过环境变量提供例如export OPENAI_API_KEYsk-xxxx。以 REST API 形式被别的系统调用想把自己的系统接到这套下载能力上可以把工具起成 REST API一种用 HTTP 接口暴露服务的方式先装依赖再启动服务。pip install fastapi uvicorn python run.py --serve --serve-port 8000启动后其他程序向POST /api/v1/download提交{url: ...}拿任务 ID再向GET /api/v1/jobs/{job_id}查询状态接口清单见 README.zh-CN.md。配置速查字段作用默认值何时需要改link抖音作品或作者主页链接示例作者主页每个新目标都要换mode下载模式post/like/mix/music 等[post]下载点赞、合集、音乐时切换number.postpost 模式下载条数上限示例配置为 1全量存档改 0不限path输出目录./Downloaded/想换保存位置时cover/music/json是否附带保存封面 / 原声 / 元数据均false想留额外产物时video_quality画质档位选择highest要原画或省流量时start_time/end_time发布时间过滤不限只下某时间段作品时database启用 SQLite 去重与历史记录true增量下载必须保持开启database_path数据库文件路径dy_downloader.db想隔离不同任务历史时increase.postpost 模式增量开关true周期性只补新作品时thread并发下载数5大批量嫌慢时调高proxyAPI 请求与下载的 HTTP 代理网络不稳时配置transcript.enabled视频转写开关false要生成文字稿时transcript.api_key_env密钥所在的环境变量名OPENAI_API_KEY使用其他密钥来源时browser_fallback.enabled翻页受限时启用浏览器兜底true抓不全时保持开启browser_fallback.headless兜底浏览器是否隐藏窗口false需要手动过验证时保持 falsecookies网页版登录凭证占位符过期失效时重新获取排错附录现象批量下载只抓到 20 条左右就停没有明确报错。原因抖音对作品列表翻页有风控限制接口策略会随平台调整以 README 的限制说明 为准。处理确认浏览器兜底打开弹窗出现后手动完成验证再关browser_fallback: enabled: true headless: false现象之前能跑现在报 403 或提示未登录。原因Cookie 有有效期一般只有几天到几周。处理重跑自动获取重新扫码登录一次python -m tools.cookie_fetcher --config config.yml现象大批量下载速度慢进度推进很慢。原因默认并发 5、速率限制偏保守稳定性优先于速度。处理调高并发不建议超过 8网络不稳时加代理thread: 8 proxy: http://127.0.0.1:7890文件在哪、下一步做什么跑完之后所有产物默认在Downloaded/里三级目录按作者、模式、作品整理dy_downloader.db记录下载历史download_manifest.jsonl是一份清单快照。下一步把 config.yml 里的示例链接换成目标作者主页直接运行python run.py -c config.yml。命令行版面向抖音国内站不想碰命令行可以关注内测中的桌面版 Douzy粘贴链接即可开始批量下载还支持 TikTok 和 YouTube。任务中心里能查到每个批量下载任务的成功与失败条数失败项可直接重试。仅供个人学习与备份不用于商业用途。【免费下载链接】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),仅供参考