抖音批量下载器 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-downloader你手上有一个博主的主页链接想把对方几年发的几百条作品存到本地。逐条手动另存不现实主页也没有全部保存按钮作品一旦删库或设密就更没了。douyin-downloader 就是干这件事的抖音批量下载工具贴进主页链接它自动翻页把作品、封面、背景音乐拉回本地整个过程只在你电脑里发生。先分清 douyin-downloader 能帮你做什么这个仓库里有两条产品线命令行 CLI本文主角和 Douzy 桌面应用。CLI 只支持抖音覆盖批量下载、日期过滤、重试、下载历史和可选的评论采集。以下三个场景基本覆盖了日常全部用法。整站备份一个博主。你在运营一个内容档案某位创作者的作品对你有价值。把主页链接填进配置的link字段工具会翻页拉取全部作品默认按作者 / 模式 / 作品三级目录落盘文件夹名自带作品 ID同名作品不会互相覆盖。一次跑完几十到几百条你只需要等。追踪新发布的内容。你长期关注几个博主不想每次手动刷主页。打开增量开关increase.post: true再运行时工具会对照本地 SQLite 数据库跳过已下载的作品只补拉新发布的。内容库随时间自己生长。在本地翻旧账。每条作品可选保存一份 JSON 元数据配置里json: true作者、发布时间、标题、标签都是结构化字段下载历史同时写进dy_downloader.db。想知道我到底存过哪些作品一条 SQL 查询就够不用翻文件夹。装好依赖拿到登录态跑通第一次下载全程 5 步顺利的话二十分钟内结束。装好依赖要求 Python 3.9 以上。克隆仓库并安装这一步大概两分钟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最后两条是装 Playwright 和它的 Chromium 浏览器登录态抓取和浏览器兜底都靠它。装完requirements.txt里的 9 个依赖加 Playwright 即可运行。拿到登录态抖音多数接口要 Cookie这是新手最容易卡住的一步。仓库自带抓取脚本 tools/cookie_fetcher.pycp config.example.yml config.yml python -m tools.cookie_fetcher --config config.yml终端会弹出浏览器你在里面扫码或输密码登录一次回到终端按 EnterCookie 就写进 config.yml 了。Cookie 只存本地不会上传。已经手上有浏览器 Cookie 的可以直接把整串粘进配置不用走这一步。写一份最小配置复制出来的config.yml里把示例链接换成你的目标博主最简可用版本link: - https://www.douyin.com/user/YOUR_SEC_UID path: ./Downloaded/ mode: [post] number: post: 5 increase: post: truenumber.post先设 5 试跑确认目录结构和文件都正常再改成00 表示不限数量。完整字段说明在 config.example.yml每行都带中文注释。跑第一次批量任务python run.py -c config.yml入口脚本是 run.py。终端实时滚动每条作品的进度结束时汇总成功、失败、跳过计数和总耗时。想看详细日志加-v。检查保存结果打开Downloaded/文件按作者 / post / 作品三层组织每个作品一个独立文件夹默认命名{日期}_{标题}_{作品ID}ID 保证同名作品互不覆盖。首次只下载了视频本体封面、音乐、JSON 元数据都是默认关闭的开关需要时在配置里打开。日常只需要改这些配置项配置字段很多真正会碰的就这几项字段作用建议值link目标链接支持主页、单条作品、合集可填多个填主页做整站备份path本地保存目录不存在会自动创建指向专门的备份盘mode主页链接拉取的内容类型post 作品 / like 喜欢 / mix 合集默认[post]number.post每个主页最多下载多少条先 2~5 试跑确认无误再改 0increase.post增量开关跳过已下载作品长期备份设truestart_time/end_time按发布时间过滤格式YYYY-MM-DD限定范围省磁盘thread并发线程数默认 5网络稳可提到 8retry_times单条失败自动重试次数3网络差可调高出故障时先对照这五种报错看到大面积失败或提示登录无效→ 原因Cookie 过期或缺失。处理重跑一次python -m tools.cookie_fetcher --config config.yml即可不要手改已有字段的拼写。看到作品数量明显少于主页→ 原因number.post没放开或start_time/end_time截断了内容。处理确认number.post是 0检查时间范围仍不全时保留browser_fallback.enabled: true且headless: false用 Playwright 浏览器兜底翻页。看到同标题作品只剩一个文件夹→ 原因自定义命名模板里删掉了{id}两条同名作品写到同一处。处理保持默认模板{date}_{title}_{id}folderstyle维持true让工具自动带 ID 区分。看到下载中途断网、部分失败部分成功→ 原因网络波动不是任务坏了。处理直接重跑即可已存在的文件会跳过调高retry_times能减少这类中断。看到全部任务失败并提示请求校验→ 原因抖音对接口加了请求校验刷新 Cookie 解决不了。处理确认已装 Playwright 和 Chromium保留浏览器兜底开关在弹出的浏览器里手动完成校验后任务会继续仍跑不通就先只下增量或暂缓。把档案同步交给自动化挂一个定时任务。Linux 或 macOS 的 crontab 一行就够每天凌晨自动补一次增量你早上只看结果0 2 * * * cd /path/to/douyin-downloader python run.py -c config.yml前提是increase.post: true且database: true增量去重依赖 storage/database.py 里的下载历史表。跑完主动通知你。配置里notifications块支持 Bark、Telegram、Webhook 三种渠道大任务结束不用盯着终端等。把元数据接进表格。打开json: true后每条作品落一份 JSON作者、发布时间、标题、标签都是现成字段直接导入表格或笔记软件做内容盘点。按你的情况选要不要用适合你要整站备份某个博主、给关注列表做定期同步、或者手里已有一堆下载好的作品想建本地索引。不适合你只想偶尔存单条视频在线解析网站更快或者需要商用转发的批量抓取。最后一条边界要说清下载能力仅限个人学习、备份与研究请尊重创作者权益不要用于商业用途或侵权场景。【免费下载链接】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），仅供参考