抖音下载工具 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

刷到一条超棒的教学视频，想存下来慢慢学，结果第二天作者删了；喜欢的博主攒了几百条作品，手动一条条保存到手抽筋；录屏倒是省事，可画质糊成马赛克，还顶着一个大 Logo……如果你也被这些小事反复折磨，那么今天这个完全免费、开源的抖音下载工具douyin-downloader，大概率就是你的"救命稻草"——它主打无水印下载，视频、图集、合集、原声音乐都能批量搬回家，还自带进度展示、断点续传和智能去重，堪称抖音内容备份的一站式解决方案。

内容说删就删，你舍得那些收藏吗？🎯

先问个扎心的问题：你手机相册里存的那些抖音视频，有多少是你真正"拥有"的？

大概率都不是。它们只是存在别人服务器上的一串链接——创作者可以随时删除，平台可以随时下架，等你哪天想回头再看，只剩一片空白。更别提那些"过目就忘"的操作流程了：

• 逐条长按保存：几十条还能忍，几百条直接崩溃，而且自带水印，画质还被压缩过；
• 录屏：能救急，但屏幕上的点赞、评论、滚动全被录进去，裁剪到怀疑人生；
• 在线解析网站：单次一个链接，一会儿弹广告，一会儿限流，还经常白忙一场。

你是不是也遇到过"当时没存，后来再也找不到"的遗憾？与其等视频消失了再后悔，不如一开始就把它完整、干净地存进自己的硬盘。

30 秒看清：它凭什么能打？🚀

不吹不黑，直接上一张对比表，你一眼就能看出差距：

简单说，这个工具解决的是三个核心诉求：内容完整（无水印+原声+封面）、批量高效（一次拉全）、长期可管理（去重+归档）。而它最贴心的一点是：下载完每个作品，还会自动生成一份完整的元数据 JSON——标题、发布时间、点赞评论数、话题标签全都有，相当于给每一条内容都建了个"档案卡"。

粘贴链接、点一下检测，下载入口就是这么直接。

3 分钟跑起来：让第一个视频落地 📦

别被"命令行工具"四个字吓到，整个上手过程其实就是四步，跟着我一步步来就行。

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

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

小贴士：需要 Python 3.8 或更高版本；如果 pip 下载慢，可以临时换成国内镜像源，比如pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple。

第 2 步：准备 Cookie（抖音访问的"通行证"）

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

运行第二条命令后，浏览器会自动打开抖音登录页，用手机扫码登录，回到终端按一下回车，工具就会自动把 Cookie 写进配置文件。整个过程不需要你手动复制粘贴任何东西，Cookie 也只会保存在你自己电脑上。

第 3 步：把要下载的链接写进配置

link: - https://v.douyin.com/XXXXXXX/ # 想下载的视频短链，粘贴进来即可 path: ./Downloaded/ # 文件保存目录 music: true # 顺手把原声也下载下来 cover: true # 封面图也要 json: true # 保存作品元数据档案 database: true # 开启数据库去重，重复下载自动跳过

第 4 步：跑起来！

python run.py -c config.yml

命令行模式下，每一条任务的下载进度、去重跳过情况都一目了然。

第一次跑通后你就能看到：视频、音乐、封面按目录整理得明明白白，进度条实时滚动，整个过程安静又可靠。如果中途断网或文件没下完整，工具会自动比对文件大小，不完整的直接清理重试，不用你操心。

玩出花：三个玩法让工具物尽其用 🎮

跑通基础功能只是开胃菜，下面这几个玩法才是这个工具真正让人"上瘾"的地方。

玩法一：把喜欢博主的整个主页"搬"回家

遇到一个高质量创作者，与其一天天担心他删作品，不如一次性把主页全量备份。只需要把链接换成博主主页地址，再指定下载模式：

link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx # 博主主页地址 mode: - post # post=作品，like=点赞，mix=合集，music=音乐 number: post: 0 # 0 表示全部下载，填 50 表示最近 50 条 start_time: "2025-01-01" # 可选：只下 1 月之后发布的作品 end_time: "2025-06-30" increase: post: true # 开启增量：下次运行只补新增内容

配合database: true，第二次运行时会自动跳过所有已下载的作品——只补新、不重下，追更博主的作品集就像订阅了一个"本地频道"。

同步关注列表后，想追的博主一键全收，不用再手动复制链接。

下载完你会得到这样的目录结构，每条内容都是一个独立小档案：

Downloaded/ └── 某知识博主/ ├── 2025-03-12_零基础学Python_7341…/ │ ├── video.mp4 # 无水印视频 │ ├── music.mp3 # 原声音乐 │ ├── cover.jpg # 高清封面 │ └── info.json # 完整元数据 └── 2025-03-08_数据可视化技巧_7339…/ └── ...

文件名、文件夹名都能自定义模板，比如{date}_{title}_{id}，时间、标题、ID 一目了然，归档检索非常舒服。

玩法二：只要原声和封面，视频不占地方

有时候你根本不需要视频本体——比如只想收藏某首歌、存几张封面当壁纸。这时把video相关选项关掉，只留音乐和封面：

music: true # 只要原声 cover: true # 只要封面 json: false # 不需要元数据就关掉

这样下载完就是"轻量收藏"，硬盘压力小得多，特别适合囤音乐素材的场景。

玩法三：直播也能录进硬盘

遇到重要的直播内容（比如在线讲座、发布会），这个工具还能直接录制直播流，支持 FLV 和 HLS：

link: - https://live.douyin.com/123456789 # 直播间地址 live: max_duration_seconds: 3600 # 录制 1 小时；填 0 表示录到主播下播

就算中途断网或手动中断，已经录下的字节也会被保留下来，不会白录一场。直播录完还能配合评论采集功能，把整场直播的讨论一起沉淀下来。

直播录制模式会识别清晰度并自动抓取直播流，录到主播下播为止。

这些隐藏技能，顺手就能开 🔧

除了下载，工具还内置了一批"彩蛋级"功能，都是在配置文件或命令行里加一行就能用：

• 热搜榜快照：python run.py --hot-board 30 -p ./Downloaded，把当天抖音热搜前 30 条导出成 JSONL，做选题、做热点分析都很方便；
• 关键词搜索：python run.py --search "猫咪" --search-max 100，按关键词拉取作品信息，快速摸底某个话题；
• 评论采集：配置里打开comments.enabled，每个作品会额外生成一份结构化评论 JSON，支持二级回复；
• 完成通知：配置notifications后，下载完成可以推送到 Bark、Telegram 或企业微信 Webhook，挂着下载、到点提醒；
• REST API 服务模式：python run.py --serve --serve-port 8000，把下载能力封装成接口，接进自己的自动化系统；
• 视频转写：可选接入 OpenAI 转写接口，给每个视频生成文字稿，做内容库检索特别好用。

避坑锦囊：新手最容易踩的 5 个坑 ⚠️

把这些坑提前告诉你，能帮你省下大量折腾时间。

坑 1：一上来就报"403 / 未登录"→ 大概率是 Cookie 过期了，Cookie 有效期一般 7-15 天。重新运行python -m tools.cookie_fetcher --config config.yml换新的即可。工具还内置了自动重新登录：检测到登录失效时，会弹出浏览器让你扫码，完成后自动续跑。

坑 2：批量下载只能抓到 20 条左右→ 这是抖音翻页风控的常见现象。在配置里开启浏览器兜底，让它用真实浏览器滚动翻页：

browser_fallback: enabled: true headless: false # 弹窗出现时手动完成一下验证，别急着关窗口

坑 3：下载到一半很慢或总中断→ 先看线程数，默认 5 个并发，可以在配置里调thread: 8或命令行加-t 8。再确认database: true已开启，配合断点续传，中断后重跑会自动跳过已完成的部分。

坑 4：文件堆成一坨，根本找不到哪个是哪个→ 在配置里启用命名模板，让每个文件名自带时间和标题：

folderstyle: true filename_template: "{date}_{title}_{id}"

坑 5：同一个视频被重复下载→ 只要开着database: true（默认开启），工具会同时用数据库和本地文件做双重去重；再配合increase增量模式，跨模式、跨批次都不会重复拉取。

把抖音交给自己的硬盘，什么时候都不晚 🌟

说到底，这个工具适合谁？我觉得是这三类人：

• 内容创作者：想沉淀竞品、同行的优秀案例，建立自己的素材库；
• 知识囤积党：刷到好课、好教程想离线反复看，不依赖网络和平台；
• 一切"怕内容消失"的人：把心动的瞬间、重要的直播、有用的攻略，安安心心备份下来。

给你的行动建议：

1. 先用一个单视频跑通流程，确认环境没问题；
2. 再挑一个常看的博主，体验一次全量批量下载；
3. 顺手把increase增量打开，以后每次只需一条命令追更；
4. 定期检查磁盘空间，养成"下载即归档"的好习惯。

最后多说一句：工具本身免费开源，但它帮我们保存的内容凝结着创作者的心血。请合理使用，仅用于个人学习、研究和备份，尊重原创作者的劳动成果，不要用于商业用途或侵犯他人版权。

工具再好，也只是把选择权交还给你——从今天起，你的抖音收藏，由你自己保管。🚀

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