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 是一个抖音无水印下载工具,支持单个视频、图集、合集、音乐,也能贴一个博主主页把整页作品批量打包下来。当你要把某个创作者的几百条作品、封面、音乐一次性存到本地归档时,手动保存显然不现实。
它能帮你解决什么
- 贴一条视频、图集或合集链接,直接出无水印文件
- 贴一个博主主页,按作品、点赞、合集、音乐模式整页批量下载
- 直播还在播就能开始录,播完自动保留已录内容
- 支持短链接,自动识别内容类型
- 失败自动重试、断点跳过,进度条实时显示
5分钟跑通
第 1 步,克隆仓库并安装依赖,这一步把环境和依赖准备好:
git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader && pip install -r requirements.txt第 2 步,复制一份配置文件,后面所有参数都改在这里:
cp config.example.yml config.yml第 3 步,用自带的抓取脚本拿 Cookie,它会弹出一个浏览器,你手动登录抖音后回终端按回车,Cookie 自动写入配置:
python -m tools.cookie_fetcher --config config.yml第 4 步,打开config.yml,在link里填入要下载的链接。最简单的填法:
link: - https://www.douyin.com/video/7604129988555574538第 5 步,运行下载。跑通之后到Downloaded/目录看成果:
python run.py -c config.yml不想改配置文件的话,也可以用命令行参数直接追加链接和目录,例如python run.py -c config.yml -u "链接" -p ./Downloaded。
按场景使用
下载单个视频或图集
适合只想要某一两条内容、顺便存下封面和音乐的情况。把链接填进link即可,工具会自动识别是视频、图集还是合集:
link: - https://www.douyin.com/video/7604129988555574538 music: true cover: true json: true要点:
- 短链接
https://v.douyin.com/...也能直接贴,工具会先解析跳转 - 无水印源会被自动优先选择,不用手动挑
json: true会在文件旁边生成元数据,方便后续整理
批量下载一个博主的主页
适合需要归档某个创作者全部或最近作品的场景。贴主页链接并指定模式和数量:
link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx mode: - post number: post: 50要点:
mode可选post(作品)、like(点赞)、mix(合集)、music(音乐),可多选number里设 0 表示不设上限,全量下载- 同一作品跨多个 mode 不会重复下载,文件按「作者名/模式/日期_标题」自动分类
录一场直播
适合直播还在进行、想完整留存回放的情况。贴直播间链接,注意这是实验性功能,按项目说明 HLS 源只保存播放列表、FLV 源才直接存文件:
link: - https://live.douyin.com/123456789 live: max_duration_seconds: 3600要点:
max_duration_seconds设 0 表示一直录到主播下播- 主播下播、断网或你 Ctrl+C 时,已录字节都会保留
- 录制文件落在
Downloaded/{作者}/live/下,附带房间元数据 JSON
常用配置与调优
thread:并发下载数,默认 5。网络好可调到 8~10,遇到风控回调低rate_limit:每秒请求上限,默认 2。批量任务大时别往上加,稳定比快重要retry_times:失败重试次数,默认 3,配合指数退避video_quality:画质档位,默认highest(最高转码档);想抠原片设original,代价是每条作品多一次探测请求;省流量可设loweststart_time/end_time:按日期过滤,格式YYYY-MM-DD,只想要某段时间的作品很实用increase.post:设true时增量下载,磁盘上已有文件的会跳过,适合反复跑同一个主页browser_fallback.enabled:接口翻页被限制时自动打开浏览器接管,详见下一节
容易踩的坑
- 只下载到 20 条左右就停了?这是常见的翻页风控行为。把
browser_fallback.enabled设为true、headless设为false,弹窗里手动完成验证,别提前关掉浏览器。 - Cookie 过期了怎么办?重跑一次
python -m tools.cookie_fetcher --config config.yml即可,登录后 Cookie 会写回配置。 - 想重新下载某条作品?程序靠数据库记录 + 本地文件双重判断。删掉本地文件、并用 sqlite 清掉对应记录再跑;只删文件留着数据库,也会触发重下。
- 日志刷得满屏都是?保持
progress.quiet_logs: true即可;排查问题时可临时加--show-warnings或-v。 - 想查下载历史?用 sqlite3 打开
dy_downloader.db查aweme表,README 的 FAQ 里有现成语句。
合规提醒
本项目仅面向技术研究、学习和个人数据管理使用,请勿用于侵犯他人隐私、版权或从事任何违法用途。批量下载时保持默认的限流设置,控制频率。使用产生的一切风险由使用者自行承担,详见 README.md。
douyin-downloader 的定位很清晰:一个把抖音无水印下载、批量归档和直播录制都包下来的命令行工具。跑通单条链接后,建议照着「按场景使用」逐个试一遍,遇到具体参数问题可以翻 README.zh-CN.md 或项目内各目录的 AGENTS.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),仅供参考