抖音无水印批量下载入门：3步跑通 douyin-downloader 的主页全量抓取-平芜编程栈

抖音无水印批量下载入门：3步跑通 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 了。这是一款主打抖音无水印批量下载的工具：粘一个作者主页链接，它会按顺序把作品抓下来，附带上封面、原声，还会自动跳过已经下载过的内容。下面是给新手的 3 步上手教程。

先说句实话：从 2026 年 8 月起，抖音风控分两次收紧，命令行能直连的接口被收窄了一部分，比如点赞、收藏夹、单个作品、合集、音乐，主页作品翻页也需要浏览器兜底才能取全。具体哪些能用、哪些受限，以仓库 README 的限制说明为准。但不影响主流程：主页作品、热搜、搜索、评论、直播这几块依然可用。

三步装好抖音无水印下载环境

1. 克隆仓库，装依赖

先确认本机有 Python 3.8 以上版本，然后克隆仓库并安装运行所需的依赖：

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

浏览器兜底现在几乎是必选项，顺手把 playwright 也装上：

pip install playwright python -m playwright install chromium

2. 建配置文件，顺手拿 Cookie

把仓库里自带的配置模板复制成你自己的配置文件，所有默认值可以参考 config.example.yml：

cp config.example.yml config.yml

再运行内置的 Cookie 获取器。它会弹出一个浏览器，你手动登录一次抖音，登录完成回终端按 Enter，Cookie 就会自动写进配置文件：

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

3. 跑第一个批量任务

在config.yml里填上作者链接，然后一条命令启动：

python run.py -c config.yml

也可以不走配置文件，直接在命令行追加链接，用 8 个并发下载：

python run.py -u "https://www.douyin.com/user/MS4wLjABxxxx" -t 8 -p ./Downloaded

默认输出在Downloaded/作者名/post/下，按"日期_标题_作品ID"建目录，每个作品自带封面、原声和 JSON 元数据。同后端的桌面版 Douzy 提供了更直观的可视化操作（内测中，下面截图为演示数据）：

挑 3 个高频场景实际跑一遍

场景一：把博主主页作品全量收下来

背景：想完整备份某个作者的作品，不想一条条手动复制链接。

关键配置：填作者主页链接，模式选post，数量设 0 表示不限量，并打开浏览器兜底：

link: - https://www.douyin.com/user/MS4wLjABxxxx mode: - post number: post: 0 thread: 8 browser_fallback: enabled: true headless: false

预期效果：程序分页抓取作品，按设置的并发下载。翻到风控卡点时会自动弹出浏览器窗口，你手动过一下验证，程序接着往下抓，不用从头重跑。

场景二：长期追更同一作者，只下载新作品

背景：想每周追更同一个博主，每次都全量跑一遍太浪费时间和空间。

关键配置：打开增量开关，配合 SQLite 数据库记录下载历史：

increase: post: true database: true

预期效果：第二次运行时只抓上次之后的新作品，已下载的内容通过"数据库记录 + 本地文件"双重去重直接跳过。几百个作品的账号，追更通常几分钟就能跑完。

场景三：导出热搜榜和关键词搜索结果

背景：不想要视频文件，只想要结构化数据做选题或分析。

关键配置：不用动配置文件，两条命令直接出结果：

python run.py --hot-board 30 -p ./Downloaded python run.py --search "猫咪日常" --search-max 100 -p ./Downloaded

预期效果：结果落到Downloaded/hot_board/和Downloaded/search/下的 JSONL 文件，文件名带时间戳，直接喂给其他分析工具就能用。

桌面版还会同步收藏夹、喜欢列表等账号内容，可以整个合集一键下载（collect 模式的限制详见 README.zh-CN.md）：

抖音批量下载常用配置速查

配置项	作用	适合谁
`mode`	`post`作品 /`like`点赞 /`mix`合集 /`music`音乐 /`collect`收藏夹	所有批量场景
`number.*`	各模式数量上限，0 表示全量	控制下载量
`increase.*`	增量开关，只抓新作品	长期追更
`thread`	并发数，默认 5	平衡速度与风控
`start_time`/`end_time`	`YYYY-MM-DD`时间过滤	只收集某一时段作品
`browser_fallback.*`	浏览器兜底，对付翻页风控	主页全量收集
`progress.quiet_logs`	进度阶段静默日志，避免刷屏	在意终端体验
`database`/`database_path`	SQLite 去重与历史记录	增量下载的前提
`proxy`	API 请求与媒体下载的代理	网络不稳定
`comments.enabled`	按作品采集评论，可含二级回复	观点与数据分析

5 个高频坑：现象、原因、解法

坑 1：只抓到 20 条左右的作品就停了原因：抖音翻页风控，限制了一次能翻的页数。解决：把browser_fallback.enabled设为true、headless设为false，浏览器弹窗出现后手动完成验证，别急着关窗口。

坑 2：请求直接 403，提示被 Argus 风控拦截原因：2026 年 8、9 月起抖音对部分直连接口加了门禁，换 Cookie、多次重试都没用。解决：受影响的下载改走浏览器兜底或桌面版 Douzy，具体接口清单以 README 限制说明为准。

坑 3：Cookie 隔几天就失效原因：Cookie 会过期，风控也会刷新登录态。解决：重新跑一次获取器：

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

坑 4：想重下某个作品，却提示已跳过原因：去重是"数据库记录 + 本地文件"双重判断，一边有记录另一边就不会重下。解决：删掉本地目录，同时清掉数据库记录：

rm -rf "Downloaded/作者名/post/"*_<作品ID>/ sqlite3 dy_downloader.db "DELETE FROM aweme WHERE aweme_id = '<作品ID>';"

坑 5：进度条和日志混在一起，满屏刷屏原因：各阶段日志同时输出。解决：保持配置里的progress.quiet_logs: true；调试时再临时给命令行加-v看详细日志。

进阶能力：值得翻一翻的部分

前面三步跑顺之后，可以看看这些能力，每项在仓库里都有对应配置项：

评论采集：comments.enabled: true，可含二级回复，输出在作品旁的*_comments.json
直播录制：支持live.douyin.com房间链接，主播下播或中断时已录数据会保留
视频转写：调用 OpenAI Transcriptions API 自动产出 txt/json 字幕，仅对视频作品生效
REST API 服务模式：python run.py --serve --serve-port 8000，把下载变成可被其他程序调用的 HTTP 接口
完成通知：Bark / Telegram / Webhook 推送下载结果，适合挂机长任务
Docker 部署：仓库自带 Dockerfile