企业官网建设流程全解析

抖音批量下载教程：3 步让博主主页存档落地本地，无水印视频 10 分钟跑通

【免费下载链接】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 去重和真实浏览器兜底。照本文做完，10 分钟内你会在本地拿到第一条无水印 mp4。

🧭 装之前先判断：这个工具有没有帮到你

• 无水印自动选档：抖音接口为每个视频返回多档码率，工具自己挑无水印源地址，默认取最高转码档，不用手动翻页面找直链
• 链接即入口：v.douyin.com短链会先解析成真实地址再下载，单条视频、图文、合集、音乐页都能识别
• 重跑不重下：下过的作品记进dy_downloader.db数据库，再跑一次先查数据库加本地文件，只补新增的
• 风控兜底（风控指抖音服务端对异常请求的拦截）：翻页被拦时自动拉起 Playwright 驱动的真实浏览器，你在窗口里手动过验证后它继续
• 不适合的场景：只偶尔下几条视频的话别装——抖音风控目前对 CLI 的单条抓取限制较严，官方 README 明确建议日常下载用同源的 Douzy 桌面版

⚙️ 环境准备：从拉仓库到扫码登录走三步

第 1 步：拉代码装依赖

需要 Python 3.9 以上。目的：把仓库拿到本地并装齐 Python 包。

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

验证：在仓库目录跑python -c "import aiohttp, yaml, rich"，无任何输出即通过。

第 2 步：装浏览器内核

Cookie 抓取和风控兜底都靠 Playwright 驱动的真实浏览器，目的：先把浏览器内核装好。

pip install playwright python -m playwright install chromium

验证：终端出现 chromium 下载进度并正常结束，没有报错码。

第 3 步：复制配置并扫码登录

Cookie 是浏览器登录凭证，工具靠它向抖音接口证明身份。目的：拿到一份有效 Cookie 写进配置。

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

在弹出的浏览器里完成抖音登录，回终端按 Enter。验证：终端打印[INFO] Updated config file，且打开config.yml看到cookies段不再是YOUR_XXX占位值。

📥 三个核心入口：批量、单条、增量，按使用频率排

整页批量下载博主主页

打开config.yml，改三个字段：link换成主页地址、mode保持post、number.post改成0（模板默认是 1，不改只下 1 条）：

link: - https://www.douyin.com/user/某博主主页地址 mode: [post] number: post: 0

跑：

python run.py -c config.yml -t 2

并发（同时抓数据的任务数）默认 5，-t 2压到 2，请求节奏慢一点，被风控盯上的概率更低。成功长什么样：结尾汇总形如成功 132 / 失败 0 / 跳过 0，./Downloaded/博主昵称/post/下出现按日期加标题命名的文件夹，例如2024-02-07_作品标题_aweme_id/，里面是无水印 mp4。

单条视频或图文

不想改配置时，链接用-u直接传（可重复传多条，短链也行）：

python run.py -u "https://v.douyin.com/xxx/" -c config.yml

-u的链接不写回配置，跑完不留痕。成功标志：./Downloaded/里多出一个新 mp4（图文则是图片文件）。坦率讲，单条这条路是目前最容易被风控拦的，被拦就改用 Douzy 桌面版。

增量追更

increase.post和database模板里默认都是true，不用动。以后把number.post保持 0，定期重跑同一份配置，已下过的自动跳过。成功信号：汇总里跳过数明显大于 0。

同一套后端还封装成了桌面版 Douzy，README 建议日常下载优先用它：

这是桌面版抖音选项页，勾选作品、喜欢、合集、音乐要处理哪些模式，并给各模式设数量上限，和 CLI 里mode与number一一对应。

桌面版还能切到 TikTok、YouTube 等其他平台工作台，切换入口在左侧边栏。

🩺 配置微调：这几个键值得记

• video_quality（默认highest）：默认取最高转码档。存原片就改original，每条作品多一次探测请求，找不到原片自动退回最高档；想省流量改720p、540p，匹配不到会降到最接近的可用档
• start_time/end_time（默认空）：只归档某时间段的作品时填，格式YYYY-MM-DD，包含结束日期当天
• music/cover/json（默认全false）：原声、封面、作品数据三类附带产物默认全关；确认要原声音乐时把music改true再跑
• thread/retry_times（默认5/3）：批量跑主页时把并发调小；中断的下载按重试次数自动补
• increase.post（默认true）：想强制重下某范围内的作品就改false，会重下并覆盖，不用手动清数据库
• redownload_missing_files（默认true）：本地主文件丢了就补下；改false后数据库有记录即跳过

🔍 排障速查：现象、原因、处理

收尾

Cookie 是你的登录凭证，只留在本地config.yml里，别把带 Cookie 的配置文件发给别人；下载内容建议仅用于个人存档和研究。推荐落地顺序：先用-u跑通一条链接，确认./Downloaded/出现无水印文件；再上主页整页批量，-t 2慢速跑完；最后number.post保持 0 定期重跑做增量追更。想深挖默认开关看 config/default_config.py，下载主流程在 core/，完整配置示例在 config.example.yml，当前风控限制的官方说明见 README.zh-CN.md。

【免费下载链接】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