抖音视频怎么下载保存到本地？三步搭好抖音批量下载工具

抖音视频怎么下载保存到本地？三步搭好抖音批量下载工具

【免费下载链接】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 就是这样一个免费开源的抖音批量下载工具：粘贴链接即可下载视频、图集、合集、音乐，还支持作者主页整页批量保存、直播回放录制和 SQLite 去重，让你把喜欢的作品永久留在本地。

一分钟了解它能做什么

背后的实现也很扎实：并发下载、失败重试、速率限制、浏览器兜底、评论采集、通知推送、REST API 服务模式一应俱全，核心源码集中在douyin-downloader/core/和douyin-downloader/cli/目录。

从零到第一次成功运行，只要四步

先别急着研究配置，按下面四步走，最快一分钟就能看到第一个文件落地。

第一步：获取项目代码并安装依赖

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

第二步：自动获取登录 Cookie

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

这条命令会打开浏览器，你登录一次抖音账号后回到终端按回车，程序会自动把 Cookie 写入配置。说白了，这一步就是让下载器"拿到你的入场券"，否则只能下载到极少内容。

第三步：复制示例配置

cp config.example.yml config.yml

第四步：运行下载

python run.py -c config.yml

如果一切正常，你会看到类似下图的批量下载进度界面，下载完成的文件会自动落到Downloaded/目录。

两个最常用的下载场景

场景一：批量保存一位作者的全部作品

想收藏某个博主的所有视频？把config.example.yml里改成：

link: - https://www.douyin.com/user/MS4wLjABAAAA6O7EZyfDRYXxJrUTpf91K3tmB4rBROkAw-nYMfld8ss mode: - post number: post: 50 # 只下载最近50个作品

mode支持post（作品）、like（点赞）、mix（合集）、music（音乐）等多种模式，还能组合使用：

mode: - post - like - mix - music

下载后的目录会自动按"作者名 → 分类 → 日期_标题_作品ID"组织，每个作品独立文件夹里装着视频、封面、音乐、头像和原始 JSON 数据：

这里有个小细节：filename_template: "{date}_{title}_{id}"决定了命名格式，模板里至少要保留{id}，否则重名作品会被覆盖。想随时调整命名规则的，可以改folderstyle、folder_template和author_dir这几个字段。

场景二：录制正在进行的直播

遇到重要直播又没空看？直接把直播间链接填进link，再开启直播录制：

link: - https://live.douyin.com/123456789 live: max_duration_seconds: 3600 # 0 表示录到主播下播

工具支持 FLV/HLS 格式录制，主播下播后已录制的数据会自动保留，还会生成直播间元数据快照，方便后期回看整理。

三个进阶玩法，让下载体验再上一个台阶

玩法一：增量同步 + 时间筛选，只下新内容

如果你把某个作者的收藏当作"追更"，重复下载不仅浪费流量还容易翻页受限。开启增量下载后，SQLite 数据库会记住哪些作品已经下载过：

increase: post: true like: true database: true # 开启 SQLite 去重 start_time: "2026-01-01" # 只下载这个时间之后的内容 end_time: "2026-12-31"

想查看下载历史？直接查数据库：

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

玩法二：热搜榜与关键词搜索，捕捉流行内容

它不只是个下载器，还是个内容发现工具：

# 拉取抖音热搜榜前30名，导出 JSONL python run.py --hot-board 30 # 搜索"猫咪"相关内容，最多100条 python run.py --search "猫咪" --search-max 100

玩法三：评论采集、语音转文字与 REST API

想分析评论区？开启评论采集后，每个作品会额外生成*_comments.json：

comments: enabled: true include_replies: false max_comments: 500

transcript配置项还支持把视频语音转成文字稿（需自备转录 API Key）。如果你是自动化爱好者，pip install fastapi uvicorn后运行python run.py --serve --serve-port 8000，就能通过 HTTP 接口提交下载任务，把下载能力集成进自己的工作流。

新手最容易踩的四个坑

1. 只下载到20条就停了：这是抖音的翻页限制，不是 bug。确认browser_fallback.enabled: true已开启，必要时把headless改为false手动完成验证码验证。
2. 提示 Cookie 失效：登录态过期是常态，重跑一次python -m tools.cookie_fetcher --config config.yml即可；新版还支持检测到未登录时自动重新登录并重试。
3. 下载速度慢：thread: 5控制并发线程数，网络好可以调高；遇到限速可在proxy字段配置代理。
4. 命名混乱难管理：确认filename_template包含{id}，日期前缀来自作品发布时间而不是下载时间，配合folderstyle: true就能得到清晰的文件结构。

把工具用起来，才算真正拥有它

这份指南覆盖了从单条视频下载、作者主页批量下载，到直播回放录制、增量去重和 API 集成的完整路径。想深入了解每个配置项的细节，可以翻翻项目里的config.example.yml（每个字段都有中文注释）和USAGE.md；想读源码的，推荐从douyin-downloader/core/url_parser.py看起，它解释了链接是如何被识别为视频、用户还是直播的。

工具始终只是工具，请遵守平台规则、尊重创作者版权，把下载的内容用于个人学习研究。现在，打开终端跑起你的第一条命令，把那些舍不得删的视频，安安全全地存进自己的硬盘吧。

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