企业官网建设流程全解析

抖音下载器快速上手指南：十分钟完成免费无水印视频、主页与合集批量下载

【免费下载链接】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 是一个免费开源的抖音批量下载工具：粘贴链接、改几个配置字段，就能把视频、图文、合集、原声无水印存到本地，自动去重、失败重试、进度条全程可视。零基础用户照着下文，三条核心命令就能跑通第一个任务。

先对号入座：这 5 种需求它都能接

在动手之前，先看看你要做哪件事：

• 把某个博主的主页作品一次搬空，按"作者 → 类型 → 日期"自动分好文件夹
• 每隔几天追更一次关注的主页，只搬新作品，旧的自动跳过
• 一个长系列合集一次整存，不用逐条点开
• 只想留原声 BGM，把视频、封面等附带文件全部关掉
• 只留某段时间的作品，比如只要去年的

从安装到第一条无水印视频：四步走完

第 1 步：拉代码、装依赖

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

✅ 成功标志：pip 的进度条走完，终端没有红色报错。前提是电脑装好了 Python 3.8 及以上。

第 2 步：拿到登录 Cookie

Cookie 相当于抖音的"登录凭证"，工具靠它识别你已登录。需要浏览器依赖，装一次即可：

cp config.example.yml config.yml pip install playwright && python -m playwright install chromium python -m tools.cookie_fetcher --config config.yml

程序会自动弹出浏览器，用抖音 App 扫码登录一次，回到终端按回车，Cookie 就写进 config.yml 了。

✅ 成功标志：终端提示登录成功、Cookie 已保存。

第 3 步：跑第一个下载任务

打开 config.yml，把link字段换成你想下载的作品短链（https://v.douyin.com/xxx或完整链接都行），然后执行：

python run.py -c config.yml

✅ 成功标志：进度条走完，Downloaded/目录里出现视频文件，已按作者名分好文件夹。

第 4 步（可选）：验证增量追更

什么都不改再跑一次同样的命令，程序会查本地 SQLite 数据库（记录下载历史的本地小数据库）把已下载的作品全部跳过。

✅ 成功标志：日志提示"跳过"，没有产生新文件。

配置配方速查：想做什么就照抄哪一行

所有开关都在 config.yml 里，对号入座改字段即可：

卡住了再动这 4 个参数

默认值覆盖大多数网络环境。只有当任务变慢、被限流或反复失败时，才需要动下面这几个：

thread: 5 # 并发下载数，被限流就降到 2~3 retry_times: 3 # 单条作品失败后的重试次数 proxy: "" # 整体变慢或被风控时填代理地址，如 http://127.0.0.1:7890 increase: post: true # 增量模式，只下载新作品 database: true # 去重与增量都依赖这份 SQLite 数据库记录

📌 什么时候动它：被限流就降thread、填proxy；追更就开increase；想控制单条失败不拖垮整个任务就靠retry_times自动补。

下载卡住时按这个速查表排查

• 现象：主页只抓到二十条左右就停了→ 原因：翻页触发了抖音风控 → 处理：把browser_fallback.enabled设为true、headless设为false，浏览器弹窗出现后手动过一遍验证，别急着关窗口。
• 现象：终端提示登录态失效→ 原因：抖音 Cookie 有时效，属正常现象 → 处理：重跑第 2 步的python -m tools.cookie_fetcher --config config.yml刷新一次。
• 现象：个别作品反复下载失败→ 原因：作品被删、设了私密，或临时限流 → 处理：retry_times: 3会按间隔自动重试；确认是删/私密的就不用管。
• 现象：整体下载变慢或超时→ 原因：网络波动或被限流 → 处理：给proxy填代理地址，或临时把thread调到 2~3，隔一会儿再跑。
• 现象：明明下载过，又重复下载了一遍→ 原因：数据库记录被误删，本地文件也没了 → 处理：保持database: true并别删dy_downloader.db；去重靠"数据库 + 本地文件名"双重检查。
• 现象：进度条疯狂刷屏看不清→ 原因：日志未静默 → 处理：确认progress.quiet_logs: true。

收尾：细节去哪查、以及一句提醒

⚠️ 本工具仅用于个人学习、备份与研究，请尊重创作者版权，不二次传播、不商用。

• 完整参数说明：README.zh-CN.md
• 配置样例（含每个字段的中文注释）：config.example.yml
• 下载核心逻辑：core/

现在就把 config.yml 里的link换成你真正想存的那条抖音链接——下一次运行结束，干净无水印的文件就会整整齐齐躺在你的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