抖音批量下载完整指南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 就是干这件事的抖音批量下载工具贴一个博主主页链接作品、封面、背景音乐和元数据整批拉回本地。它在你自己的电脑上运行全程数据不经第三方Cookie 也只落在本地配置里。它能帮你省掉什么整批搬回本地贴一个主页链接翻页、拉取、落盘全自动文件按作者/内容类型/作品自动分好文件夹一次跑完几十条不用碰鼠标。只补拉新作品开启增量开关后每次运行自动跳过下过的内容内容库随时间自己长你只负责挂任务。留一份可查的档案每条作品落一份 JSON 元数据作者、发布时间、标题、标签历史同时写进本地 SQLite 数据库盘点存过什么一条查询就够。装环境五分钟跑通依赖确认 Python 是 3.9 及以上版本Windows、macOS、Linux 都支持然后拉代码、装依赖git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader python -m pip install -r requirements.txt验收信号pip install走完没有红色报错就代表环境就绪。拿到可用的登录态这一步新手最容易卡住抖音的接口需要登录凭证Cookie即浏览器登录后携带的身份信息缺了它任务会大面积失败。好在项目自带提取脚本不用手工拼cp config.example.yml config.yml python -m tools.cookie_fetcher --config config.yml脚本会拉起浏览器你在里面登录一次抖音回到终端按 EnterCookie 就自动写回config.yml了。全程不出本机。把配置填到位打开config.yml只需动几处link换成目标博主主页链接单条视频、合集链接也支持可以写多条path指向你想保存的目录。批量任务的参数逻辑可以先在桌面版里对照着理解——勾选要处理的内容类型作品/喜欢/合集/音乐、限定数量和日期范围命令行配置里对应的是mode、number和时间字段其余字段保持默认即可config.example.yml里每项都有中文注释翻一遍心里就有底了。启动任务看着它跑完python run.py -c config.yml验收信号终端逐条滚动作品进度结尾给出成功/失败计数。想加详细日志就追加-v临时多挂一个链接用-u追加不会覆盖配置里的内容。全部参数python run.py --help一次看全。打开文件夹验收结果跑完打开path指向的目录文件应该是这个样子的三级结构Downloaded/ └── 作者名/ └── post/ └── 2024-02-07_作品标题_作品ID/ ├── 2024-02-07_作品标题_作品ID.mp4 ├── ..._cover.jpg # 封面 ├── ..._music.mp3 # 背景音乐 └── ..._data.json # 元数据文件夹名带作品 ID同标题作品不会互相覆盖根目录还有一份download_manifest.jsonl清单每行一条下载记录方便日后追溯。目录结构符合预期验收通过。日常只动的这几个字段字段作用建议值link目标链接主页、单条视频、合集都认填主页链接做整批备份path保存目录不存在会自动创建指向专门的备份盘mode主页链接时处理什么post作品 /like喜欢 /mix合集默认[post]number.post每个主页最多下多少条0为不限先用 2~5 试水确认无误再改 0increase.post增量开关true跳过已下载作品长期备份设truethread并发线程数默认 5网络稳可上调start_time/end_time按发布时间过滤YYYY-MM-DD含结束当天限定时间段省磁盘database用本地 SQLite 记下载历史保持trueretry_times单条失败自动重试次数3 左右网络差调高video_quality画质默认highest最高转码档original探测原片存原片就设original命名模板、作者目录风格、评论采集这些进阶项config.example.yml里都有注释用到再查。翻车了先查这张表症状原因处理大量失败提示需要登录Cookie 缺失或过期重跑python -m tools.cookie_fetcher --config config.yml别手改已写回的字段主页只拉到一部分作品数量/时间限制没放开或接口翻页受限先查number.post和时间范围仍不全就保持browser_fallback.enabled: true且headless: false在弹出的浏览器里自行完成验证同标题作品只剩一个文件夹命名模板里去了作品 ID写到了同一处保持默认folderstyle: true和模板里的{id}别手动简化命名下载到一半断网网络波动部分成功部分失败不用整批重跑已存在的文件会自动跳过直接再跑一次即可调高retry_times减少中断增量模式下旧文件没补回来缺失文件默认会重下但被关掉了检查redownload_missing_files是否为true默认就是另外注意平台风控在变化主页作品若被拦截浏览器兜底是唯一可用路径且不保证成功这类问题靠更新 Cookie、反复重试解决不了先看终端日志加-v再动手。让归档自己跑起来增量只补新的。increase.post: true加上database: true之后每次运行只处理新发布的作品。判断依据是磁盘上的主媒体文件在就跳过缺了或空了就补下。想全量重拉时把increase.post改回false即可不用清数据库。一行命令挂定时。Linux / macOS 上 crontab 加一行每天凌晨自动补一次增量0 2 * * * cd /path/to/douyin-downloader python run.py -c config.yml跑完主动通知你。config.example.yml里的notifications段支持 bark、telegram、webhook 三种推送on_success/on_failure分别控制成功和失败时是否提醒大任务不用再守屏幕。数据直接复用。每个作品的_data.json里有作者、发布时间、标题、标签导进表格或笔记软件就是现成的内容盘点download_manifest.jsonl是追加式清单SQLite 里的aweme明细表和download_history任务记录表随时可查我存过什么、哪次任务下过多少。适合三类人想把某位博主的作品完整留一份本地的、给关注列表做定期同步的、按自己目录规则组织内容的。边界也摆清楚下载能力仅限个人学习、备份与研究请尊重创作者的权益别用于商业用途或侵权场景——用得克制工具才走得远。【免费下载链接】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），仅供参考
