想存抖音视频却要录屏？开源工具 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 工具，单条视频、整个主页批量下载、直播录制、去水印保存，一条链路全包。

它替你把哪些事干了？

先说清楚这东西能省你什么时间，再看怎么用。

• 刷到想存的视频：贴链接，它自动解析并选无水印的最高清源。
• 想囤某个博主：贴主页链接，作品、点赞、合集、原声按模式各取各的。
• 想长期跟踪博主：开增量下载，下次只拉新发的，旧的跳过。
• 担心错过直播：挂着录，下播自动落盘，断网已录的部分也保留。

3 步配好 Cookie，就能跑起来

整个上手路径很短，我按自己操作过的顺序列一遍。

先把代码拉到本地：

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

装依赖，纯 Python 生态，没有额外环境负担：

pip install -r requirements.txt

最关键一步是Cookie——相当于你访问抖音的门票，没有它拿不到下载链接。项目自带浏览器提取脚本（tools/cookie_fetcher.py），它会开一个浏览器让你登录一次，回终端按回车，Cookie 自动写进配置：

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

注意：这个脚本依赖 playwright，首次用先pip install playwright装一下。

批量下载实测：一条链接能走多远

配完直接跑，配置文件里的链接加命令行追加的链接会一起下载，-t调并发：

python run.py -c config.yml -u "https://www.douyin.com/video/xxxxx" -t 5

我拿一个博主的主页链接试了批量模式，终端里 Rich 进度条实时滚动，能看清当前在解析、拉取还是写盘，失败会按 1s、2s、5s 指数退避重试。落盘结构是作者 → 日期_标题_ID，一个作品一个文件夹，视频、封面、元数据分门别类。同一博主跑两遍，第二遍基本是"跳过"，因为底层用 SQLite 记了账（storage/database.py 里能看到去重和历史记录的实现）。

结论：短链长链都认，批量稳，文件不乱堆。

不想敲命令？桌面版把流程搬进了图形界面

不想碰终端的话，项目配套了桌面客户端 Douzy，同一套后端，操作就三步：贴链接、勾选内容、点下载。

粘贴链接即自动识别类型，点"下载"即可，不用配置任何文件。

任务中心里每个任务的成功数、失败数、日志都摊开，失败项能单独重试。

每个任务的成败计数与详情一目了然，失败的可单独重跑。

和同类工具比，哪两点最实在

同类工具大多停在"给链接、出视频"。我体感拉开差距的是两块。

去重和增量是默认开的习惯

SQLite 记录加本地文件双重校验，重复跑只补新内容；配合increase开关，跟踪一个日更博主一个月，磁盘也不会塞满重复文件。

风控兜底是真实存在的

API 翻页被限时，它会自动切浏览器兜底，卡在验证码时留了人工介入的口子，而不是直接报错让你自己想办法。

排坑手册：4 个高频问题速答

• 提示拿不到链接、没权限→ 九成是 Cookie 过期，重跑一次 cookie_fetcher 即可。
• 翻到一半被卡住→ 是风控，让浏览器兜底接手，必要时手动过一次验证码。
• 重复下载浪费流量→ 确认database: true，并按需打开对应模式的增量开关。
• 文件不知道存哪了→ 默认在项目下的 Downloaded 目录，命令行-p参数随时改路径。

更多细节可以翻 config/AGENTS.md 了解全部配置项，或者看仓库里的 README.zh-CN.md，场景示例很全。

最后

一句话：一个开源免费的抖音下载器，单条、批量、直播、去重归档全链路跑通，上手成本就是装依赖加配一次 Cookie。现在就去试一条你最近想存的主页链接——你平时最想让哪个博主的作品进本地仓库？

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