抖音无水印批量下载零基础上手：一条链接跑通，十分钟存下整个作者主页

抖音无水印批量下载零基础上手：一条链接跑通，十分钟存下整个作者主页

【免费下载链接】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，就能把抖音视频无水印下载下来，整批落到本地硬盘，自动去重、自动归档。全程只需要会敲终端，不用写一行代码。

先看看成品长什么样

跑完一次批量下载，你的硬盘里会多出一个整理得整整齐齐的目录树，默认按"作者 → 类型"分层，文件名自带发布时间：

Downloaded/ └── 旅行摄影日记/ ├── post/ │ ├── 2024-12-30_19.37.12_雪山日出延时_7341xxxx.mp4 （无水印正片） │ ├── 2024-12-30_19.37.12_雪山日出延时_7341xxxx_cover.jpg （封面，可选） │ └── 2024-12-30_19.37.12_雪山日出延时_7341xxxx.mp3 （原声，可选） └── live/ （直播录制，发生时才有）

同时会生成一个dy_downloader.db数据库文件。它的作用我们后面讲。如果配合仓库里的桌面版（Douzy，共享同一套下载引擎），任务中心能看到每个任务的成功件数、失败原因，以及一键打开输出目录：

它是不是你的菜

说清楚边界：它覆盖单条视频、图文笔记、合集、音乐原声、作者主页、直播录制这几类抖音生态内容，形态是命令行工具，没有图形界面——但桌面版 Douzy 也在仓库里，介意外观可以直接用它。

开跑前的准备：一次配好，长期能用

可以把它想象成请了一位私人代录师：链接是取片单，Cookie 是进片库的出入证，数据库是那本防止重复代录的片目登记册。下面四步，就是给它发工牌。

1. 拉项目、装依赖

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

人话：把工具拷到本地，装齐它依赖的第三方库（需要 Python 3.8+）。 预期：pip 进度条跑完、没有红色报错，环境就绪。

2. 生成自己的配置文件

cp config.example.yml config.yml

人话：仓库自带的config.example.yml是官方给的完整模板，复制一份叫config.yml，之后所有自定义都改这份文件，不碰模板。 预期：终端静默完成，目录里多出一个config.yml。

3. 领"出入证"（Cookie）

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

人话：Cookie 是工具对接抖音接口的登录凭证，相当于进片库的出入证。第一条装浏览器组件，第二条装浏览器本体，第三条会自动弹出浏览器——扫码登录抖音后，回到终端按 Enter，Cookie 自动写进config.yml。 预期：终端提示 Updated config file；配置文件里的cookies段已填入真实值。一次配置，长期使用（过期了重跑第三条即可）。

4. 检查最小配置

打开config.yml，确认这几行是通的：

link: - https://www.douyin.com/video/7604129988555574538 # 待下载链接，可多条 path: ./Downloaded/ # 落盘目录 thread: 5 # 并发数 database: true # 开启去重台账

人话：link写你要下的东西，path决定文件放哪，database: true是增量下载的前提。 预期：保存文件，终端里cat config.yml能回显你改的内容。

一条链接跑通全流程

确认config.yml的link里只留一条视频链接（或图文/合集链接，类型会自动识别），然后：

python run.py -c config.yml -p ./Downloaded

逐个说参数：-c指定配置文件，-p指定落盘目录（不写默认读配置里的path），-t 8可临时把并发提到 8 条，-u "链接"可临时追加一条链接而不用改文件。

预期：终端出现 Rich 进度条，逐个显示下载速度与剩余时间；结束后输出成功/失败/跳过三类统计；./Downloaded/作者名/post/下出现无水印的.mp4。

换个玩法：三个高频场景

场景一：整包备份某位创作者的全部作品

• 适用情况：想把某个主页的作品整批发到本地留档。
• 关键配置：

link: - https://www.douyin.com/user/作者ID mode: - post # post=发布作品，like=喜欢作品 number: post: 50 # 只取最近50条，0=全部

• 运行命令：python run.py -c config.yml
• 你会看到什么：终端逐条刷出下载进度，结束时给出成功、失败、跳过三类汇总，文件全部落在Downloaded/作者名/post/下。

场景二：同一个主页反复跑，只补新作品

• 适用情况：固定追更某位博主，每周跑一次。
• 关键配置：

increase: post: true # 增量模式：台账里已有的一律跳过 database: true # 增量依赖数据库记录 start_time: "2025-01-01" # 可选，只取该日期之后发布的

• 运行命令：与场景一相同，python run.py -c config.yml。
• 你会看到什么：旧作品显示"跳过"，只有新发布的进入下载队列；dy_downloader.db就是那本片目登记册，它让重跑永远不会下载两次同一条。

场景三：录下一场抖音直播

• 适用情况：想留档某场直播，主播下播前持续录。
• 关键配置：

link: - https://live.douyin.com/房间ID live: max_duration_seconds: 0 # 0=录到主播下播

• 运行命令：python run.py -c config.yml
• 你会看到什么：先输出房间信息，随后持续录制、终端滚动显示写入状态；主播下播或你按 Ctrl+C 中断时，已录部分完整保留，文件在Downloaded/作者名/live/。

卡住了？按症状对号

红线与深入

⚠️ 下载所得仅用于个人学习、备份或研究自己有权使用的内容。请尊重创作者版权，不要二次传播或商用。

想再往下挖一点，按顺序看这三处就够了：

• README.zh-CN.md：快速开始与全部典型场景示例，拿不准某个开关先查这里。
• config.example.yml：逐项带注释的配置模板，改配置时对着它核对。
• core/：API 解析、重试与去重的实现位置，进阶用户值得通读一遍。

把一条链接丢进终端跑通它，十分钟之后，你的硬盘里就多出一份干干净净的无水印存档。

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