抖音视频下载工具怎么用？从单条保存到作者主页批量备份，这篇攻略一次讲透

抖音视频下载工具怎么用？从单条保存到作者主页批量备份，这篇攻略一次讲透

【免费下载链接】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 正是为解决这件事而来——它是一款开源的抖音视频下载工具，既能保存单条视频、图文、合集和音乐，也能把整个作者主页批量备份到本地，甚至能在直播进行时边看边录。这篇文章的行文逻辑很简单：先抛出一个总问题，拆成四个小难题，再一个一个解决。

先把总问题摆上桌：你的"收藏"其实随时可能蒸发

内容下架、链接失效、直播转瞬即逝——这些都不是小概率事件。想真正"留住"抖音内容，至少得跨过四道坎：

douyin-downloader 对这四道坎，各自有一套顺手打法。下面逐个拆解。

装好工具：两条命令搭好环境，一条命令完成登录 🚀

先把它请到本地。复制下面三行到终端执行：

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

接下来是很多人容易卡住的一步：抖音的接口需要登录态。这里的"登录态"就是俗称的 Cookie，你可以把它理解成一张临时入场券，用来证明"这个账号在正常使用"。手工去浏览器里抠 Cookie 相当麻烦，好在项目提供了一个自动获取命令：

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

它会自动打开浏览器，你扫码登录抖音账号，然后回到终端按一下回车，程序就把登录信息写进配置文件了。全程不需要懂任何技术细节。

难题一：只想保存那一条，怎么存得干净又高清？

场景很常见：刷到一条讲得很好的教程，或者一首很喜欢的原声，想存下来慢慢回味。直接把链接丢给它就行：

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

也可以把链接写进配置文件再运行：

link: - https://www.douyin.com/video/1234567890123456789

它能识别的链接类型比想象中多：

• 视频链接/video/{id}
• 图文链接/note/{id}、/gallery/{id}
• 合集链接/collection/{id}、/mix/{id}
• 音乐链接/music/{id}，优先抓取原声文件
• 短链v.douyin.com/xxx也能自动解析成完整地址

两个小细节值得多说一句：它默认优先选择无水印的视频源，同时会对比码率参数，自动挑出最高清的那一版。换句话说，你存下来的，通常是平台上当前能拿到的最好版本。

难题二：想把一个作者的主页整个搬回家，怎么批量？

关注列表里总有那么几个博主，内容你每个都想留。手动一条条下，心态迟早崩。这时只要把作者主页链接填进去，再声明要哪些内容：

link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx mode: - post # 作品 - like # 点赞 - mix # 合集 - music # 原声音乐 number: post: 50 # 作品只取最近 50 条，填 0 表示全部

mode里每一项代表一类内容，可以自由组合；同一个作品如果既出现在作品里、又出现在合集里，程序会自动去重，不会下两遍。想看某个作者"点过赞的所有内容"，把like打开就行。

如果下载的是你自己账号的收藏夹，还有单独的玩法：把链接换成/user/self?showTab=favorite_collection，mode 填collect或collectmix，就能把收藏的作品和收藏的合集一次搬回来。

难题三：错过直播就只能等重播？不，你可以边看边录

直播内容有个特点：播完就没了，连回放都不一定留得下。想在直播进行时留存一份，用它的录制功能：

link: - https://live.douyin.com/123456789 live: max_duration_seconds: 3600 # 最长录 1 小时，填 0 则录到主播下播

录制支持 FLV 和 HLS 两种格式。主播中途下播、网络卡顿、或者你手动中断，已录下来的部分都不会丢——临时文件会自动转正保存。录制完成后，视频旁边还会附带一份直播间元数据快照（房间号、标题、时间等），方便日后回查。

难题四：下载完一大堆文件，怎么才能不乱？

这是最容易被忽略、却最影响体验的一环。工具默认按"作者 → 内容类型 → 单个作品"三层自动归档：

Downloaded/ └── 作者名/ ├── post/ │ └── 2024-02-07_作品标题_1234567/ │ ├── video.mp4 │ ├── cover.jpg │ ├── music.mp3 │ └── data.json ├── like/ ├── mix/ ├── music/ └── live/

每个作品一个独立文件夹，视频、封面、音乐、元数据各归其位。文件名采用"日期_标题_ID"的模板，一眼就能认出内容。桌面版里甚至可以自定义命名模板，把 15 个可用变量自由组合。

真正省心的还在后面——SQLite 数据库去重。每下载一条，程序都记录在案，下次再碰到同一个 ID 直接跳过。配合增量开关，定期更新一个博主的内容会变得很轻松：

increase: post: true # 只下载之前没有的新作品 database: true

想只留某段时间内的内容？start_time和end_time两个参数就能圈定范围。下载历史随时能查：

sqlite3 dy_downloader.db "SELECT aweme_id, title, author_name FROM aweme ORDER BY download_time DESC LIMIT 20;"

进阶玩法：当你不满足于"下载"这件事本身 ⚡

基础四关过了，下面这几个功能属于"锦上添花"，但都挺实用。

采集评论：把"评论区"也一起带走

想分析一个作品的讨论热度？打开评论采集：

comments: enabled: true include_replies: false # 设为 true 会额外抓二级回复 max_comments: 500 # 0 表示不限量

每条作品的评论会单独存成一份 JSON 文件，方便后续做数据分析。

热搜与搜索：发现新内容，也存得下来

想看看抖音当下在热什么？两个命令就能拿到快照：

python run.py --hot-board 30 # 热搜榜前 30 名 python run.py --search "猫咪" --search-max 100 # 关键词搜索结果

结果以 JSONL 格式落到本地，适合定时抓取做观察记录。

视频转写：把口播内容变成文字稿

需要把视频里的讲解转成文字？可选的转写功能接入了 OpenAI 的语音识别接口，下载完视频后会自动生成.txt和.json两份文稿，之后想检索某句话，直接翻文字稿就行。

完成通知：下载完，手机先知道

下载任务在后台跑，你可以放心去忙别的。结束后通过 Bark、Telegram 或 Webhook 推送一条消息到手机，任务成功或失败都有反馈。

REST API 服务：把下载能力嵌进你自己的系统

想给下载功能做个自动化外壳？一条命令就能把它变成 HTTP 服务：

pip install fastapi uvicorn python run.py --serve --serve-port 8000

之后用POST /api/v1/download提交链接，用GET /api/v1/jobs/{job_id}查询进度，适合接进工作流里批量调度。

桌面版：不想碰命令行，也有图形界面

如果对终端天然排斥，项目还提供了一个叫 Douzy 的桌面客户端：粘贴链接即刻开始下载，能同步关注列表，有任务中心和作品档案，下载进度实时可见。底层配置和命令行完全共用，怎么顺手怎么来。

踩坑自救：三个高频问题的补救办法

再顺手的工具也会遇到状况，下面三个问题出现频率最高，附上解法。

问题一：只能抓到 20 条作品，后面的全没了？

这是抖音翻页风控的正常现象。解决办法是打开浏览器兜底功能，让程序在翻页受限时启动真实浏览器：

browser_fallback: enabled: true headless: false

浏览器窗口弹出后，手动完成一下验证，程序就能继续往下翻。

问题二：提示 Cookie 失效？

登录态是有有效期的，失效后重新执行自动获取命令即可：

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

问题三：想重新下载某个作品，怎么触发？

程序靠"数据库记录 + 本地文件"双重检查来判断是否跳过。想重下某一条，把对应的本地文件夹删掉，再删掉数据库里那条记录，重新运行即可。具体命令在README.zh-CN.md的"重新下载"一节有详细说明。

写在最后

回到开头那个问题：抖音的内容，到底能不能真正"留住"？我的答案是能，但前提是你有一套顺手的工具，并且养成"下载即归档"的习惯。douyin-downloader 的完整配置项、输出目录说明和测试方法，都能在项目文档里找到——README.zh-CN.md讲全貌，USAGE.md讲用法，config.example.yml是一份可以直接照着抄的起点。

把喜欢的教程、欣赏的创作、珍贵的回忆，变成自己硬盘里随时可读的文件，这本身就是一件很有价值的事。不过在动手之前也提醒一句：工具再好，也请把它用在个人学习、资料备份这些正当用途上，尊重每一位创作者的劳动。合理使用，才能长期受益。

好了，链接已复制，配置已就绪。下一个被你成功保存下来的视频，可能就是你最舍不得删的那条。

Meta Title 候选：抖音视频下载工具怎么用？单条保存、作者主页批量备份、直播录制一次讲透

Meta Description 候选：开源免费的抖音视频下载工具 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