如何把抖音主页完整备份到本地抖音批量下载与定时增量完整指南【免费下载链接】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 只获取一次即留存本地支持数量限制、时间窗、增量与 SQLite 去重需要 Python 环境与一次扫码登录主页级批量备份、长期增量归档手动保存无需任何配置逐条复制链接、逐图另存量大耗时偶尔保存单个作品第三方解析站开箱即用内容清单要经过对方服务器存在限次与广告站点随时可能关闭临时应急不适合存档结论只要目标是把整个主页存下来并且以后还能持续补新本地批量下载是唯一能兼顾数据可控与可重复运行的选择。环境准备依赖安装、Cookie 自动获取与 config.yml 配置需要 Python 3.9 及以上版本以pyproject.toml声明为准三步完成准备git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txtCookie浏览器登录态凭据相当于告诉接口你是谁无需手动拼字段。先复制示例配置再运行项目自带的提取工具 tools/cookie_fetcher.pycp config.example.yml config.yml python -m tools.cookie_fetcher --config config.yml该命令会弹出 Chromium 窗口首次需执行pip install playwright python -m playwright install chromium扫码登录后回到终端按 EnterCookie 自动写回config.yml。核心配置只需动 config.example.yml 中这几项link: - https://www.douyin.com/user/xxxxx # 目标作者主页 path: ./Downloaded/ # 保存目录 mode: [post] # 只下载作品 Tab number: post: 0 # 0 全量拉取 video: true # 保存视频本体 music: true # 附带保存背景音乐 cover: true # 附带保存封面 thread: 5 # 并发下载线程数运行任务与验证下载结果目录首次建议先把number.post改为 2 试跑确认目录命名符合预期后再放开为 0。正式执行python run.py -c config.yml终端会为每个作品滚动一条 Rich 进度条结束后输出统计块。thread默认 5、retry_times默认 3失败按指数退避1s、2s、5s自动重试。跑通后目录结构如下Downloaded/ └── 作者名/ └── post/ └── 2024-02-07_作品标题_aweme_id/ ├── 视频.mp4 # 由 video: true 产出 ├── 封面.jpg # 由 cover: true 产出 ├── 音乐.mp3 # 由 music: true 产出 └── data.json # 由 json: true 产出默认关闭需显式开启四个文件分别对应video/cover/music/json四个开关config.example.yml中除video外默认全部为false按需打开即可。桌面版 Douzy 提供同一套后端的可视化任务中心可在此查看每个主页任务的成功/失败计数桌面版任务中心每条主页任务展示已完成项数与失败项可打开对应目录config.yml 关键参数速查配置项作用建议值说明number.post本次最多下载多少条作品00表示不限数量试跑时先填2start_time/end_time只下载发布时间落在窗口内的作品按需格式YYYY-MM-DD留空字符串表示不限制thread并发下载线程数5默认值调到 20 容易触发限流increase.post增量开关跳过已下载作品true依赖database: true的记录database启用 SQLite 去重库true库文件由database_path指定默认dy_downloader.dbretry_times单条下载失败后的重试次数3指数退避 1s、2s、5s另有一个隐性参数rate_limit默认2请求/秒控制 API 访问节奏通常不需要改。crontab 定时增量下载无人值守补库原理一句话increase.post: truedatabase: true时程序对照 SQLite 记录只下载上次运行之后新发布的作品重复执行不会产生重复文件。在 Linux 上挂一个每天凌晨 4 点的任务即可0 4 * * * cd /path/to/douyin-downloader python run.py -c config.yml排错速查四个高频问题现象大面积报错提示需要登录或 403。→ Cookie 已过期重跑python -m tools.cookie_fetcher --config config.yml刷新不要手改cookies字段。现象只抓到 20 条左右就停远少于主页作品数。→ 这是接口翻页被风控拦截的典型信号确认browser_fallback.enabled: true且headless: false弹窗出现后手动完成验证再关窗浏览器兜底策略源码见 core/user_modes/。现象重跑时把已下载的作品全部重下一遍。→ 检查database是否为true且path与database_path相对上次运行没有变更两者一旦确定就不要挪动。现象下载中途报磁盘空间不足或速度骤降。→ 用start_time/end_time缩小时间窗或把number.post从0调小分批跑。小结douyin-downloader 解决的是主页级备份的三个核心问题一次拉全、可重复运行不重复下载、失败自动兜底配合 crontab 可以长期无人值守。请仅将下载能力用于个人学习、研究与自有数据备份尊重内容创作者权益不商用、不侵权。【免费下载链接】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），仅供参考