手动存了50个抖音视频后，我换成了这个批量下载器，一次跑通全流程

手动存了50个抖音视频后，我换成了这个批量下载器，一次跑通全流程

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

上周为了做一期混剪素材，我对着抖音一个个点保存，再找去水印网站逐条处理，折腾到凌晨两点还剩20个没搞定。第二天朋友扔给我一个开源工具douyin-downloader，说是能去水印、支持批量下载和原声提取，我抱着试试的心态跑了一遍，现在混剪素材两分钟就齐了。这篇文章就是我从踩坑到跑通的完整实录，跟着做你也能一次成功。

它到底是个什么工具

一句话：douyin-downloader就是一个能把你从"复制链接→去第三方网站→挨个下载→再处理水印"这条老路上解放出来的命令行下载器。它跟同类工具最大的区别是——输入一个用户主页链接，就能把这个账号下所有作品、合集、甚至原声音乐一次性扒下来，还带SQLite去重和失败重试，不用你盯着屏幕。

从零跑通：我的完整实操过程

第一步：克隆项目装依赖，踩了第一个坑

先把项目拉到本地：

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

这里我栽了个跟头：用的Python版本太老，装依赖时报了一堆错。后来换成Python 3.9以上重新装就一路顺利，看到"Successfully installed"就说明环境OK了。建议你动手前先python --version确认一下。

第二步：搞定Cookie，这是唯一的手动环节

抖音没登录状态基本什么都拉不到，所以要先准备Cookie。项目给了两个方案：

• 自动获取（推荐新手）：运行python cookie_extractor.py，它会自动弹出一个浏览器窗口，你在里面扫码登录，登录完Cookie自动帮你存好，全程不用复制粘贴。
• 手动获取（不想装Playwright）：运行python get_cookies_manual.py，按提示打开抖音网页版登录，F12进开发者工具，在任意请求的Request Headers里找到Cookie整串复制，粘贴回去就行。

我最初嫌麻烦选了手动，结果复制时多带了一个引号，解析直接报错。重跑脚本重新粘贴后就好了。这个脚本还挺贴心，会顺手把Cookie备份成带时间戳的文件，过期了还能翻出来对比。

第三步：改配置文件，别被示例吓到

项目里给了config.example.yml这个示例，我建议直接复制一份再改：

cp config.example.yml my_config.yml

打开它，真正需要动的只有几行。我的配置长这样：

link: - https://v.douyin.com/你的链接/ path: ./我的视频库/ music: true # 下载原声音乐 cover: true # 下载封面 json: true # 保存元数据 thread: 5 # 5线程并发

link这一项最灵活：放单条视频链接就下单个作品，放用户主页链接就会把整个主页的作品全部下载，还可以同时列多个链接，一个配置文件处理一批任务。thread控制并发，普通宽带5就很稳。

第四步：运行，然后看着进度条发呆

配置好直接跑：

python DouYinCommand.py -c my_config.yml

第一次运行我盯着终端看了半天，绿色进度条逐条跳动，先是"正在请求用户主页下作品"，然后每个文件显示下载进度和耗时。最让我惊喜的是它遇到已经下载过的文件会直接跳过——靠SQLite数据库记录文件标识，同一个作品下载第二次就是秒跳过，不会白白占空间。如果中途断网，重跑一遍它会从断点接着来，失败的任务也会自动重试。

这就是我当时看到的批量下载进度界面，每个作品的视频、封面、头像状态一目了然，下载过的直接标记跳过

第五步：看看下载到的东西长什么样

打开我的视频库文件夹，结构比我预想的整齐得多——按作者分目录，每个作品再按日期和标题建子文件夹，视频、音频、封面、元数据JSON各归其位。想找某天的素材，翻目录就能定位，不用在几千个文件里大海捞针。

按日期和作品标题分类的文件夹结构，每个文件夹里视频、封面、元数据都齐了

直播也能录

有个晚上想录一个吃鸡主播的直播，我直接换了个命令：

python DouYinCommand.py -l "https://live.douyin.com/直播间ID"

它会先解析出直播间信息、弹出一堆清晰度选项，选好后自动拉流录制。

命令行里选择直播清晰度，工具会自动解析出直播流地址并开始录制

我踩过的坑，希望你避开

Q：下载速度特别慢，是不是工具不行？一开始我也这么想，后来才发现是我自己配置的问题。默认单线程下载当然慢，把配置里的thread调到5后速度肉眼可见地涨。另外下载高峰时段（晚上8-10点）抖音接口本身也慢，避开这个时段会顺很多。

Q：为什么突然开始报错，昨天还好好的？十有八九是Cookie过期了。抖音的Cookie一般7-30天失效，失效后的典型症状就是获取作品信息失败。这时候重新跑一次python get_cookies_manual.py更新Cookie就行，项目里也设计了自动重试，但Cookie本身失效了重试也没用，只能换新的。

Q：下载到一半断网了，之前下的会不会白费？不会。得益于SQLite去重和断点续传，重新运行命令它会先检查数据库里哪些作品已经下载完成，直接从断点继续，已完成的自动跳过，省时省流量。

想更进一步？这几个技巧够你用一阵子

1. 按时间范围过滤：配置里加start_time和end_time（格式2024-01-01），就能只下载某个时间段的作品，追更博主时特别实用。
2. 只下喜欢的作品：链接放用户主页时，把mode从post改成like，就能批量下载对方公开的喜欢列表。
3. 限制下载数量：number下面设post: 20，就只下最新20个作品，适合先试水再决定要不要全量。
4. 定时自动更新：配合crontab每天凌晨跑一次增量下载，指定increase开启增量模式，你的素材库会自动保持更新，我现在的素材库就是这么维护的。

写在最后

回到开头那个凌晨两点——现在同样一批素材，我只需要把链接粘进配置文件，跑一条命令，然后去泡杯咖啡。这不是什么黑科技，就是一个把"重复劳动"压缩成"一条命令"的实在工具。别犹豫，现在就照着上面的步骤跑第一条命令，你的第一个无水印视频很快就会出现在下载目录里。

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