抖音无水印批量下载实操指南:一条命令把视频、合集与直播存进本地
2026/9/15 19:32:22 网站建设 项目流程

抖音无水印批量下载实操指南:一条命令把视频、合集与直播存进本地

【免费下载链接】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是一款免费开源的抖音无水印下载工具:粘贴链接,视频、图文、合集、背景音乐和封面全部落在你自己的磁盘上,全程本地运行,不经过任何第三方在线服务。它还支持整页批量下载作者作品和直播间实时录制。这篇抖音批量下载指南按"装好 → 会配 → 会用 → 排错"的顺序讲,10 分钟内可以存下第一条无水印原片。

四步装好环境并跑通

环境只需要 Python 3.8 以上,macOS、Linux、Windows 都行。

1. 拿到代码

git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader

2. 安装依赖

pip install -r requirements.txt

如果要用到浏览器兜底功能,额外执行pip install playwrightpython -m playwright install chromium

3. 复制配置并登录获取 Cookie

cp config.example.yml config.yml python -m tools.cookie_fetcher --config config.yml

浏览器里登录抖音后,回到终端按 Enter,Cookie 会自动写进 config.example.yml 同结构的 config.yml,只保存在本地。

4. 启动下载

python run.py -c config.yml

终端会依次刷出"初始化 → 解析链接 → 执行下载 → 收尾",最后给出成功/失败/跳过统计。看到"成功 N / 失败 0",跑通就算完成。

看懂 8 个高频配置字段

配置文件里字段不少,但日常真正要动的就下面这些,改完保存再运行即可:

字段含义怎么设注意
link下载目标列表填视频、合集或作者主页链接支持v.douyin.com短链,自动解析
mode下载内容类型post/like/mix/musiccollect/collectmix仅限登录账号且须单独使用
number.post该模式下载条数post: 50填 0 表示不限,全量抓取
thread并发线程数默认 5网络不稳时调小更稳
retry_times失败重试次数默认 3内部按 1s/2s/5s 指数退避
database是否启用 SQLite 去重默认 true记录文件为dy_downloader.db
start_time/end_time时间区间过滤YYYY-MM-DD格式只收某个时间段的作品
video_quality画质档位默认highest可设original探原画,或指定 720p 等

更完整的字段注释直接看 config.example.yml,中文注释比文档还细。

单条、批量、直播:三种主力用法

配置字段认得差不多了,下面从最小的场景开始,逐级加量。

保存单条无水印视频

把配置里的link换成任意一条作品链接,短链也行:

link: - https://www.douyin.com/video/7604129988555574538

嫌改配置麻烦,也可以命令行直传:

python run.py -u "https://v.douyin.com/xxxxx/" -p ./Downloaded

文件默认存到./Downloaded/作者名/post/日期_标题_id/目录下,需要封面、音乐、元数据 JSON 就把配置里的covermusicjson改成true

图:桌面版的工作台样式,粘贴一条作品链接即可发起下载,任务中心里能看到每条结果

批量下载作者的全部作品

这是使用频率最高的场景。link换成作者主页地址,用number控制条数:

link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx mode: - post number: post: 50 # 改成 0 即全量

postlikemixmusic四种模式可以写在同一个mode列表里一次跑完,同一作品跨模式自动去重,不会存两份。跑完后按"作者/模式/作品"三级目录归档,找内容不用翻相册。

图:批量任务的结果一览,成功条数、失败项和下载目录都能直接点开

按时间区间收集作品

只想留某段时间的内容?加两行时间字段即可:

start_time: "2024-06-01" end_time: "2024-06-30"

配合上面的批量用法,可以只抓某位作者 6 月的作品,其余区间一律不碰。

增量下载:只补新作品

追更博主建议打开增量开关,第二次跑时自动跳过磁盘里已有的作品:

increase: post: true

判定依据是"本地文件 + 数据库记录"双重检查,删掉本地文件会触发重下,两边都留则跳过。

录制直播间

link指向直播间地址即可开始录制,默认录到主播下播:

link: - https://live.douyin.com/123456789 live: max_duration_seconds: 3600 # 0 = 录到下播

FLV 文件连同*_room.json元数据快照存进Downloaded/作者名/live/。下播、断网或 Ctrl+C 中断时,已录制的字节都会保留,不会白录。

调优与避坑

参数调优建议

参数推荐值适用场景
thread3~5,好网络可到 8全量抓主页;遇到限流就调回 5
retry_times3~5网络波动大、跨境访问
rate_limit2(默认)频繁被风控时调低请求频率
video_qualityhighestoriginal长期存档选original探原画
browser_fallback.enabledtrue翻页被限制时自动打开浏览器兜底

常见现象对照表

  • 只抓到 20 条就停→ 翻页触发风控。保持browser_fallback.enabled: trueheadless: false,弹窗里手动完成验证,验证期间别关窗口。
  • 提示 403 或未登录→ Cookie 过期。重新执行python -m tools.cookie_fetcher --config config.yml,日常建议每周刷新一次。
  • 想重下某条作品却被跳过→ 去重是"数据库 + 本地文件"双判断,两边都要清:删掉本地对应目录(目录名含作品 id),再删dy_downloader.db里那条记录。
  • 文件下载不完整→ 内置 Content-Length 校验会自动清理残缺文件并重下;反复失败时先查网络,再把thread调小。

最后

从一条无水印视频到一位作者的全部作品,douyin-downloader 把整理素材这件琐碎事压缩成了"填链接 + 按回车",文件和下载历史都留在你自己的电脑上。请把它用于个人学习、备份与研究,不要二次分发或商用,尊重创作者的劳动成果;平台接口与风控策略随时可能调整,个别功能暂时失效属于正常技术风险。今天就挑一位你长期追更的博主,把mode设为postnumber设为 0,把他的作品整页收进硬盘吧。

【免费下载链接】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),仅供参考

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

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

立即咨询