douyin-downloader 抖音下载教程
2026/9/15 14:30:12 网站建设 项目流程

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

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

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

立即咨询