企业官网建设流程全解析

抖音无水印下载工具 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 是一个用 Python 写的命令行下载器，把抖音视频链接写进一份 YAML 配置文件，它会以无水印源批量保存作品，并可按需附上原声音乐、封面和 JSON 元数据。默认带有并发下载、指数退避重试、SQLite 去重和下载完整性校验，同一个作品第二次运行不会重复下载。

这份指南面向想把某位创作者的作品、或一批指定内容归档到本地的用户，只要求你会打开终端执行命令。全文围绕四个任务展开：装好工具并配好 Cookie、批量下载主页作品、管理下载目录、绕过常见卡点。

有一点需要先说明：从 2026 年 9 月起，抖音加强了对部分接口的风控，CLI 直接调 API 抓取单个视频、合集等场景受限，主页作品依赖浏览器兜底翻页（详见第四节）。如果只下载单个视频，项目提供了桌面版 Douzy，后文会给出入口。

💾 如何安装 douyin-downloader 并配置 Cookie

整个流程三步：装依赖、复制配置文件、获取 Cookie。

安装依赖并复制配置文件

要求 Python 3.8 以上。依次运行下面两条命令：第一条把代码拉到本地，第二条安装运行所需的库。

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

项目里带了一份注释完整的示例配置，复制一份作为你实际使用的配置文件：

cp config.example.yml config.yml

如何获取抖音 Cookie

抖音接口需要登录态才能取内容，Cookie 是工具能跑起来的前提。最简单的办法是用项目自带的抓取脚本：它会自动打开一个浏览器，你扫码登录抖音后回到终端按 Enter，Cookie 就被写进 config.yml 的cookies字段，不需要手动复制粘贴。

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

前两条命令首次使用时装一次即可。这里用到的 playwright 后面浏览器兜底翻页还会用到，建议一次装好。Cookie 过期失效时，重新执行第三条命令即可，见第四节。

📥 如何批量下载一个抖音创作者的作品

这是最常用的场景：把一个作者主页的作品整批存到本地。

配置主页链接与下载模式

打开 config.yml，把link改成创作者主页的网址（形如/user/xxxx的那条链接）。mode字段决定取哪类内容，常用取值如下：

对应的配置片段：

link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx mode: - post number: post: 50 # 0 表示不限量

启动下载并验证结果

运行这条命令开始下载：

python run.py -c config.yml

终端里默认显示进度条，progress.quiet_logs开着时会减少日志刷屏。下载完成后到Downloaded/{作者名}/post/{日期}_{标题}_{id}/目录核对文件：视频默认选无水印源，画质由video_quality决定，默认highest（最高转码档），想拿上传原片可改成original。把cover、music、json改为true，还会在同一目录下多存封面、原声和元数据。

不想每次改配置，也可以在命令行直接追加链接，例如只下载某一条作品：

python run.py -c config.yml -u "https://www.douyin.com/video/7604129988555574538"

同一套后端还做了桌面版 Douzy（内测中），粘贴链接即开始下载、可视化跟踪任务，入口见 README 桌面版章节。

🗂 如何整理下载目录并避免重复下载

批量下载跑得多了，目录管理和去重是第二个真实痛点，这几个配置项值得花五分钟设置一次。

文件夹结构与命名模板

folderstyle: true（默认）时，文件按"作者 → 模式 → 作品"三层目录存放。子目录名和文件名由filename_template与folder_template控制，默认{date}_{title}_{id}，你也可以改成{author}_{title}这类组合，但模板里至少要留一个{id}，否则同名作品会互相覆盖。默认只保存视频本体，封面、音乐、头像、JSON 全部关闭，这正是目录里文件不多的原因；需要哪些就单独打开哪些。

增量下载与数据库去重

database: true（默认）会在当前目录生成dy_downloader.db，记录已下载的作品。配合increase.post: true，重复运行同一条主页链接时只下载新增作品，已下载的直接跳过。程序用"数据库记录 + 本地文件名中的 aweme_id"双重判断，所以想重新下载某个作品时，本地文件和数据库记录要一起清理，只删其中一样可能不会触发重下，具体命令见 README 的"重新下载"一节。

按发布时间筛选内容

只想收集某个时间段的作品，用这两个字段圈定范围：

start_time: "2024-01-01" end_time: "2024-12-31"

格式固定为YYYY-MM-DD，只下载区间内发布的作品，适合做分阶段的素材收集。

⚠️ 下载时的常见卡点与解决办法

只能抓到 20 条作品、翻页被风控拦住

这是主页下载最常见的卡点。确认browser_fallback.enabled: true且headless: false，翻页受限后程序会自动启动浏览器，此时手动完成页面里的验证再关闭窗口，不要立刻关掉。

需要说明的是：2026 年 8 月起抖音的 Argus 风控拦截了 CLI 对点赞/收藏夹等接口的请求，2026 年 9 月又扩展到单个视频、合集、音乐等接口，CLI 目前主要靠浏览器兜底拿主页作品，其余场景建议改用桌面版 Douzy。各功能的可用状态以 README 的限制说明 为准。

Cookie 失效或速度异常

出现大面积失败时，先重新执行 Cookie 抓取命令（第一节那条python -m tools.cookie_fetcher）。速度偏慢或网络环境受限时，可以调小thread（并发数，默认 5），或在proxy字段填 HTTP 代理地址。

想深入代码或扩展功能

下载模式的具体逻辑在 core/user_modes/，每个模式一个策略文件，加新类型可以参考post_strategy.py的写法；全部配置项的注释都在 config.example.yml 里，采集评论（comments.enabled）、下载完成推送到手机（notifications，支持 Bark/Telegram/Webhook）等进阶开关也在那里直接打开即可。下载的内容建议仅用于个人观看、学习与研究，避免商用转载，尊重原创者权益和平台规则。

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