douyin-downloader 抖音批量下载:无水印、完整配置、5 类目标实战指南
2026/8/21 23:05:42 网站建设 项目流程

douyin-downloader 抖音批量下载:无水印、完整配置、5 类目标实战指南

【免费下载链接】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 是一个 Python 开源的抖音批量下载工具,一条命令即可拉取无水印视频、图集、合集与原声,内置 SQLite 去重、断点重试与浏览器兜底。本文面向需要本地化内容的个人创作者与数据运维人员,按"先跑通、再看能力、再按目标配置"的顺序展开。

60 秒跑起来

本节目标:三组命令完成安装、鉴权与首次下载。

1. 克隆并安装依赖(要求 Python 3.8+)

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

命令注释:把项目拉下来并装好全部第三方依赖,一般一两分钟。

2. Cookie 自动获取(需要 Playwright,用于浏览器兜底翻页,建议一并装上)

pip install playwright python -m playwright install chromium python -m tools.cookie_fetcher

命令注释:脚本自动打开浏览器,你登录一次抖音,Cookie 会写入config/cookies.json,全程不用手抄。

3. 跑首次下载

python run.py -u "https://v.douyin.com/xxxxxx/"

命令注释:-u直接传链接,无需配置文件;产物默认落在./Downloaded/config.example.yml里是全部可选项的样板。

能力地图

下表列出它能干的全部事及触发方式,先看能力再决定用哪个入口:

能力触发配置 / 命令产出
单条 / 图集下载-ulink:填作品链接无水印 MP4、封面、元数据 JSON
主页批量备份主页链接 +mode: post按作者分目录的作品集
点赞 / 收藏本地化mode: like/collect你的历史喜欢内容
合集 / 原声批量/collection//music/链接整包作品
直播录制live.douyin.com/{房间号}+live:FLV 直播录像
增量追更increase: true+database: true仅新作品入库
热搜 / 关键词导出--hot-board/--searchJSONL 文件

与录屏、在线解析站相比:它直连抖音接口取无水印源,Cookie 与数据全部留在本地,靠 SQLite 历史做跨模式去重,apiproxy/douyin/strategies/下还内置 API 与浏览器双策略互相兜底。文件按"作者 → 内容类型 → 日期_标题"三层归档,命名规则由filename_template控制,见 config.example.yml。

按目标实战

以下每节对应一个具体目标,配置直接贴进config.yml即可。

全量备份某个博主的主页

link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx mode: - post number: post: 0

命令注释:number.post: 0表示不限数量,遍历该博主全部发布作品,图集视频通吃,并自动附带封面与 JSON 元数据。

增量追更,只下新作品

increase: post: true database: true

命令注释:通过dy_downloader.db比对历史记录,已下载过的直接跳过,日常追更几乎零成本。

点赞与收藏本地化

mode: - like number: like: 0 collect: 0

命令注释:like抓你点过赞的作品,collect抓收藏夹;收藏模式必须单独运行一次,不能与post等混用。

合集与原声批量入库

link: - https://www.douyin.com/collection/7341234567890123456 - https://www.douyin.com/music/7341234567890123456

命令注释:前者拉取整个合集,后者抓取该原声下的全部作品,各自单独建目录。

热搜榜与关键词导出

python run.py --hot-board 30 -p ./Downloaded python run.py --search "猫咪" --search-max 100 -p ./Downloaded

命令注释:第一条导出当天热搜前 30 条,第二条按关键词检索作品,结果均为 JSONL,可直接用脚本分析。

进阶玩法

每个玩法 2-3 句话加一条触发命令,按需开启即可。

直播录制

link指向live.douyin.com/{房间号},配合live:块即可录制:

live: max_duration_seconds: 0

0表示录到主播下播为止;断流或下播时已录数据完整保留,不会白录。

评论采集

comments: enabled: true include_replies: false max_comments: 500

命令注释:为每个作品额外生成*_comments.json,可含二级回复,适合运营与舆情调研。

REST 服务化

pip install fastapi uvicorn python run.py --serve --serve-port 8000

命令注释:启动本地 REST 接口,提交下载 URL 后异步排队执行,方便集成到自己的脚本或前端。

任务完成推送

notifications: enabled: true providers: - type: bark url: https://api.day.app/YOUR_DEVICE_KEY

支持 Bark、Telegram 与企业微信 webhook 三类通道,批量任务结束自动推送成功/失败汇总。

语音转写

transcript: enabled: true response_formats: [txt, json]

命令注释:视频下载后调用语音接口生成转写文本,需配置OPENAI_API_KEY;图文作品不转写。

桌面客户端 Douzy

项目提供 Electron 桌面版 Douzy,链接录入、内容类型选择、任务中心全程图形化,适合完全不想碰终端的场景。

问题手册

遇到下列现象时,按"原因 → 解决"对照处理:

现象原因解决
请求报登录态失效Cookie 过期或缺失重跑python -m tools.cookie_fetcher,或手动更新config/cookies.json
主页只翻到前 20 条左右API 翻页被风控限制开启浏览器兜底:browser_fallback.enabled: trueheadless: false时遇验证码手动通过
想重下某作品却被跳过数据库记录 + 本地文件双重去重sqlite3 dy_downloader.db删除该aweme_id记录,并删除对应本地文件夹
终端日志刷屏控制台日志未静默配置progress.quiet_logs: true;需调试时加-v
collect模式报错收藏模式与账号绑定且不可混用单独运行一次,链接指向自己的主页

FAQ

问:下载中断网了,要重新开始吗?不用。重试机制带指数退避,未完成文件会被清理后自动重下,已完成部分不受影响。

问:转写文件为什么没生成?依次检查:transcript.enabled是否为true、对象是否为视频(图文不转写)、OPENAI_API_KEY是否有效、response_formats是否含txtjson

问:怎么查历史下载记录?

sqlite3 dy_downloader.db "SELECT aweme_id, title, author_name, datetime(download_time,'unixepoch','localtime') FROM aweme ORDER BY download_time DESC LIMIT 20;"

命令注释:按下载时间倒序输出最近 20 条作品记录。

问:下载速度慢怎么调?thread降到 3 比拉高更稳;网络受限时在配置里给proxy填本地代理地址,如http://127.0.0.1:7890

收尾速查表

目标命令 / 配置说明
单条下载python run.py -u 链接免配置文件,自动去水印
主页全量mode: post+number.post: 0不限量
增量追更increase.post: true+database: true只下新增
点赞 / 收藏mode: like/collect收藏须单独运行
合集 / 原声/collection//music/链接整包拉取
直播录制live:+ 直播间链接下播自动收尾
热搜 / 搜索--hot-board N/--search 词导出 JSONL
Cookie 刷新python -m tools.cookie_fetcher一键自动获取
REST 服务python run.py --serve服务化集成

最后提醒:请尊重创作者版权,将本工具用于个人学习、研究与数据备份等合法场景。

核心关键词:抖音批量下载工具、douyin-downloader、抖音无水印下载;长尾关键词:抖音主页全量备份、抖音增量下载配置、抖音直播录制 FLV、抖音合集原声下载、抖音评论采集 JSON、Cookie 一键获取、REST API 抖音下载服务

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

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

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

立即咨询