企业官网建设流程全解析

十分钟跑通 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 就是解决这件事的免费开源工具：单条视频、图文、合集、音乐原声，以及作者主页批量下载，全程无水印，不写代码，贴链接、改配置就行。它会自动挑无水印的高清源，用 SQLite 数据库去重，翻页被风控卡住时还能弹出浏览器让你手动过验证。

跑完一次任务，你会得到这样的结果画面：

• Downloaded/目录下按"作者 → 类型 → 日期_标题_作品ID"分好文件夹
• 每条作品一个独立目录，里面有干净的.mp4，封面、原声、JSON 元数据按需附带
• 数据库dy_downloader.db自动记录下载历史，下次运行自动跳过已下载的

从零到第一次无水印下载成功

只需 4 组命令，每步都有可自查的成功标志。

第一步：拿到代码并装好依赖（需要 Python 3.8+）

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

✅ 成功标志：pip 进度条走完，终端没有红色报错。

第二步：生成配置文件

cp config.example.yml config.yml

✅ 成功标志：当前目录下多出一份config.yml，所有开关都可以在这份文件里改。

第三步：扫码获取登录 Cookie

浏览器兜底和 Cookie 抓取依赖 Playwright，先装上：

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

程序会自动弹出浏览器，你扫码登录一次抖音，回到终端按回车。✅ 成功标志：终端提示登录成功，config.yml的cookies区域已填上真实值。

第四步：填链接，跑第一个任务

打开config.yml，把你的抖音链接（视频、主页、合集都行）填进link字段，然后执行：

python run.py -c config.yml

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

高频需求对照：想做什么，改哪个字段

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

这几个关键参数，按需调

• thread: 5— 并发下载数。网络一般或频繁被限流时降到 2~3，速度换稳定。
• retry_times: 3— 单条失败后的重试次数，默认带指数退避（1s、2s、5s），偶发失败不用人工管。
• proxy: ""— 下载变慢或被限流时填代理地址（如http://127.0.0.1:7890），API 请求和媒体下载都走它。
• video_quality: highest— 画质档位。默认在转码档里挑最高码率；想赌原画可改original（每条多一次 10s 超时探测，失败自动退回）；省流量就设lowest或指定1080p这类分辨率。
• database: true+increase.post: true— 增量下载是"数据库记录 + 本地文件"双重检查，想强制重新下载某条作品，需同时删本地文件和数据库记录（清理方法见 README.zh-CN.md 的"重新下载"一节）。

卡住了？现象 → 原因 → 解法

• 现象：主页只能抓到二十条左右就停了。原因：翻页触发抖音风控。解法：确认browser_fallback.enabled: true、headless: false，浏览器弹窗出现后手动完成验证，别急着关窗口。
• 现象：终端提示登录态失效。原因：抖音 Cookie 有时效，属常态。解法：重跑第三步的 Cookie 命令刷新一次即可继续。
• 现象：反复出现 403Blocked by ArgusSecurityPlugin，重试多少次都一样。原因：2026-09 抖音风控升级后，CLI 的 API 直连请求过不了这道门禁，不是你的配置问题。解法：装好 Playwright、保持browser_fallback开启（兜底走浏览器内 SDK 发请求）；或改用同仓库提供的桌面版 Douzy（内测中，截图即来自该版本）。
• 现象：整体下载变慢甚至超时。原因：网络波动或被限流。解法：给proxy填上代理地址，或临时把thread调小，过一会儿再跑。

跑之前先知道的：2026 年风控变化

• 2026-08 起：点赞、收藏夹、收藏合集接口对 CLI 全部 403。
• 2026-09-10 / 09-14 起：合集作品列表、单个视频、图文、音乐接口也被拦截。
• 主页作品列表的 API 翻页同样被拒，目前只能靠浏览器兜底去读页面自己发出的请求（尚未针对该门禁完整实测）。
• 2026-09-14 实测仍可直接访问的：用户资料、关注列表、评论列表、直播间、热搜榜与关键词搜索（--hot-board [N]/--search "关键词"）。

也就是说：下载链路本身没问题，能不能直连取决于抖音风控当天的策略。

延伸阅读

• 完整参数与命令行选项：README.zh-CN.md
• 配置样例（每项都有注释）：config.example.yml
• 下载核心逻辑：core/
• 浏览器兜底与 Cookie 抓取：tools/cookie_fetcher.py
• 设计与变更记录：docs/superpowers/specs/

本工具仅用于个人学习、备份与研究，请尊重创作者版权，不二次传播、不商用。现在就把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