抖音批量下载完整指南：无水印视频、原声音乐和封面一次存进本地
【免费下载链接】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 是一款免费开源的抖音批量下载工具：给它一个视频链接或创作者主页，就能把无水印视频、音乐（原声）、封面和元数据一次性保存到本地，还带数据库自动去重。适合想长期存档抖音视频、教程或音乐素材的新手和普通用户。
一眼看懂这个抖音下载工具
它就是一个"命令行版的内容搬运工"：你负责贴链接，它负责抓源链接、多线程下载、按结构归档，重复跑同一位博主时自动跳过已存过的作品。先对照下表判断是否合用：
| 功能 | 说明 | 适用场景 |
|---|---|---|
| 无水印视频下载 | 解析原始直链保存，视频不带水印 | 收藏单个爆款作品 |
| 主页批量下载 | 按用户主页整批抓取作品/喜欢/合集 | 存档喜爱创作者的全部内容 |
| 音乐与封面保存 | 音乐（原声）、封面图、JSON 元数据单独落盘 | 素材收集、留档 |
| SQLite 数据库去重 | 记录已下载内容，再跑只补增量 | 定时更新博主新作 |
| 时间过滤 | 按发布日期筛选作品 | 只下某时间段的内容 |
| 多线程 + 自动重试 | 默认 5 线程，失败自动重试 | 大批量高效下载 |
快速上手：三步跑通第一次抖音下载
整个过程就是"克隆 → 装依赖 → 配 Cookie → 跑"，全程不到五分钟。
- 克隆项目并安装依赖（需要 Python 3.9+，Windows / macOS / Linux 均可）：
git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt- 配置 Cookie。Cookie 就像一张有时效的门禁卡，没有它抖音不给你开数据接口。推荐用自动获取工具，它会弹出一个浏览器让你扫码登录，随后自动把 Cookie 存进配置文件：
pip install playwright playwright install chromium python cookie_extractor.py # 扫码登录后自动保存 Cookie如果你不想装 Playwright，可以改跑python get_cookies_manual.py，按提示从浏览器开发者工具里复制 Cookie 粘贴进去即可。
- 准备配置文件并运行：
cp config.example.yml config.yml把config.yml里的链接换成你自己的，其他默认值就能用：
link: - https://v.douyin.com/你的链接/ # 换成实际链接 path: ./Downloaded/ # 保存目录 music: true # 连音乐一起下 cover: true # 连封面一起下 json: true # 保存作品元数据然后执行：
python DouYinCommand.py成功的标志：终端出现带进度条的下载动画，跑完后
Downloaded/目录下能看到.mp4视频、音乐、封面和info.json，文件名自带日期和标题，见下图的 100% 批量进度效果：
核心功能：最常用的四个场景
单条视频快速下载
不想动配置文件时，直接走命令行最省事。V1.0 稳定版支持-l直接传链接：
python DouYinCommand.py -l "https://v.douyin.com/xxxxx/" -p ./Downloaded/跑完你会在保存目录里拿到无水印 mp4，以及对应的音乐、封面和 JSON 数据。V2.0 增强版也可以用-u参数，还能加--auto-cookie让它自己处理 Cookie：
python downloader.py -u "https://v.douyin.com/xxxxx/" --auto-cookie注意版本选择：单条视频建议用 V1.0，README 里写明 V2.0 的单条下载目前存在 API 返回空响应的已知问题。
创作者主页批量下载
想整站收藏一位博主？把link换成主页链接，并设置下载模式和数量即可：
link: - https://www.douyin.com/user/你的主页 mode: - post # 发布的作品，也可选 like（喜欢）/ mix（合集） number: post: 50 # 只下最近50个；填 0 表示全量保存后按"作者/日期_标题"归档，封面、视频、音乐、元数据各就各位，文件列表效果如下：
自动去重与增量下载
这是重复追更博主的关键功能：开启增量模式后，工具会查本地数据库，已经下过的直接跳过，只补新作品。
increase: post: true # 开启主页作品增量下载 database: true # 增量依赖数据库记录，必须保持开启再跑同一位博主时，终端里会看到一排"跳过已存在"的提示，最后统计里成功数只包含新内容，省时省流量：
直播间内容抓取
普通视频之外，link里放直播间链接（https://live.douyin.com/房间号）也能工作。工具会解析出直播间标题、分区、清晰度档位和 FLV 流地址，再用你顺手的下载工具保存即可：
进阶配置与避坑指南
进阶部分只挑真正有用的三项：
- 线程与重试：
thread: 5控制并发数，retry_times: 3控制失败重试次数，网络不稳就调大重试，带宽富裕就加线程。 - 时间过滤：
start_time/end_time按YYYY-MM-DD格式填写，只下某段时期的作品。 - 目录风格：
folderstyle: true按作品建子文件夹，批量下载后更整洁。
版本怎么选，看这张对照表就够了：
| 对比项 | V1.0（DouYinCommand.py） | V2.0（downloader.py） |
|---|---|---|
| 单条视频 | 稳定可用 | 已知问题，暂不推荐 |
| 主页批量 | 正常 | 推荐，体验更完整 |
| Cookie | 手动配置 | 支持自动获取 |
常见问题按"症状 → 解决"排查：
- 症状：报 403 或"未登录"。解决：Cookie 过期了，重新跑
python cookie_extractor.py获取。 - 症状：V2.0 下载单条视频时 API 返回空。解决：换 V1.0 的
python DouYinCommand.py处理单条。 - 症状：下载速度慢或中断。解决：检查网络，调大
retry_times，中断后可直接重跑（增量模式不会重复下载）。 - 症状：一次只抓到少量作品。解决：属于翻页风控，配合增量模式分多次运行即可补齐。
- 症状：想确认哪些已下载过。解决：下载历史都记录在本地
data.db（SQLite），可用任意数据库工具查询。
现在就建起你的抖音内容库
一句话总结：douyin-downloader 让你用一条命令就能把无水印视频、原声音乐和封面连同元数据完整存进本地，追更、去重、归档全自动。
第一步：打开终端，克隆仓库、装好依赖、配一次 Cookie，然后挑一个你最喜欢的博主主页链接跑一次批量下载，10 分钟内你就能看到整整齐齐的本地存档。
合规提醒：请仅将下载内容用于个人学习、研究或备份目的，尊重创作者版权，遵守平台规则，不用于商业用途。
【免费下载链接】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
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
