抖音视频下载怎么弄，才能变成一份能用的素材库：我的三个月使用记录

【免费下载链接】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 目录里，每个博主一个独立目录，目录下每个作品一个文件夹，命名是"发布日期_标题_作品标识"，里面有去水印后的视频，按需还有封面、原声和 JSON 元数据。目录根部多了一份 download_manifest.jsonl 清单，每个作品一行，记着发布日期、标题、话题标签和文件路径，找素材时直接翻这个文件就行。

任务这边：我设了一个系统定时任务，每天早上跑一次。程序按顺序刷那几个博主的主页，前一天新发的作品自动补下并归位，磁盘上已有的直接跳过。平均每周补三十到六十条新作品，全程不用我插手。我的判断：如果你要的是一个"自己会长"的素材库，这就是终点形态；如果只是偶尔存一两条，不必上这么重的目录结构。

为什么没用网页解析站：三个卡住的地方

网页解析站存单条视频够用，但归档五个博主、几百个作品时，它卡在三处。第一，它只收单条链接，面对博主主页，你得自己翻作品列表，一条条粘。第二，下下来的文件名是一串随机数字字母，要整理进自己的库还得手动改名，漏一个就乱一串。第三，它不记得之前下过什么，同一个链接再粘一次就会再下一次，磁盘里全是重复文件。

douyin-downloader 的差异对准的正是这两点：博主主页链接可以直接写进配置，程序自己翻页把作品拉下来；每个作品下完会留记录，再跑时先查磁盘上已有的，直接跳过。解析站不是不好，它是按"存一次"设计的，而我需要的是能反复跑。对只想存一条的人来说，解析站更省事；对要持续归档主页的人来说，换成可重复跑的工具才值得。

第一次跑通：从安装到出第一个结果的四步

整个过程四步，唯一需要动手的是第二步。

先克隆项目、装依赖，要求 Python 3.9 以上，同时装好 Playwright 和 Chromium，下一步的登录取 Cookie、后面的浏览器兜底都用得上：

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

依赖一条条装完，最后 Chromium 下载结束，这一步视网络快慢要几分钟。

第二步，拿登录凭证。这是全流程唯一需要你动手的一步：

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

会弹出一个浏览器窗口，登录抖音后回到终端按回车，Cookie 就自动写进配置，不用手动复制。

第三步，填目标。改 config.yml 里几个字段：link 换成博主主页地址，number 里 0 表示不限数量，完整字段清单可以看模板文件 config.example.yml：

link: - https://www.douyin.com/user/YOUR_SEC_UID path: ./Downloaded/ mode: - post number: post: 100 thread: 4

这就是一个纯文本 YAML，要改的只有五个字段。项目另附一个桌面版，下图是它的任务配置页，作品、喜欢、合集、音乐四种下载范围和数量上限，与配置里的 mode、number 字段一一对应：

第四步，执行下载：

python run.py -c config.yml

你会看到终端逐条打印每个作品的进度和跳过情况，跑完目录就按上面说的那样自动归位。把这套跑通的代价是四条命令，远比我过去手动一条条粘链接省下的半天时间划算。

值得多待的两点：浏览器兜底与增量跳过

第一点是浏览器兜底。批量刷主页翻到很多页时，接口有时会拒绝再给下一页。项目默认开着 browser_fallback，碰到这种限制就自动拉起一个真实浏览器窗口，从主页继续抓；碰上需要人工验证的地方，它会停下来等你点一下再继续。三个月的批量任务里，只有一次是我自己手动点了滑块，其余都自动走完。对你来说这意味着：批量任务的稳定性不再取决于接口当天"给不给面子"。

第二点是增量跳过。每下一个作品，都会记进 SQLite 和清单文件，下次运行先看磁盘上的主文件，在就跳过；文件丢了或是空的，会自动补下（redownload_missing_files 默认开启）。有次跑到一半断网，第二天早上再跑，那条下了一半的作品被重新下载补齐，没有留下一个几百兆的半截视频。能不能坚持用这个工具，就看这一点：你不用记得上次下过什么，也不用担心下坏什么。

用了一阵之后还在做的事：三个维护习惯

第一条，每月重跑一次 Cookie。Cookie 过期最常见的症状是"列表能抓到、文件下不动"，原因是它只有一周到两个月的有效期，这种情况不用排查别的，重跑登录命令更新即可。我设了个提醒每月刷一次，之后再没被卡过。

第二条，不提速。下载器内置每秒两次请求的限速，调高 thread 反而更容易触发风控，触发之后要降速甚至走浏览器兜底，整体更慢。所以我把 thread 保持在 3 到 5，接受慢一点，用慢换稳。

第三条，分类规则一开始就定死。命名模板支持 {date}、{title}、{id} 这类变量，我保留了默认的"日期_标题_标识"加作者目录。下过几百条之后再想改目录结构，只能靠重新下载来补，代价很高，所以别等库长大了再回头改。这三件事加起来每月花不了十分钟，换来的是不用再惦记下一次问题会出在哪。

如果只是偶尔存一两条视频，网页解析站就够，不必装这套 Python 环境；但如果你要持续把一个或多个博主的主页变成本地素材库、每天自动补上新作品，值得花二十分钟把它跑熟。下载内容只用于个人学习、研究或数据备份，请尊重平台规则和内容版权。

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