抖音批量下载实战教程:无水印快速归档一个作者的全部主页作品
【免费下载链接】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
在 App 里逐条保存抖音作品非常繁琐,存下来的还附带水印。douyin-downloader是一款面向抖音无水印批量下载的开源工具:它是纯本地运行的命令行程序,贴入一条视频链接、甚至整个作者主页,就能把视频连同封面、原声一起归档到本地;内置数据库负责自动去重,重复运行也不会让磁盘白白膨胀。
30 秒看懂:这是个什么东西
一句话定位:给它一个抖音链接,它还你一份完整的本地档案。
卖点集中在几处:
- 一条链接覆盖三种入口:单条视频、图集/合集、作者主页;主页下载还能在"作品"与"喜欢"两个页签间切换
- 自动优选无水印源,画质档位里默认挑最高码率
- 增量开关、时间范围过滤、数量上限三者都可配,抓取量完全由你决定
- 每次下载都记录在 SQLite 数据库里,重跑时自动跳过已有作品
- 全部请求在你自己的机器上完成,数据不出本机
先知道的几件事:
- 全程在终端里操作,没有任何桌面界面
- 首次使用需要备好一份有效 Cookie,获取方式下一节讲
- 它不内置定时任务,想每天自动跑要自己挂 crontab
完整功能清单可以查仓库里的功能需求文档.md。
开工前准备:四步清单(含 Cookie 怎么拿)
按顺序做完这四步,后面就不会卡在环境上:
- 确认 Python 版本:需要 3.8 及以上。
- 克隆仓库并安装依赖,国内网络加上清华镜像源更稳:
git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple- 获取 Cookie:抖音多数接口要求登录态,这是新手最常被卡住的一步:
python cookie_extractor.py # 自动获取并写入,推荐 python get_cookies_manual.py # 或从浏览器手动提取Cookie 只保存在本地。也可以在配置里写cookies: auto交给浏览器自动抓取,前提是先执行pip install playwright && playwright install。
- 写一份最小配置:复制 config.example.yml 为
config.yml,只留这四项字段:
link: - https://www.douyin.com/user/xxxxx # 目标主页或单条视频链接 path: ./Downloaded/ # 保存目录 music: true # 背景音乐一起下 cover: true # 封面一并保存跑通第一次下载:最小配置即可执行
配置就绪后,两个入口按分工各管一摊:
python DouYinCommand.py # V1.0 稳定版,适合单条视频 python downloader.py -u "https://www.douyin.com/user/xxxxx" # V2.0,主页批量V1.0 负责简单的单条下载,V2.0 承担主页这类批量场景,两者差异详见仓库内的 USAGE.md。第二条命令加上--auto-cookie参数,能自动抓 Cookie 后直接开始下载。
三个高频玩法:整页归档、自动补新、按时间段截取 📥
以下三个玩法覆盖了日常使用的大部分需求,每个都按"目标 → 关键配置 → 验证"的节奏走一遍。
整页主页打包归档
目标:把某位创作者的全部作品(封面、原声、元数据都要)收进本地磁盘。
关键配置:
number: post: 0 # 0 表示抓取全部作品 json: true # 连完整元数据一起保存如何验证成功:运行中终端先出现"已获取全部作品:N个"这样的行,随后逐条走进度条;结束后汇总成功数、耗时与保存目录三个数字。本地文件按"日期_标题"分好文件夹,视频、封面、音乐各自归位。
每天自动补新
目标:每次只收作者新发布的作品,不用人盯着重跑。
关键配置:
increase: post: true # 增量模式,只拉新作品再在 Linux 的 crontab 里挂一条任务,让每天凌晨 2 点自动执行一次:
0 2 * * * cd /path/to/douyin-downloader && python DouYinCommand.py如何验证成功:第二次运行几乎秒级结束,多数条目直接显示"跳过已存在",作品目录里只多出少量新文件。去重依据写在 SQLite 里,不会重复存储。
按时间段精确截取
目标:只取某个窗口期内发布的作品,比如只要最近这一个月的。
关键配置:
start_time: "2026-07-25" # 格式 YYYY-MM-DD,留空则不过滤 end_time: "2026-08-24"如何验证成功:终端第一行会打印本次生效的时间窗口,落盘文件全部位于该区间内;封面文件名以发布日期开头,扫一眼就能确认无误。
抖音无水印下载配置速查:哪些字段值得改 ⚡
默认值开箱可用,想微调时对照这张表即可(字段顺序按使用频率重排):
| 字段 | 它管什么 | 什么时候改 |
|---|---|---|
link | 下载目标:单条视频或主页链接,每个任务必填 | 每次换新目标时 |
path | 保存目录,默认./Downloaded/ | 默认位置不方便时 |
number.post | 单次抓取作品数,0即全部 | 试跑、省磁盘时给个小值 |
increase.post | 增量开关,默认false,只取新内容 | 挂定时备份时打开 |
thread | 并发线程数,默认 5 | 网络条件好时提到 8 |
retry_times | 失败自动重试次数,默认 3 | 网络不稳时提到 5 |
start_time/end_time | 按发布时间过滤,空值即不过滤 | 只导出特定窗口期时 |
mode | 主页页签,默认post作品,可切like | 想连带"喜欢"页签时 |
cookies | 抖音登录态,必须提供 | 报登录类错误时刷新 |
music/cover/json/database四个开关默认均为 true,只想要视频本体的话把它们改成 false。
卡住了先自查:五个常见症状
多数问题归不出两类:Cookie 失效,或抓取范围给得太大。先对照下表自查,再去翻报错信息:
| 你看到的现象 | 问题通常出在哪 | 排查动作 |
|---|---|---|
| 任务成片失败,提示需要登录 | Cookie 过期或缺失 | 重跑cookie_extractor.py把新 Cookie 写回配置,别手改单个字段 |
| 抓了没几条就停,数量远少于预期 | API 分页受限或触发了限流 | 调低并发、调高重试次数后重跑补齐,已下载条目会自动跳过 |
| 同标题作品互相覆盖 | 文件名冲突 | 默认命名自带日期前缀;自定义过命名规则的话,务必保留日期或 ID |
| 下到一半提示磁盘空间不足 | 全量抓取没设上限 | 补上时间边界,或把number.post调小 |
| 首次运行要求安装 Playwright | 选了自动抓 Cookie 但浏览器内核没装 | 执行pip install playwright && playwright install,或改用手填 Cookie |
写在最后:一份会长期增值的档案
十分钟的一次性配置,换来的是持续更新、无水印的本地档案库。打开json: true后,每件作品会多存一份元数据 JSON,作者、发布时间、标题标签都在其中,导进表格或笔记软件就能做内容盘点;下载历史同样写进 SQLite,"我到底存过哪些东西"随时可查。本地内容库攒到一定规模后,翻一翻本地封面,比在 App 信息流里翻找回忆要快得多。
最后提醒:请把这份下载能力用于个人学习、研究与备份场景,尊重创作者的权益,不要用于商业分发或任何侵权用途。
【免费下载链接】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),仅供参考