抖音批量下载工具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 是一款免费开源的抖音批量下载工具,用 Python 编写,跨 Windows、macOS、Linux 运行。它支持单条视频与图文下载、用户主页批量下载、合集与音乐抓取、直播录制,视频默认取无水印高清源,并内置 SQLite 去重、失败重试、浏览器兜底等稳定性机制。这篇教程会带你从装环境开始,三分钟跑通第一次下载,再逐个解决保存单条、拉全主页、录直播、整理素材库四个高频需求。
周末深夜,你终于不用再录屏了
周五晚上,朋友发来一条舞蹈视频,你复制链接想保存,页面却反复提示"请在抖音内打开";换录屏,画质糊成一团;用网页工具,下两条就开始限速收费。运营要归档竞品主页的上百条作品、老师让你批量收集公开教学视频——这些场景需要的不是一个收藏夹,而是一个能批量干活、不要钱的下载器。douyin-downloader 就是干这个的:免费开源、去水印、支持批量下载和直播录制,源码全部公开可查。
能力速览:30 秒看清它能做什么
| 你想做的事 | 一句话说明 |
|---|---|
| 保存单条视频/图文 | 粘贴链接即可,短链自动解析,视频去水印 |
| 批量拉取用户主页 | 作品、喜欢、合集、音乐四种模式一次跑完 |
| 录制直播 | 支持清晰度选择,主播下播自动保留已录内容 |
| 整理下载文件 | 按作者/日期自动归类,附封面、音乐、元数据 |
| 避免重复下载 | SQLite 数据库 + 本地文件双重去重 |
| 网络波动兜底 | 指数退避重试,翻页受限时自动唤起浏览器 |
| 持续跟进博主 | 增量模式只下载新增作品 |
三分钟跑通第一次下载:装好环境,第一条视频就位 ⚡
第一步:获取代码并安装依赖
git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt第二步:准备配置文件
cp config.example.yml config.yml打开 config.yml,把link改成你要下载的内容地址即可。
第三步:配置 Cookie(关键一步)
Cookie 是访问抖音接口的凭证,没有它就拿不到下载链接。工具提供自动获取方式:
python cookie_extractor.py会自动弹出浏览器,扫码登录后程序自动把 Cookie 写进配置。想手动操作就运行python get_cookies_manual.py按提示粘贴。
第四步:跑起第一个任务
python run.py -c config.yml也可以命令行直接指定链接,不碰配置文件:
python run.py -c config.yml -u "https://www.douyin.com/video/7604129988555574538"运行 run.py 后的实时下载界面,展示批量进度条与完成统计,到这里第一条视频就下载成功了。
保存单条视频或图文:粘贴链接就完事
不想维护配置文件?-u参数支持所有常见链接类型:视频/video/{id}、图文/note/{id}、短链https://v.douyin.com/...都能自动识别,短链还会自动解析成完整地址:
python run.py -c config.yml -u "https://v.douyin.com/xxxx/"下载后,视频、音乐、封面、头像和 JSON 元数据会一起存进作品文件夹,方便后续取用。
一次拉取整个主页:作品、喜欢、合集、音乐一起收 📦
这是最能体现"批量下载"价值的场景。把 config.yml 的 link 换成博主主页地址,再用mode指定要收哪些内容:
link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx mode: - post # 发布的作品 - like # 点赞过的内容 - mix # 创建的合集 - music # 用过的原声 number: post: 0 # 0 表示全量下载运行python run.py -c config.yml,它会逐模式拉取并下载。跨模式自动去重,同一个视频出现在多个模式下不会被重复下载。
多资源下载日志,逐条展示视频、音乐、封面的处理结果,全部完成会给出汇总统计。
录制直播间:设置好时长,下播自动留档
想录直播?把 link 指向直播间地址:
link: - https://live.douyin.com/123456789 live: max_duration_seconds: 0 # 0 = 录到主播下播 idle_timeout_seconds: 30直播解析界面,展示房间号、直播标题与清晰度选项,工具会保存直播间元数据快照。
录制文件保存在Downloaded/作者名/live/下,主播下播或手动中断时,已录制的部分会自动保留为正式文件,不会白录。
把下载结果整理成随取随用的本地素材库
默认folderstyle: true,文件按"作者 → 模式 → 作品"三级归类,一个作品一个文件夹:
Downloaded/ └── 作者名/ └── post/ └── 2024-02-07_作品标题_aweme_id/ ├── 视频.mp4 ├── 音乐.mp3 ├── 封面.jpg └── 元数据.json按日期和标题命名的作品文件夹,一个作品一个目录,检索和备份都很方便。
不习惯命令行的朋友,项目还提供桌面版 Douzy(内测中),粘贴链接即可下载、跟踪任务状态,底层与命令行同一套逻辑:
桌面版 Douzy 下载界面,左侧菜单管理账号与任务,右侧粘贴链接即刻开始。
并发、去重、命名这样调,改动前后立竿见影 🔧
下面几项改完立刻有体感,建议对照 config.yml 逐条试:
| 配置项 | 默认值 | 推荐值 | 改动收益 |
|---|---|---|---|
thread并发数 | 5 | 10~20(高速网络) | 大批量下载速度明显提升 |
increase.post增量 | false | true | 二次运行只下新作品,不重复 |
database去重 | true | 保持开启 | 已下载内容自动跳过,省流量省时间 |
filename_template命名 | {date}_{title}_{id} | 可按需调整 | 排序、检索更顺手,含 id 避免重名覆盖 |
retry_times重试 | 3 | 按需调大 | 弱网下自动按 1s/2s/5s 退避重试 |
browser_fallback兜底 | 开启 | 保持开启 | 翻页受限时自动开浏览器,可人工过验证码 |
这几个坑我替你踩过了:现象、原因、解法
① 只能抓到 20 条作品,翻页就停。这是抖音的翻页风控。确认browser_fallback.enabled: true且headless: false,当浏览器弹窗出现时手动完成验证,别急着关窗口。
② 突然报错、下载全失败。大概率是 Cookie 失效了。重新跑一次python cookie_extractor.py,扫码登录后配置会自动更新。
③ 控制台日志刷屏看不清进度。默认progress.quiet_logs: true已经做了静默;调试时才临时加-v或--show-warnings打开详细日志。
④ 想重新下载某条视频,它却一直"跳过"。这是去重生效了。删掉对应本地文件夹,并清掉数据库记录即可:先按文件名找到*_aweme_id目录删除,再执行sqlite3 dy_downloader.db "DELETE FROM aweme WHERE aweme_id = '<aweme_id>';"。
动手吧
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
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考