企业官网建设流程全解析

抖音批量下载实战：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

凌晨一点，阿凯对着电脑屏幕上第 67 个还没下完的视频叹气。为了给公司的剪辑素材库攒 200 条同类视频，他已经连续三个晚上重复同一套动作：复制链接、打开网页、点保存、手动改名，还时不时下载到带水印的版本。直到朋友甩给他一个开源项目——douyin-downloader，一款能去水印、支持视频、图集、合集、音乐（原声）和作者主页批量下载的抖音下载工具。

它到底能帮你省下什么？

一句话说清：douyin-downloader 是一个开源的抖音批量下载工具，把"找链接、下载、去水印、归档整理"整条链路自动化，适合内容创作者、剪辑素材收集者和研究者，也适合所有不想在手动保存上浪费时间的人。你只需要提供一个链接，剩下的事交给它。

上面是它配套的桌面客户端 Douzy 的下载界面——粘贴链接、勾选"作品 / 喜欢 / 合集"，点一下就开始。命令行版本同样简单，我们马上把它跑起来。

5 分钟跑通第一个下载任务

先安装。需要 Python 3.8 以上环境：

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

然后复制一份最小配置。把下面内容存成config.yml，把link换成你要下载的视频或博主链接：

link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx path: ./Downloaded/ mode: - post number: post: 5 thread: 3

这段配置的意思是：从该作者主页下载 5 条发布作品，并发数为 3，文件保存到./Downloaded/。最后运行：

python run.py -c config.yml

几秒钟后，打开Downloaded/目录，你会看到按"作者名 → 作品类型 → 日期_标题_作品ID"组织的文件夹，里面是视频、封面、原声和 JSON 元数据。第一个正反馈，就这么简单。

四个核心能力，一张表看懂

无水印优先：下载即高清

你不需要做任何额外操作。工具会从抖音返回的多个视频源里自动挑无水印、码率最高的那一个。如果想让资源更完整，保持这些开关开着：

music: true cover: true avatar: true json: true

封面、原声音乐、作者头像、完整元数据会跟着视频一起落盘，一个作品一个文件夹，干干净净。

批量拉作者主页：一个链接拿走全部作品

mode: - post - like - mix - music number: post: 50 like: 20 mix: 10

这段配置的意思是：下载该作者最近的 50 条作品、20 条点赞、10 个合集，以及他使用过的音乐原声。配合start_time/end_time还能只保留某个时间段的内容。

智能去重：第二次运行不再重复下载

database: true时，每个作品下载后会记入 SQLite。再次运行同一链接，工具会自动跳过已下载的文件；配合increase.post: true则只补抓新作品，非常适合每天定时更新素材库。

浏览器兜底：API 被限制时自动切换

批量翻页容易触发风控。遇到这种情况，工具会自动拉起浏览器模拟翻页，建议保持非无头模式：

browser_fallback: enabled: true headless: false # 非无头模式，方便人工过验证码

浏览器弹出来后手动完成验证再关闭窗口，采集到的作品会补齐详情继续下载，成功率大幅提升。

三个真实场景演练

场景一：把喜欢的博主整个主页搬回家

关注了一位美食博主，想把他所有作品存下来当素材？配置：

link: - https://www.douyin.com/user/博主的sec_uid mode: - post number: post: 200 thread: 5

运行后 200 条作品在几分钟内完成，文件自动按"作者名 / post / 日期_标题_作品ID"归档，每条作品都带封面和原声，下次剪辑直接翻文件夹，不用再去找原视频。

场景二：批量收集音乐原声

做短视频缺 BGM 素材？把链接换成音乐页：

link: - https://www.douyin.com/music/音乐ID path: ./bgm/

工具会优先抓取原声文件，文件名带上发布日期和作品标题，方便后续检索。同一作者用的所有音乐，也能通过mode: [music]一次拉齐。

场景三：录制一场重要直播

直播没法回看，错过就没了。把链接换成直播间地址，再补一段配置：

link: - https://live.douyin.com/房间号 live: max_duration_seconds: 3600 # 最多录 1 小时，0 表示录到主播下播 idle_timeout_seconds: 30

录制过程中终端会显示清晰度、在线人数和流地址，主播下播自动保留已录内容，重要内容不再错过。

新手最容易踩的 5 个坑

Q1：提示登录态失效怎么办？现象：运行时报"未登录"错误。原因：抖音 Cookie 过期。 解决：执行python -m tools.cookie_fetcher --config config.yml，登录后回到终端按回车，工具会自动把新 Cookie 写回配置。

Q2：明明几百条作品，只抓到 20 条？现象：只下到第一页内容。原因：翻页风控触发。 解决：确认browser_fallback.enabled: true且headless: false，浏览器弹出后手动完成验证，不要急着关窗口。

Q3：下载速度很慢？现象：大量请求超时。原因：线程数过高触发限速，或网络本身波动。 解决：把thread调到 3～5，retry_times调到 5，必要时配置proxy。

Q4：个别视频下载失败？现象：部分作品报错，其余正常。原因：视频被删除、设为私密或平台临时限制。 解决：工具会自动跳过失败项继续下载，用python run.py -c config.yml --verbose查看详细日志定位原因。

Q5：文件名乱成一团？现象：文件夹里全是随机字符串。原因：没配置命名模板。 解决：设置filename_template: "{date}_{title}_{id}"，可用变量包括 date、author、title、id、点赞数等。

进阶玩法：让下载全自动

定时增量更新

打开增量开关，再用 crontab 每天自动跑：

0 3 * * * cd /path/to/douyin-downloader && python run.py -c config.yml >> download.log 2>&1

每天凌晨自动补抓新作品，配合通知推送（支持 Bark、Telegram、Webhook），手机上就能收到完成提醒。

REST API 服务模式

想把下载能力集成进自己的系统？装上fastapi uvicorn后运行：

python run.py --serve --serve-port 8000

对外提供接口后，下载记录都会进入 SQLite 档案库，支持按作者、关键词、时间范围筛选，方便二次开发和批量任务管理。

现在就去试试

1. 克隆项目，装好依赖。
2. 复制一份config.yml，填入一个视频或博主链接。
3. 运行python run.py -c config.yml，看第一个文件落盘。
4. 试试批量模式和去重效果，观察进度条与跳过记录。
5. 需要时再开启浏览器兜底、直播录制或定时任务。

工具再好也只是帮手，真正省下时间的是你迈出的第一步。把第一个视频下载下来，你会发现，自己再也不想回到"手动复制链接"的夜晚了。

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