一条主页链接批量下载抖音无水印视频：Douyin-Downloader 实操指南-迪斯科星球

一条主页链接批量下载抖音无水印视频：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 命令行工具。输入一条博主主页链接或单个作品链接，即可把无水印视频、图文作品、合集与原声音频批量落到本地。它内置 SQLite 去重与浏览器兜底机制，既适合长期跟踪主页，也适合一次性归档。

能力总览：主页链接进，无水印档案出

该工具的能力按"输入 → 产出"角度可以概括如下，右侧标注了每项能力对应的配置项：

能力	说明	对应配置项
批量抓取	主页链接或单个作品链接（含短链）作为输入，并发抓取	`link`、`mode`、`number`
增量去重	SQLite 记录每个作品状态，重复运行只补新作品，缺失主文件可补下	`increase`、`redownload_missing_files`、`database_path`
浏览器兜底	接口被风控时自动切到 Playwright 打开主页，滚动采集作品 ID 再补全详情	`browser_fallback`
产物开关	封面、原声、头像、元数据 JSON、评论 JSON、转写文本、下载清单均可按需输出	`cover`/`music`/`avatar`/`json`、`comments`、`transcript`
命名归档	默认按"作者 / 日期_标题_作品ID"组织独立目录，模板可自定义	`folderstyle`、`filename_template`、`author_dir`
并发与重试	多线程并发下载，失败自动重试，可挂代理	`thread`、`retry_times`、`proxy`

接入与配置：最小可跑通配置

环境要求

Python 3.9 及以上，Windows、macOS、Linux 均可运行。浏览器兜底能力额外需要 Chromium 内核。项目另提供 Douzy 桌面版覆盖日常使用与更多平台，本指南聚焦命令行版，它更贴合批量任务与脚本集成场景。

获取与依赖

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

配置与登录

仓库自带带中文注释的模板 config.example.yml，复制为config.yml后运行内置 Cookie 获取工具即可完成登录。工具会打开浏览器等待扫码，回到终端按回车即可把认证信息保存到本地，Cookie 不会上传到任何服务器。

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

随后把config.yml里的示例link换成目标主页或单个作品链接，下载数量先写小一点试跑。

启动下载

python run.py -c config.yml

终端输出实时进度，每个作品按命名模板落到path下的独立目录，例如Downloaded/作者昵称/2026-06-15_作品标题_7xxxx/。python run.py --help可查看全部参数，包括-u追加链接、-t指定并发、-v输出详细日志。

增量开关与画质档位在哪里生效

最影响使用体验的四个配置项及其取值建议：

配置项	作用	推荐值与适用场景
`video_quality`	从接口返回的多档码率中挑下载档；`original`会额外探测上传原片，比转码档大时优先下载，失败自动降级	日常用默认的`highest`；重要内容长期存档用`original`；省流量可指定`720p`、`540p`
`increase.post`	增量开关：`true`时跳过主文件存在且非空的作品；`false`时重新下载并覆盖	跟踪类任务保持`true`；需要重抓时改为`false`
`redownload_missing_files`	磁盘主文件缺失或为空时是否补下，默认`true`；`false`时数据库有有效记录即跳过	只想补磁盘上被删掉的文件时保持默认
`browser_fallback`	作品列表被风控时，自动用 Playwright 打开抖音主页滚动采集并补详情	保持`enabled: true`、`headless: false`，验证在弹出的浏览器窗口中手动完成

json、cover、music、comments、transcript等产物开关默认全部关闭，按需打开即可。命名模板filename_template必须包含{id}，这是配置的硬性要求，避免两个同标题作品互相覆盖。

三个常见目标的工作流

长期跟踪指定博主

link: - https://www.douyin.com/user/博主A - https://www.douyin.com/user/博主B mode: [post] number: post: 0 increase: post: true

post: 0表示不限数量。把此配置挂成定时任务每周执行，增量逻辑只取新发布的作品，逐步积累成持续更新的研究资料库。

临时保存收藏作品

只有个别作品时，把作品链接（视频、图文、短链均可）填进link即可。打开folderstyle: true让每个作品独占一个目录，再打开cover: true、json: true，完成后目录内即含视频、封面与元数据 JSON，按日期或标题检索都方便。

带评论与转写的完整档案

json: true comments: enabled: true max_comments: 200 transcript: enabled: true

转写依赖环境变量OPENAI_API_KEY。任务结束后每个作品产出视频、元数据 JSON、评论 JSON、转写文本四类产物，一份完整档案。

风控与重下载排障手册

多数失败与风控或增量机制有关，处理路径如下表：

现象	可能原因	处理方式
主页只抓到少量作品，或下载直接失败	抖音风控拦截了部分 CLI 通道	打开`browser_fallback`开关并设`headless: false`，在浏览器窗口中手动完成验证；反复换 Cookie 无效
下载慢或经常断	并发过高或网络不稳	把`thread`调低（如 3），加大`retry_times`，必要时配置`proxy`
想重新下载却被跳过	增量开关判定作品已下载过	把`increase.post`改为`false`，下次运行重下并覆盖，无需清空数据库
Cookie 失效	Cookie 有时效	重新执行一次`python -m tools.cookie_fetcher --config config.yml`
两个同标题作品互相覆盖	命名模板缺少唯一标识	`filename_template`中保留`{id}`

可选增强：通知推送与 REST 服务

完成通知：notifications支持 bark、telegram、webhook 三种通道，长任务无需盯守终端。
REST 服务：python run.py --serve --serve-port 8000把下载器封装为 Web 服务，需另装 fastapi 与 uvicorn。
下载清单：下载目录根部自动追加download_manifest.jsonl，每个作品一行 JSON，含发布时间、标签与文件路径，可接下游脚本。
历史统计：对dy_downloader.db直接执行 SQL，一句统计即可看到累计下载量。
热搜与搜索：--hot-board 30导出热搜榜，--search按关键词检索作品，均输出 JSONL。
设计文档：自动重登录、时间窗早停等机制的设计记录见 docs/superpowers/。

代码分三层：core/ 是下载主流程，control/负责限速与重试，storage/负责文件与数据库。想深入阅读可从核心层开始，更多说明见 README.zh-CN.md。

上手建议

建议先用number.post: 5小试一次，确认流程正常后再放开数量限制并打开增量开关。

本工具仅限个人学习、研究与备份使用，请尊重创作者版权，勿将下载内容用于商业用途，并遵守平台规则。

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

企业官网建设流程全解析