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里是全部可选项的样板。
能力地图
下表列出它能干的全部事及触发方式,先看能力再决定用哪个入口:
| 能力 | 触发配置 / 命令 | 产出 |
|---|---|---|
| 单条 / 图集下载 | -u或link:填作品链接 | 无水印 MP4、封面、元数据 JSON |
| 主页批量备份 | 主页链接 +mode: post | 按作者分目录的作品集 |
| 点赞 / 收藏本地化 | mode: like/collect | 你的历史喜欢内容 |
| 合集 / 原声批量 | /collection/、/music/链接 | 整包作品 |
| 直播录制 | live.douyin.com/{房间号}+live: | FLV 直播录像 |
| 增量追更 | increase: true+database: true | 仅新作品入库 |
| 热搜 / 关键词导出 | --hot-board/--search | JSONL 文件 |
与录屏、在线解析站相比:它直连抖音接口取无水印源,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: 00表示录到主播下播为止;断流或下播时已录数据完整保留,不会白录。
评论采集
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: true,headless: false时遇验证码手动通过 |
| 想重下某作品却被跳过 | 数据库记录 + 本地文件双重去重 | 用sqlite3 dy_downloader.db删除该aweme_id记录,并删除对应本地文件夹 |
| 终端日志刷屏 | 控制台日志未静默 | 配置progress.quiet_logs: true;需调试时加-v |
collect模式报错 | 收藏模式与账号绑定且不可混用 | 单独运行一次,链接指向自己的主页 |
FAQ
问:下载中断网了,要重新开始吗?不用。重试机制带指数退避,未完成文件会被清理后自动重下,已完成部分不受影响。
问:转写文件为什么没生成?依次检查:transcript.enabled是否为true、对象是否为视频(图文不转写)、OPENAI_API_KEY是否有效、response_formats是否含txt或json。
问:怎么查历史下载记录?
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),仅供参考