☰
3 条命令跑通抖音无水印批量下载:douyin-downloader 从安装到调优实操
2026/9/25 2:52:54 网站建设 项目流程

3 条命令跑通抖音无水印批量下载:douyin-downloader 从安装到调优实操

【免费下载链接】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 是免费开源的抖音下载器,抖音无水印下载与抖音批量下载都能做。本文带你从拉代码、配 Cookie 到第一条落盘,再给参数调优与排错速查。

能下什么、存成什么样

先说清两件事:工具能抓哪些内容,文件落盘后摆在什么位置。

能力说明什么时候用
视频无水印下载直接取回原始无水印源文件,保留原画质存作品做素材、学习参考
图集批量下载整组图片按原顺序落盘保存图文类作品
合集批量下载把合集聚合进的作品一次抓全创作者作品备份,系列内容归档
原声下载作品用到的背景音乐单独存出攒曲库、复用抖音原声下载素材
封面与元数据每个作品文件夹附带封面图和 JSON 信息整理资产、建素材库

下载后工具按"用户 / 作品"两级目录建好文件夹,每条作品独立存放:视频、图集、封面、原声、JSON 信息都放在同一目录。已下载作品 ID 会记进 SQLite,再次运行自动跳过已有条目,不重复耗流量。终端实时滚动进度,失败的任务会自动重试。不想碰终端的话,同仓库还带 Douzy 桌面版,粘贴链接、勾选内容类型即可发起批量任务。

Douzy 桌面版抖音平台页:内容类型、数量上限、时间范围均可勾选

从零到第一条落盘

拉代码、打通 Cookie、跑起来,三条线走完就有第一条文件落地。

① 拉代码,装依赖

git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt

克隆仓库、进入目录、装完全部 Python 依赖。需要 Python 3.8+,Windows / macOS / Linux 都能跑;装得慢就先换国内镜像源。

② Cookie 一次配好

Cookie 是工具访问抖音接口时的登录凭据,一次配好长期复用。自动、手动两条路,任选其一:

自动方式:

pip install playwright python cookie_extractor.py

运行后弹出浏览器,扫码登录抖音,登录成功程序就把 Cookie 写进配置。这条路依赖 Playwright,需先装好浏览器内核。

手动方式(自动失败时走这条):

python get_cookies_manual.py

按提示打开浏览器开发者工具,整段复制 Cookie 字符串,贴进配置里。也可以在配置里把cookies填成auto,让程序自己获取。

③ 跑第一次下载

cp config.example.yml config.yml python DouYinCommand.py

复制示例配置并修改:link填目标链接,path填保存目录,然后按配置文件启动。这是 V1.0 稳定版入口;V2.0 增强版用python downloader.py -u "主页链接"直接把链接当命令行参数传入,省得改配置。

按链接类型选打法

手里是什么链接,就切什么打法,三种链接三种走法。

🏷️ 主页链接:一次抓全创作者作品

把创作者主页链接写进link(一行一条,可多条),或经 V2.0 的-u传入。工具翻页取完作品列表,默认 5 线程并发拉取,终端逐文件滚动进度,收尾时打印本次共取回多少条。mode字段决定抓取范围:post作品、like喜欢、mix合集。

🔗 分享短链:一两条快速存

只存一两条时,把分享短链(https://v.douyin.com/xxx)或视频直链塞进link就开跑。终端先打印本次配置——总条数、线程数、保存目录——再滚动进度;重复跑同一条链接,已存在的项目直接跳过。

📺 直播链接:解析房间,拿到流地址

python DouYinCommand.py -l "https://live.douyin.com/直播间ID"

直播课程、赛事、演出回放都走这条路:工具解析直播间标题、主播、在线人数,列出 FULL_HD1、SD1 这类清晰度,选中序号即产出高清流地址,房间信息同时落一份 JSON。

参数怎么调

调优集中在三个字段,对照症状下手。

你会遇到什么动哪个字段得到什么效果
带宽宽裕想提速,或下载频繁失败thread(默认 5)调大增加并发;失败多就调小减压
只要某一段时间的作品,比如月度盘点start_time/end_time(YYYY-MM-DD)只抓窗口内的作品,留空则不过滤
创作者更新了新作品,只想补增量increase: true+database: true已抓的记录在库,再运行只补新增
不想要封面、原声这类附属文件music/cover/json(默认开)改成false即跳过对应文件

字段完整示例见 config.example.yml,对照着改就行。

排错速查

四种常见翻车现场,按"现象 → 原因 → 处理"对号入座:

现象原因处理
提示 Cookie 失效、未登录Cookie 有有效期,隔段时间会过期重跑python cookie_extractor.py重新获取;自动不稳就用get_cookies_manual.py手动复制
下载慢,进度条长时间不动网络余量不足,或一次塞了太多链接先查连接,再适当调大thread,链接拆成小批分开跑
V2.0 下单个视频没反应已知接口问题,API 返回空单视频改走 V1.0 的DouYinCommand.py,该场景更稳
pip / Playwright 安装失败网络问题,或浏览器内核缺失换国内镜像源重试;确需自动 Cookie 时按 README.md 补装 Playwright 及内核,手动 Cookie 用户可直接跳过

上手路线

四步走完,从零到形成自己的下载习惯:

  • 单链跑通:先用一条分享短链下出一条,验证 Cookie 与目录结构
  • 主页批量:挑一位常看的创作者,抓全其作品
  • 按需调参:调thread、设start_time/end_time,把节奏固定下来
  • 增量补新:increase与database保持开启,定期再跑只补新增

最后一句:下载内容仅限个人学习研究,尊重创作者版权,不用于商业用途或二次分发。

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

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

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

立即咨询