企业官网建设流程全解析

抖音批量下载工具使用指南：从 Cookie 配置到作者主页批量下载

【免费下载链接】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 是一个开源的抖音批量下载工具：给它一个作者主页或视频链接，它可以批量下载无水印视频、图集、合集和音乐，内置进度显示、失败重试和 SQLite 去重，配置一次就能长期用。

📋 它能做什么

• 作者主页批量下载支持 post / like / mix / music 四种模式，数量填 0 表示不限制
• 抖音无水印下载，自动挑选最高码率，video_quality 从原画到 360p 按需选，省流量
• 双重去重：SQLite 记录加本地文件名检查，增量模式只补新作品
• 翻页受限时浏览器兜底自动拉起本地浏览器，人工过验证码即可继续
• 可选按作品采集评论（含二级回复）、热搜榜与关键词搜索，结果导出 JSONL

🚀 从零到第一次下载

需要 Python 3.8+，macOS / Linux / Windows 均可。先克隆仓库装依赖：

git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt

Cookie 是唯一要准备的东西。工具会用 Playwright 打开抖音登录页，登录完回到终端按 Enter，它就自动写进 config.yml：

cp config.example.yml config.yml python -m tools.cookie_fetcher --config config.yml

这步报错的话先装浏览器内核：pip install playwright && playwright install chromium。

改好 config.yml 里的 link（主页链接）、path（保存目录）、mode（下载模式）三个字段，跑这条命令就能出结果：

python run.py -c config.yml

项目还提供桌面版 Douzy，粘贴链接即可下载、不用碰命令行，后面单独介绍。

🔧 Cookie、兜底与去重机制

抖音 Cookie 自动获取与自动重登

Cookie 配置交给 tools/cookie_fetcher.py，登录一次即可。会话过期后接口返回"请先登录"时，CLI 会自动检测、弹出浏览器重新登录并重试原任务一次，不用你手动停任务。自动重登只在交互终端生效，--serve服务模式下不会弹浏览器。

翻页受限时用浏览器兜底

抖音风控收紧后，API 翻页经常只给前 20 条，2026-09 起主页作品列表也受影响。browser_fallback会启动本地 Chromium 打开作者主页，读取页面自己发出的作品列表请求继续翻页。保持headless: false，浏览器弹出后手动过验证码，别关窗口；max_scrolls和idle_rounds控制滚多深、何时判定结束。

双重去重与增量下载

下载前先查 SQLite 数据库，再检查本地文件名里是否已有对应 aweme_id，两者都命中才跳过。打开increase.post: true后重跑同一份配置，只补新作品，老作品不重复占空间。想强制重新下载，数据库记录和本地文件都要删，只删一样不行。

桌面版 Douzy：关注同步与任务管理

桌面版和 CLI 共用同一套后端，适合不想碰命令行的用法：关注列表同步各账号的新作品，任务中心记录成功与失败、支持重试。

失败的任务会在任务中心标出来，可以直接重试或打开输出目录。

📐 常用配置项修改

config.yml 里常改的就这几个字段：

link: ["https://www.douyin.com/user/xxx"] path: "./Downloaded/" mode: [post] number: {post: 50} # 0 表示不限制 thread: 5 # 并发下载数

start_time: "2024-01-01" # 只下该日期后的作品 video_quality: original # original / highest / 720p 等 music: true # 下载背景音乐 cover: true # 下载封面图

increase: {post: true} # 增量模式，只补新作品 browser_fallback: enabled: true # 翻页受限时自动拉起浏览器 headless: false # 显示浏览器窗口，方便人工过验证码

• 并发保持 3-5 即可，开太高更容易触发风控；网络不稳可以配proxy走代理
• 全部字段注释见 config.example.yml

🎯 适合哪些场景

• 内容团队做竞品分析：用start_time拉竞品账号近 90 天的作品，分析更新节奏和封面风格；folderstyle: true下每个作品独立目录，方便和表格对照
• 个人收藏建档：把喜欢的账号配成一份 config 定时重跑，增量模式加数据库去重，只补新作品，不产生重复文件
• 互动数据采集：comments: enabled采评论和回复，json: true保存元数据，两份文件直接进离线分析流程

🧭 踩坑笔记

• 只抓到 20 条作品：API 翻页被风控拦了。打开browser_fallback，浏览器保持可见，手动过验证码，别关窗口
• 单个作品或主页下载被拒、返回 403：2026-09 起抖音风控收紧了相关接口。CLI 开浏览器兜底过验证，或直接改用桌面版 Douzy，它走浏览器登录通道不受影响
• 终端提示"请先登录"：Cookie 过期了。重跑一次 cookie_fetcher；交互终端里程序也会自动弹浏览器重登并重试一次
• 删了数据库想重下却被跳过：去重同时检查本地文件名里的 aweme_id。把对应作品目录一起删掉，或数据库和本地文件都删

小结

一条命令，把作者主页变成规整的档案。

cd douyin-downloader python -m tools.cookie_fetcher --config config.yml python run.py -c config.yml

跑通之后打开 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