抖音无水印批量下载完整指南:3步保存博主主页全部作品
【免费下载链接】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 是一个 Python 开源项目,专门做抖音无水印批量下载:给它一个主页链接,它帮你把作品、图集、合集、音乐一条条抓下来,自动去重、自动重试、自动按发布时间整理目录。
它给你的核心价值:
- 🎯无水印原片:优先拉取无水印地址,支持选原画/最高转码档画质
- 🚀主页批量抓取:作品、点赞、合集、音乐四种模式,数量可限可不限
- 💾SQLite 去重:下载历史落库,重复运行只补新内容,不浪费流量
它解决什么问题
手动存视频的痛,基本都在这几张表里:
| 手动做法 | 真实代价 |
|---|---|
| 手机本地保存 | 带水印,画质被压缩 |
| 找解析网站 | 链接三天两头失效,隐私没保障 |
| 一条一条下载 | 博主发了 500 条作品,手酸到放弃 |
douyin-downloader 的思路是把重复劳动交给程序:
- 批量:一个主页 URL 顶 500 次手动点击,
number字段想全量就全量 - 可控:按日期范围、按数量上限筛选,不是无脑全拉
- 抗折腾:内置重试、限速、并发队列,网络抖动不会让整批任务崩掉
- 可追溯:每个作品生成独立文件夹 + JSON 元数据 +
download_manifest.jsonl清单,随时能查「我到底下了什么」
下图是配套的 Douzy 桌面端抖音主页任务配置界面,命令行版的能力(作品/喜欢/合集/音乐四种模式、数量上限、日期范围)与之对应:
⚠️ 先说个实话:2026 年起抖音风控升级,CLI 对部分接口(单视频、合集、音乐、点赞等)会被拦截。项目提供了Playwright 浏览器兜底(
browser_fallback),用真实浏览器环境去绕过,成功率视风控状态而定;日常大批量场景建议配合桌面端使用。下面流程依然完整可跑通「主页作品批量下载」主线。
三步跑通
第 1 步:准备环境并安装依赖
要求Python 3.9+(Windows / macOS / Linux 均可):
git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt pip install playwright playwright install chromium最后两条是为浏览器兜底安装 Chromium 内核,只需要装一次。
第 2 步:配置 Cookie(下载的关键)
Cookie 就是你在抖音网页版登录后浏览器携带的身份凭证,有它 API 才认你是「已登录用户」:
cp config.example.yml config.yml python -m tools.cookie_fetcher --config config.yml运行后会自动弹出浏览器,在浏览器里登录你的抖音账号,回到终端按回车,Cookie 就自动写进config.yml了,不用手动复制任何字段。
第 3 步:填入链接,首次运行
打开config.yml,把link换成目标博主的主页地址:
python run.py -c config.yml看到进度条滚动、终端打印完成统计,你就跑通了第一次批量下载。想查全部命令行参数:python run.py --help。
能做什么
按你的使用场景对号入座,能力都在config.example.yml里有对应开关:
| 你的场景 | 对应能力 | 关键配置 |
|---|---|---|
| 存一个博主全部作品 | mode: [post]主页批量抓取 | number.post: 0(0 = 不限) |
| 只要某段时间的更新 | 时间范围筛选 | start_time/end_time(YYYY-MM-DD) |
| 只下某几个置顶/最新作品 | 数量上限 | number.post: 10 |
| 顺手收集 BGM | 音乐模式 | mode: [music] |
| 抓博主点赞列表 | 点赞模式 | mode: [like] |
| 视频 + 封面 + 元数据全套 | 附带产物开关 | music/cover/avatar/json |
| 定时补新,不重复下载 | 增量下载 | increase.post: true+database: true |
| 把视频转成文字稿 | 可选 Whisper 转写 | transcript.enabled: true |
所有模式共用同一套并发、重试、限速机制,也都能按模式单独设置数量与增量开关——配置粒度是「按模式」的,不会互相干扰。
一次完整操作
以「保存某博主 2026 年以来的全部作品,视频 + 封面 + 元数据,增量执行」为例。
1. 配置(config.yml核心片段):
link: - https://www.douyin.com/user/你的目标主页链接 path: ./Downloaded/ mode: [post] number: post: 0 # 0 = 全量 start_time: 2026-01-01 end_time: "" video: true cover: true json: true music: false thread: 5 # 并发数 retry_times: 3 # 失败重试 database: true # SQLite 去重 increase: post: true # 已下载过就跳过 video_quality: highest完整字段注释(含画质档位、命名模板、浏览器兜底等)都写在 config.example.yml 里,中文注释,照抄改值即可。
2. 运行:
python run.py -c config.yml3. 得到的结果:按「作者 → 日期_标题_作品ID」自动归档的目录,结构大致如下:
Downloaded/ ├── download_manifest.jsonl # 全量下载清单,每行一条 JSON └── 博主昵称/ └── post/ └── 2026-03-15_作品标题_aweme_id/ ├── 2026-03-15_作品标题_aweme_id.mp4 ├── 2026-03-15_作品标题_aweme_id_cover.jpg └── 2026-03-15_作品标题_aweme_id_data.json日期取的是作品发布时间而不是下载时间,回看整理时一目了然。再次运行同一配置,增量模式会自动跳过库里已有的作品,只补新发布的。
进阶与调优
- 调画质:
video_quality支持original(探测上传原片,失败自动退回最高转码档)、highest(默认)、lowest(省流量),也可指定1080p/720p等,匹配不到自动降级。原片有时比转码档大数倍,注意磁盘空间。 - 调并发:
thread: 5是默认值。家庭宽带建议 3~5,企业网络可到 8~12;别盲目拉满,风控场景下高频请求反而更容易被拦。 - 调命名:
filename_template/folder_template支持{date} {title} {author} {id} {year}等变量,模板里必须保留{id}防止重名覆盖。 - 浏览器兜底:
browser_fallback.enabled: true+headless: false,翻页被风控拦截时会用真实浏览器补数据;弹窗出现验证时手动过一下即可。 - 下载完成通知:
notifications支持 Bark / Telegram / 企业微信 webhook,跑大批量时手机随时收结果。 - 桌面端:不想碰命令行的话,配套的 Douzy 桌面版提供图形界面,粘贴链接、跟踪任务、浏览本地归档一步到位:
排错速查
| 现象 | 原因 | 解法 |
|---|---|---|
| 请求 403 / 频繁失败 | Cookie 过期或风控拦截 | 重新跑python -m tools.cookie_fetcher --config config.yml;仍失败则确认browser_fallback已开启并手动过验证 |
| 主页作品只下到几条 | 接口翻页被风控限制 | 保持browser_fallback.enabled: true、headless: false,让浏览器兜底补齐 |
| 重复下载同一个作品 | increase未开或库被删 | 确认database: true且对应模式increase: true |
| 想全量重下一遍 | 增量开关在生效 | 对应模式设increase: false即可覆盖重下 |
| 速度很慢 | 并发太高被限速,或网络本身不稳 | 降thread,加retry_times;必要时配proxy |
| 想看详细报错 | 默认日志偏安静 | python run.py -c config.yml -v打开 verbose 日志 |
更多设计细节可翻 PROJECT_SUMMARY.md 和 docs/。
安全与合规
- 仅用于个人备份、学习研究,尊重原作者版权,不要二次商用或传播
- Cookie 等于你的登录态,只留在本机,不要提交到代码仓库或发给别人
- 控制请求频率(并发别拉太满),是对平台也是对自己账号的保护
写在最后
douyin-downloader 把「无水印、批量、去重、可追溯」这四件事做成了一个配置驱动的一体化流程——一次配置,长期受益。现在就 clone 下来,用三步跑通你的第一个主页批量下载吧。
【免费下载链接】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),仅供参考