抖音无水印批量下载完整指南：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
当你想把抖音作品留在本地，或把某位作者的更新存到电脑上时，水印、文件散乱和重复下载是最常见的麻烦。douyin-downloader 是一款免费的抖音无水印批量下载工具：支持视频、图集、合集和原声，内置 SQLite 去重、重试和进度显示，配置好之后就能开始第一次下载。
📦 项目一览
- 一个 Python 命令行工具，要求 Python 3.9+，Windows、macOS、Linux 都能跑。
- 适合三类人：需要归档作品的个人、定期保存某位作者更新的粉丝、做内容研究的人。
- 能下载单个作品、作者主页的作品/合集、音乐（原声）和直播间，默认就是无水印的 API 直连地址。
- 已下载的作品记录在本地 SQLite 数据库里，重复运行会自动跳过；失败默认重试 3 次。
- 两个入口：V1.0 稳定版
DouYinCommand.py（单个作品、合集、直播），V2.0 增强版downloader.py（主页批量、Cookie 自动获取）。
图：一次批量下载完成后，作品按封面加标题、日期分文件夹保存。
🚀 从零到第一次下载
克隆仓库并进入目录：
git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader安装项目声明的全部 Python 依赖：
pip install -r requirements.txt复制示例配置生成正式的config.yml，之后所有改动都只编辑这一个文件：
cp config.example.yml config.yml首次使用需要抖音登录态，这条命令会打开浏览器，扫码登录后把 Cookie 保存到本地：
python cookie_extractor.py把任意一个作品的分享链接（v.douyin.com 短链）填进config.yml的link字段，然后运行：
python DouYinCommand.py跑完后打开./Downloaded/目录，可以看到无水印视频、音乐、封面和一份元数据 json。
核心用法
保存单个作品
视频或图文作品，把分享链接放进config.yml的link字段，运行python DouYinCommand.py即可。不想改配置文件时，直接在命令行传参：
python DouYinCommand.py -l "https://v.douyin.com/xxxx/" -p ./Downloaded/批量保存一位作者的作品
把link换成作者主页链接（浏览器地址栏里www.douyin.com/user/开头的那串），mode填post（发布的作品）或like（喜欢的作品），用number.post限制条数，0 表示全部。
图：进度条列出每个作品的下载状态，数据库里已存在的作品显示"跳过已存在"，不重复下载。
时间过滤在这里很实用：只填start_time和end_time（格式 YYYY-MM-DD），就只会拿到该时间段内的作品，适合按月份整理。
录制一场直播
V1.0 支持直播：把live.douyin.com的链接放进link运行，终端会解析出直播间的清晰度列表（FULL_HD1 / SD1 / SD2）让你选一个，随后输出对应的流地址。
图：终端展示直播间信息、可选清晰度以及对应的流媒体链接。
拿到流地址后交给 ffmpeg 或任意下载工具落盘即可，终端同时会把解析信息存到 result.json 备查。
⚙️ 关键配置速查
完整选项见 config.example.yml，日常最常用的就这几项：
| 配置 | 默认值 | 说明 |
|---|---|---|
link | 必填 | 作品 / 主页 / 合集 / 直播链接，可填多条 |
path | ./Downloaded/ | 保存目录 |
music/cover/json | true | 是否下载音乐、封面、保存元数据 |
mode | post | 主页模式：post作品 /like喜欢 /mix合集 |
number.post | 0 | 主页作品抓取条数，0 表示全部 |
thread | 5 | 并发线程数，网络差就调小 |
database | true | 用 SQLite 记录下载内容，去重和增量依赖它 |
start_time/end_time | 空 | 时间过滤，格式YYYY-MM-DD |
🛠️ 坑与快速修复
下载报 403 或提示未登录？Cookie 失效了。重跑python cookie_extractor.py刷新，有效期一般一到两周。
V2 的 downloader.py 抓单个视频是空的？已知 API 限制。单个作品用python DouYinCommand.py，V2 留给主页和批量。
重复运行会把作品再下一遍吗？不会。保持database: true，重跑时已存在的作品会自动跳过。
网络差，下载失败多？内置 3 次重试，同时把thread从 5 改成 2 再跑，成功率会明显好转。
不想开浏览器，Cookie 怎么手动填？浏览器 F12 打开开发者工具，在 Network 里刷新页面，复制任意请求请求头里的 Cookie，粘到config.yml的cookies字段。
从克隆到第一次下载完成就是上面 5 条命令，完整参数和 V1/V2 版本差异见仓库内的 USAGE.md。下载的内容建议只用于个人学习和备份，尊重创作者的版权。
【免费下载链接】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），仅供参考
