企业官网建设流程全解析

如何无水印批量下载抖音视频？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 数据库去重、翻页受限时浏览器兜底、可配并发与指数退避重试。项目还配套一个叫 Douzy 的桌面版，与命令行共用同一套后端逻辑。

粘贴链接后自动识别内容类型，点下载即可开始。

最快上手

环境要求不高，Python 3.8+ 即可，macOS、Linux、Windows 都支持。整个过程三步。

拿代码：

git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader && cd douyin-downloader

装依赖：

pip install -r requirements.txt

首次配置。最容易被忽略的一点是Cookie：工具靠它向接口换取下载地址，没配好后面全部白搭。先复制示例配置，再跑自动抓取脚本，浏览器里登录一次抖音，回终端按 Enter，Cookie 就会写进 config.yml：

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

怎么把某位创作者的作品全存下来？

在 config.yml 的link里填作者主页链接，mode决定收什么：post收全部投稿，like收点赞内容，mix收合集，music收原声，number.post控制数量，填 0 表示不限量。然后一行命令跑起来：

python run.py -c config.yml

实际跑下来，每个作品落在独立的「日期_标题_aweme_id」文件夹里，视频本体、封面、音乐、头像、data.json 分门别类。需要说明的是，封面、音乐、头像、JSON 默认都是关的，只保存视频；想留这些就翻到 config.yml 里把对应开关改成 true。并发默认 5 线程，进度条实时更新每个文件的状态。

直播也能录？

担心错过一场重要直播的话，把 live.douyin.com 的房间链接填进link，再配置live段：max_duration_seconds限制最长时长，填 0 就录到主播下播为止，idle_timeout_seconds控制网络空闲判定。录制文件以 FLV 格式落在Downloaded/{作者}/live/下，附带一份房间信息 JSON。下播、断流或手动 Ctrl+C 退出时，已经录到的部分都会保留落盘，不用盯屏。

怎么只下新作品、不重复下旧的？

靠两个配置配合。database: true把元数据记进 dy_downloader.db 这个 SQLite 库；increase.post: true是增量开关，运行时会先检查该作品的主媒体文件是否已存在于当前下载目录，存在就跳过。重复跑同一配置，只会拉取新发布的内容。反过来说，删掉本地文件下次就会重下；想强制覆盖重下，把对应模式的increase改成 false 即可。

该选哪种方式

命令行和桌面端共用同一套下载逻辑，区别在交互：

• 命令行 run.py：配置全在 YAML 里，参数显式，适合批量任务、定时脚本、Docker 部署这类场景。下载量大或长期挂在服务器上，选它更稳。
• Douzy 桌面版：可视化界面，粘贴链接即识别，任务中心能看到每个任务的进度、成功失败条数，失败任务可直接重试、打开输出目录。不想碰命令行就选它，目前处于内测期，到项目 Releases 页取安装文件即可。

每条任务记录成功或失败的条数，可单独打开文件夹或查看详情。

出错时先查这几项

• 拿不到链接、提示没权限：大概率是 Cookie 过期了，重跑python -m tools.cookie_fetcher --config config.yml刷新即可。
• 只能拉到 20 条左右：典型翻页风控，确认配置里browser_fallback.enabled: true且headless: false，浏览器弹出后手动过一下验证码，别提前关窗口。
• 担心重复下载撑爆磁盘：检查increase.post是否为 true、database是否开启。增量判断以本地文件为准，随意删文件会触发重下。
• 文件存哪了：默认在当前目录的Downloaded/下，可通过配置的path字段或-p参数改。

这套工具是社区持续维护的开源项目，代码结构清晰，遇到文档没覆盖的行为可以直接读源码：完整参数表在 README.zh-CN.md，下载主流程看 core/ 目录，Cookie 与鉴权逻辑在 auth/ 目录，各模式的配置示例则参考 README 的 Typical Scenarios 一节。

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