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 是一个抖音下载工具:粘贴视频、图文、合集或作者主页链接,就能保存无水印视频、封面和原声,支持批量下载、SQLite 去重、失败重试和浏览器兜底。适合想归档创作者作品、采集评论数据或录制直播的用户。
它能做什么
简单来说,它把抖音网页上能看到的内容变成整齐的本地文件:单条视频、整页作品、评论数据、直播流都能落盘,下载过程带进度条、自动重试和内容完整性校验。各下载模式按策略拆分在 core/user_modes/ 目录,文件保存与去重逻辑在 storage/ 模块。
| 能力 | 一句话说明 |
|---|---|
| 无水印单条下载 | 视频、图文、合集、音乐链接,自动选无水印源并取最高码率 |
| 作者主页批量下载 | post 作品、like 点赞、mix 合集、music 音乐,四种模式可组合 |
| 增量下载与去重 | 本地文件加 SQLite 双重检查,重复运行只补新作品 |
| 评论采集 | 按作品导出评论 JSON,可选二级回复 |
| 直播录制 | 直播间链接录制成 FLV,下播或中断都保留已录部分 |
| 热搜榜与关键词搜索 | --hot-board导出热搜,--search按关键词导出作品 JSONL |
项目还基于同一后端提供了桌面版 Douzy(封闭测试中),粘贴链接即可开始抖音无水印下载:
三步跑起来
快速安装步骤
需要 Python 3.9 以上,clone 仓库后安装依赖:
git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt最小配置文件
复制config.example.yml为config.yml,先只填链接和下载目录:
link: - https://www.douyin.com/video/7604129988555574538 path: ./Downloaded/ mode: - post抖音接口需要 Cookie:运行python -m tools.cookie_fetcher --config config.yml,浏览器打开后登录,回到终端按回车,Cookie 会自动写进配置,其余字段都有默认值,暂时不用动。
运行下载命令
python run.py -c config.yml终端出现进度条,默认 5 线程并发、失败重试 3 次。临时想改参数不必动配置文件,用-u、-t、-p分别覆盖链接、线程数和目录即可。
真实任务演示
任务一:归档一个创作者的全部作品。目标:把某博主的作品按日期存到本地。操作:link 填作者主页链接,mode 设为 post,number.post 填 0 表示不限量。得到:Downloaded/作者名/post/ 下每个作品一个子目录,默认只存无水印视频,打开 cover、music、json 开关可同时保存封面、原声和元数据;只要某段时间的作品,再填 start_time 与 end_time(格式 YYYY-MM-DD)。之后重复运行,increase.post 默认开启,只补新作品。
任务二:顺带采集作品评论。目标:把评论存成数据用于分析。操作:comments.enabled 设为 true,需要二级回复时再开 include_replies。得到:每个视频旁多出一个*_comments.json,和媒体文件放在同一目录。
任务三:导出热搜榜。目标:拿当日热门话题做选题参考。操作:直接运行python run.py --hot-board 30 -p ./Downloaded,换成--search "关键词"就是按词搜作品。得到:Downloaded/hot_board/ 下带时间戳的 JSONL 文件,可直接交给后续程序处理。
桌面版任务中心能集中查看每个抖音批量下载任务的状态,失败任务可单独重试或打开输出目录:
进阶调优
三个最影响使用体验的配置项,改动前建议先读一遍 config.example.yml 里的中文注释:
| 配置项 | 作用 | 建议 |
|---|---|---|
| thread | 并发下载线程数 | 默认 5;带宽宽调到 8 至 12,网络不稳降到 4 至 6 |
| video_quality | 选哪档画质 | 默认 highest 取最高转码档;要上传原片设 original,每条作品多一次探测请求 |
| notifications | 下载完成推送,支持 bark、telegram、webhook | 长时间批量任务值得开;推送失败不会阻塞下载 |
目录组织默认开启 folderstyle,每个作品独立子目录;命名模板 filename_template 里必须包含 {id},防止重名作品互相覆盖。
避坑速查
| 现象 | 原因 | 解决方式 |
|---|---|---|
| 只下到 20 条左右就停 | 抖音翻页风控 | browser_fallback 开启且 headless 设 false,弹出浏览器完成验证后再关窗 |
| 频繁报错重试 | Cookie 失效 | 重跑python -m tools.cookie_fetcher --config config.yml刷新 |
| 想重下却被跳过 | 跳过判断同时看本地文件和数据库记录 | 本地对应目录和 dy_downloader.db 中的记录一起清理 |
| 终端被进度刷屏 | 进度条刷新产生大量日志 | 保持 progress.quiet_logs 为 true,调试时临时加-v |
适合谁用
需要长期归档创作者内容的素材党、要采集评论与热搜数据的研究人员,以及只想存几条无水印视频的个人用户,都能直接用。如果你想要零命令的纯图形化操作,主程序以命令行为主,桌面版仍在封闭测试,暂时不适合。完整参数与更多 FAQ 见 README.zh-CN.md。
【免费下载链接】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),仅供参考