抖音批量下载完整指南:一条主页链接,10 分钟把无水印作品归档到本地
2026/9/15 18:13:40 网站建设 项目流程

抖音批量下载完整指南:一条主页链接,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

在 App 里一条条保存作品,又慢又带水印。douyin-downloader是本地命令行工具:贴一条单条视频链接,甚至整个作者主页链接,就能完成抖音批量下载、抖音无水印下载,封面与原声一并落盘。SQLite 数据库自动跳过已下载内容,重复运行不重复占空间。

先跑起来:从克隆到出片

这一节走完,你手里就有第一个无水印文件;每一步都标了"你会看到什么",卡住时按描述自检。

1)克隆仓库,装依赖

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

预期结果:终端逐包打印 Installing,最后一行出现 Successfully installed;国内网络建议保留清华镜像源,否则装包容易超时。前提只有 Python 3.8 以上,Windows、macOS、Linux 都支持。

2)拿到 Cookie

python cookie_extractor.py # 自动获取并写入,推荐 # python get_cookies_manual.py # 或从浏览器手动提取

预期结果:config.yml里多出一段 cookies 字段,值已自动填好。抖音多数接口需要登录态,这是新手最容易卡住的一步。Cookie 只存在你本地,不上传任何服务器。懒人写法:配置里写cookies: auto,让浏览器代抓——但必须先执行pip install playwright && playwright install装好浏览器内核,否则会在启动时报错。

3)写最小配置

复制 config.example.yml 为config.yml,删到只剩 4 个字段:

link: - https://www.douyin.com/user/xxxxx # 目标主页或单条视频链接 path: ./Downloaded/ # 保存目录 music: true # 连背景音乐一起下 cover: true # 保存封面

预期结果:文件保存成功。其余字段不写就走默认值,后面第四节有完整速查表。

4)执行第一条命令

python DouYinCommand.py # V1.0 稳定版,适合单条视频 python downloader.py -u "https://www.douyin.com/user/xxxxx" # V2.0,主页批量

预期结果:终端打印"已获取作品列表",进度条逐条走动;./Downloaded/下出现作者名/post/日期_标题_作品ID/文件夹,里面是.mp4、封面图、.mp3。第二条命令加--auto-cookie可自动抓 Cookie 并直接开下。V1.0 与 V2.0 的职责分工,见 USAGE.md。

按场景调配置

三种跑法覆盖日常绝大多数需求。先看完成时磁盘和终端长什么样,再回溯是哪几行配置起的作用,最后顺手验证一下。

主页作品一键归档:全量备份某个博主

跑完一次,本地长这样:Downloaded/作者名/post/下每个作品一个独立文件夹,视频、封面、原声、元数据 JSON 各归其位;终端顶部先报总数,逐条进度条走完,结尾输出成功数、用时和保存路径统计。

倒回去看,只有两行在起作用:

number: post: 0 # 0 = 全部作品 json: true # 保存完整元数据

验证:数一下终端报告的成功数,与作品文件夹数量一致,归档即完整。

每日增量备份配置:crontab 挂着就不用管

第二次运行秒级结束,绝大多数条目显示"跳过已存在",作品目录只多出当天新发的那几个文件夹——去重记录在 SQLite 里,磁盘不会越跑越臃肿。

背后只多了一行:

increase: post: true # 增量模式:只拉取新作品

工具不内置定时任务,自己挂 crontab,每天凌晨 2 点跑一次:

0 2 * * * cd /path/to/douyin-downloader && python DouYinCommand.py

验证:次日看终端,跳过条数应远大于新增条数。

按时间范围导出:只取最近一个月

落盘目录里的文件全部落在 7 月 25 日到 8 月 24 日之间,封面文件名以发布日期开头,肉眼就能核对区间。

对应配置:

start_time: "2026-07-25" # 格式 YYYY-MM-DD,留空即不过滤 end_time: "2026-08-24"

验证:终端顶部会打印当前时间范围,与配置一致即可。同屏还能看到"跳过已存在"的去重统计。

下载失败,先对表自查

失败绝大多数集中在 Cookie 失效和抓取范围过大两处。对完这张表再去找报错,能省掉大半排查时间。

现象高概率原因处理办法
整批任务大面积失败,提示需要登录Cookie 过期或缺失重跑cookie_extractor.py把新 Cookie 写回配置,别手改单个字段
抓了几条就停,数量远少于预期API 分页受限或触发限流retry_times提到 5、thread调低,重跑补齐——去重机制不会重复下载
同标题作品互相覆盖文件名冲突默认命名自带日期前缀;自定义过命名规则的,务必保留日期或作品 ID
下载途中报磁盘空间不足全量抓取未设上限start_time/end_time,或调小number.post
首次运行要求安装 Playwright选了cookies: auto但浏览器内核未装执行pip install playwright && playwright install,或改回手填 Cookie

哪些参数值得手动调

默认值直接可用,调参时按这张表对照。Cookie 失效的后果见上一节故障表:整批任务会大面积失败。

字段默认值作用何时调整
link—(必填)下载目标:单条视频链接或主页链接每个任务必填
path./Downloaded/保存目录默认位置不合适时
modepost主页下载页签:post作品 /like喜欢想连带"喜欢"页签时
number.post0(全部)每次抓取的作品数量试跑或省磁盘时设小值
increase.postfalse增量下载,只取新内容挂定时备份时
thread5并发线程数网络好时提到 8
retry_times3失败自动重试次数网络不稳定时提到 5
start_time/end_time空(不过滤)按发布时间过滤只导出特定时间段时
cookies必须提供抖音登录态报登录类错误时刷新

musiccoverjsondatabase四个开关默认均为 true,只想要视频本体时把它们改成 false 即可。

它不做什么,以及存下来还能干嘛

能力边界先说清楚,避免对不齐预期:

  • 没有图形界面,全程命令行操作
  • 不内置定时任务,每日备份要自己挂 crontab
  • 无跨账号并行下载
  • 全部请求在本地执行,数据不出你的电脑

想要完整功能清单,见 claudedocs/功能需求文档.md;想深入源码,下载主流程在 core/,Cookie 管理在 auth/。

存下来的东西还有二次利用价值。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),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询