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-downloader

douyin-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

复制出配置文件并启动自动登录：浏览器弹出后扫码、回终端按 Enter，Cookie 自动写入config.yml。一次配置长期使用，过期再刷即可。

把要下载的链接填进config.yml：

link: - 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?showTab=favorite_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`