攒了三个月的抖音素材，我用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 的抖音批量下载工具，说得很简单——"抖音上你能看的内容，它基本都能抓下来，视频、图集、合集、音乐原声都行，还带个界面。"

我半信半疑地试了试，结果那一晚不仅把攒了三个月的素材全理完了，还顺手把常看的几个博主整个主页都备份了一遍。这篇就讲讲我是怎么一步步跑起来的，包括踩过的坑。

装它比想象中简单

克隆下来，装依赖，两步搞定：

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

网络慢就加清华镜像源参数，我这边一把过，没遇到什么幺蛾子。整个项目是标准的 Python 包结构，想改哪里翻目录就行。

卡住我的只有一步：Cookie

工具本身不复杂，我第一次碰壁在 Cookie 上。抖音的内容需要登录状态才能拿到，我一开始把浏览器里复制的旧 Cookie 粘进去，跑了不到五分钟就报登录失效。后来用项目自带的自动获取方式，几分钟搞定：

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

它会自动打开浏览器，你正常登录一次抖音，回终端按一下回车，Cookie 就被写进配置了。这个我后来踩过两次坑，建议每隔一阵重跑一次，别等它彻底失效再处理。

第一次跑起来的样子

配置文件其实很薄，我第一版是这样写的：

link: - https://www.douyin.com/user/某个博主的主页 path: ./我的素材/ mode: [post, like] music: true cover: true json: true thread: 3

链接贴进 link，指定保存目录，选好要下的内容类型，然后运行python run.py -c config.yml，终端里就开始刷进度了。

看到进度条那一刻我有点意外，它把每个作品的状态列得明明白白：解析链接、排队、下载、完成，哪个环节卡住一眼就能看出来，不用像以前那样干等。

我踩的第一个坑：翻页被限流

头一天晚上跑用户主页，前二十个作品一切正常，第二十一个开始卡住不动。查了半天才弄明白，这是抖音的翻页风控，属于平台常规操作。解决办法藏在配置里：

browser_fallback: enabled: true headless: false

开启之后，API 受限时它会自动唤起浏览器完成验证，过了就能继续翻页。第一次看到浏览器自己弹出来又自己关掉，我愣了一下，后来就习惯了。

第一次批量下载：博主主页全量收藏

我常看一个美食博主，主页一百多个视频，以前只在收藏夹里零零散散存了十几个。这次直接把他整个主页加喜欢列表一起下了，顺便开了音乐和封面。

命名模板可以自己改，我用的是{date}_{title}_{id}，每个文件都带日期和作品 ID，重名也不会打架。下完的目录长这样：按作者建文件夹，里面按日期排开，视频、封面、音频、JSON 元数据各归各位。

有个细节很戳我：它会在下载前做去重。SQLite 数据库里记着每次下载的历史，第二次跑同一个博主，已经下过的直接跳过，不用我操心。

顺手把关注列表备份了一遍

后来发现不只是单个博主，关注列表也能批量处理。界面上有个"关注"页，我关注的那些创作者都在列表里，勾选几个，点一下批量下载，剩下的就是等。

那晚我把列表里二十多个账号过了一遍，中途去洗了个澡，回来发现任务中心里已经躺着一排"已完成"。

那场直播，我完整录下来了

最让我意外的是直播录制。有次想录一场游戏直播，直接把直播间链接扔进去就行：

python run.py -u "https://live.douyin.com/直播间ID" -p ./直播录制/

它会自动选清晰度开始拉流，主播下播后自动保存，录出来的文件直接就能看。

下载慢了，我是这样调参的

批量下多了之后发现，并发开太高反而容易被平台限流。我把线程设成 5，再给请求加个频率限制rate_limit: 2，也就是每秒最多两个请求，跑起来反而更稳。慢一点，但不会中途断。

最后说两句

这一周用下来，最大的感受是省心。以前收集素材是个零碎活，现在变成固定流程：想存谁的内容，配置里加一条链接，跑一遍，完事。工具解决的是效率，内容本身是创作者的心血，下载来的素材建议只用于个人学习、剪辑练习和合理引用，别拿去商用或搬运。

这个项目是开源的，遇到问题可以去提 issue，有想法就提 PR，测试和文档都挺全，参与门槛不高。打开终端，把第一条命令敲下去，希望你的素材整理也能从"一下午"变成"一顿饭的功夫"。

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