douyin-downloader 快速上手：抖音去水印下载与主页批量抓取实战指南

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-downloaderdouyin-downloader 是一款免费开源的抖音下载工具单条视频去水印、作者主页批量抓取、合集/图文/音乐一键拉取、直播录制都能做。全程靠命令行和 YAML 配置驱动不用写代码Windows、macOS、Linux 均可运行。快速上手5 条命令拿到第一条无水印视频这一节解决从零跑到下载成功的问题只走最短路径每步跑完会发生什么一句说清。git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader把源码拉到本地后续所有命令都在项目目录里执行。cd douyin-downloader pip install -r requirements.txt安装全部运行依赖需 Python 3.8进度走完没红字就算就绪。pip install playwright python -m playwright install chromium装一个浏览器后面自动登录抖音拿 Cookie 会用到。cp config.example.yml config.yml python -m tools.cookie_fetcher --config config.yml复制出配置文件并启动自动登录浏览器弹出后扫码、回终端按 EnterCookie 自动写入config.yml。一次配置长期使用过期再刷即可。把要下载的链接填进config.ymllink: - https://v.douyin.com/xxxxx # 单条视频分享短链自动解析 path: ./Downloaded/python run.py -c config.yml开始首次下载。结束后Downloaded/里会多出无水印视频、封面图和一份元数据 JSON作者、发布时间、描述。文件默认按作者 → 类型 → 日期归档每个作品一个独立文件夹文件名带发布时间戳日后翻找不费劲。场景菜单进阶用法按需取用下面每节都是独立场景加一段配置、跑同一个python run.py -c config.yml再到Downloaded/对应目录核对结果。如果你想批量下载整个作者主页这一节解决一次拉走某位博主的作品。把链接换成主页地址加上模式和条数link: - https://www.douyin.com/user/xxx mode: [post] # post发布作品like喜欢mix合集music原声 number: post: 50 # 只取最近 50 条写 0 表示全量 video_quality: highest # 默认最高转码档original 探测原片更清晰跑完后作品按Downloaded/作者名/post/成批落盘终端实时刷新每个任务的进度与耗时成功、失败、跳过一目了然。如果你想定期跑只抓新作品这一节解决重复运行不重复下载。增量开关加数据库记录一起上increase: post: true database: true # 增量依赖 SQLite 下载历史保持 true start_time: 2025-01-01 # 也可当一次性时间窗只保留该日期后的作品 end_time: # 留空表示不设上限再次运行同一主页时只抓上次之后的新作品start_time/end_time同时充当按发布时间筛选的过滤器。如果你想下载自己收藏的内容收藏夹链接用user/self地址指向当前登录账号link: - https://www.douyin.com/user/self?showTabfavorite_collection mode: [collect] # 收藏合集用 collectmix number: collect: 0注意collect/collectmix只能单独使用不能和 post/like 混配结果落到Downloaded/下对应作者目录。如果你想录制直播直播间链接走独立录制流程不是普通下载link: - https://live.douyin.com/123456789 live: max_duration_seconds: 0 # 0 录到主播下播主播下播或你手动中断时已录部分完整保留。FLV 文件和直播间元数据*_room.json存到Downloaded/{作者}/live/。如果你还想要评论、热搜、通知或转写这四样都是可选项按需在config.yml里打开评论采集comments.enabled: true每个作品旁多生成一份_comments.json热搜榜与关键词搜索走一次性命令行不落下载队列python run.py --hot-board 30 -p ./Downloaded导出快照到Downloaded/hot_board/python run.py --search 关键词 --search-max 100同样落到Downloaded/search/完成推送notifications.enabled: true配 bark / telegram / webhook多通道并发推送单条推送失败不阻塞下载视频转写transcript.enabled: true并设置OPENAI_API_KEY视频旁多出.transcript.txt。如果你不想碰命令行同一套后端还有一个桌面版 Douzy内测中粘贴链接即可下载任务中心能跟踪状态、重试失败项还能同步关注列表盯新作品。入口和说明见 README.zh-CN.md 的桌面版一节。排坑高频故障速查这一节把批量运行时最可能撞上的现象集中放在一起对着查就行。现象原因处置只能抓到 20 条作品翻页触发风控browser_fallback.enabled: true且headless: false弹出浏览器后手动完成验证别急着关窗下载开始成片失败Cookie 过期重跑python -m tools.cookie_fetcher --config config.yml刷新凭证个别作品反复失败作品被删/转私密或接口限流默认指数退避自动重试网络不畅时配proxy: http://127.0.0.1:7890走代理进度条重复刷屏进度阶段日志未静默保持progress.quiet_logs: true调试时再临时加-v或--show-warnings收尾继续深入与一次跑通核对全部配置项与典型场景README.zh-CN.mdAPI 解析与下载主流程源码core/重试、限速与队列实现control/Cookie 自动获取脚本在 tools/现在就把想保存的抖音链接填进config.yml的link列表跑python run.py -c config.yml然后打开Downloaded/核对——无水印视频、封面和元数据 JSON 会在那里等你。请只保存你有权使用的内容下载作品用于个人学习、备份或研究不要二次传播或商用。【免费下载链接】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），仅供参考