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),仅供参考