抖音视频批量下载、直播录制与素材整理一次搞定：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

凌晨一点，我翻着抖音收藏夹里300多个"先存后看"的视频叹气——真正保存下来的只有手动存的7个，剩下的不是被作者删掉，就是再也找不到了。直到朋友甩给我一个叫 douyin-downloader 的开源下载工具，我花十分钟搭好环境，从那以后，我的收藏夹再也没有"吃灰"这回事。

说白了，它就是一个会替你干活的下载管家：你把链接扔给它，它自己排队、去水印、挑最高清、失败自动重试，最后把视频、封面、背景音乐和元数据整整齐齐码进硬盘。你只需要泡杯茶，等着看进度条从0走到100%。

三步跑通环境：从零到第一条命令

别被"开源工具"四个字吓到，全程不需要懂任何代码，照抄命令就行。

第一步：把项目拉下来并装依赖

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

需要 Python 3.8 及以上，Windows、macOS、Linux 都能跑。这步是地基，不做的话程序根本起不来。想白拿"浏览器兜底"和"自动取Cookie"两个能力，再补一句pip install playwright加python -m playwright install chromium，不装也不影响先用起来。

第二步：复制一份配置文件

cp config.example.yml config.yml

项目自带的示例配置就是开箱即用的，复制一份自己改，避免动坏模板。不做这步，程序找不到config.yml会直接报错。

第三步：自动获取 Cookie，告别手动复制粘贴

很多人在抖音下载器上翻车，都是卡在浏览器里翻开发者工具复制 Cookie。这里只需要一条命令：

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

它会自动打开浏览器，你正常登录一次抖音，回到终端按一下回车，认证信息就自动写进配置了。不做的后果很直接：抖音会把你看作游客，翻两页就被风控拦下，只能抓到零星几条。

三步走完，试试第一条命令——把你想保存的视频链接丢给它：

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

下载完成后，目录里会同时出现视频本体、封面图、背景音乐和一份 JSON 元数据，这个作品的所有信息都被完整留存了。

场景一：单个视频下载，一条命令收进硬盘

刷到特别喜欢的视频想存下来反复看，传统做法是找在线去水印网站——传链接、等解析、防弹窗广告，还得担心网站哪天跑路。用 douyin-downloader 就一行命令的事，-u后面接链接，-c指定配置文件，多个链接还能反复传，一次下完。

上图就是它下载时的真实样子：每一条任务都带着进度条跑，全部到 100% 后自动收工，中途不需要你操作任何东西。

场景二：作者主页整页打包，一份配置全带走

发现一个宝藏创作者，想把他的作品、点赞过的视频、做的合集、用的原声全部保存？手动操作想想就劝退，这里只需要一份配置文件：

link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx # 创作者主页链接 path: ./Downloaded/ mode: - post # 下载发布的作品 - like # 下载点赞的作品 - mix # 下载合集内容 - music # 下载音乐作品 number: post: 50 # 下载 50 个发布作品 like: 0 # 0 表示不限制数量，全部下载

填好链接和数量，运行python run.py -c config.yml，程序会自动按作者名建好目录，作品、点赞、合集、音乐分门别类存放，同一个视频在不同模式下也绝不会重复下载。

看上图，这是批量下载时的真实状态：自动抓到 274 个作品、按时间范围过滤、已存在的内容直接跳过、5 个线程并发下载。你盯着进度条喝水就行。

场景三：直播录制自己动手，错过不再补不回来

直播和短视频不一样，结束就是结束，官方不一定有回放。知识分享、教学、赛事这类内容，错过一场可能真的补不回来。在配置里加上直播链接和录制参数：

link: - https://live.douyin.com/123456789 live: max_duration_seconds: 3600 # 录制 1 小时，0 表示录到主播下播 chunk_size: 65536 idle_timeout_seconds: 30

它会自动解析出直播流地址，支持 FLV 和 HLS 两种格式。最贴心的是，就算主播中途下播、网络断开，或者你按 Ctrl+C 中断，已经录下来的内容也会保留，不会白录一场。录好的文件存在Downloaded/作者名/live/目录下，还附带一份直播间信息快照。

三个冷门但好用的隐藏能力

增量下载：给素材库当记账本。批量下载最怕重复——今天下过的明天又下一遍，硬盘白占空间。在配置里加两行：

database: true # 开启数据库去重和历史记录 increase: post: true # 增量模式：只下载新发布的作品

之后它就像个记账本，上次下到哪一集、哪些存过，心里全有数，下次运行只补新内容。

评论采集：评论区一键打包。想留存某个作品的完整讨论？开启comments.enabled: true，每个作品旁会多出一份*_comments.json，连二级回复都能带出来，适合做内容研究。

下载完成手机通知。批量下载动辄几十分钟，不用干等。配置notifications后，支持 Bark、Telegram 和企业微信、飞书、钉钉这类 Webhook 机器人地址，下完自动推送到手机。

避坑清单：新手最容易翻车的三个问题

问：为什么只能抓到 20 条作品？这是抖音翻页风控的常见现象。确保配置里browser_fallback.enabled: true，浏览器窗口弹出后手动过一下验证码，别急着关窗口，程序会自己继续翻页。

问：Cookie 失效了怎么办？重跑一次自动获取命令，几十秒搞定：python -m tools.cookie_fetcher --config config.yml。

问：下载速度慢，或者想重新下载怎么办？把thread从默认 5 调到 8 试试；重新下载时记得数据库记录和本地文件要一起清，只删一边都不会触发重下。

最后多说一句：工具让下载变得简单，也请把它用在正道上——遵守平台规则、尊重创作者版权，下载的内容仅供个人学习研究。

现在就可以做三件事：① 克隆项目并安装依赖；② 跑一次 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