douyin-downloader 实战指南:5 个场景,从保存单条无水印视频到整页备份主页
【免费下载链接】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 个场景:从安装首条视频、主页整页备份,到追更和排错,照做即可。
4 条命令保存第一条无水印视频
很多人以为保存抖音视频只能录屏,画质一塌糊涂。实际情况是:每条内容在抖音服务端都有无水印的原始流,你看到的播放地址不过套了一层壳。douyin-downloader 干的事,就是把这层壳剥掉,直接取回原始流,顺路把背景音乐、封面和元数据一起带走。
首次跑通只需要四条命令:
git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader/douyin-downloader pip install -r requirements.txt cp config.example.yml config.yml接下来拿登录凭证。工具内置了 Cookie 获取小程序:运行后浏览器自动弹出二维码,用抖音 App 扫一下、回终端按回车,Cookie 就写进配置,不用手动复制粘贴:
python -m tools.cookie_fetcher --config config.yml唯一需要你动脑的,是把链接填进 配置示例 同款的config.yml:
link: - https://v.douyin.com/xxxxxx/ path: ./Downloaded/ music: true cover: true json: truemusic、cover、json分别对应背景音乐、封面图、元数据,默认全开。执行python run.py -c config.yml后,短链自动解析,按"无水印优先"选源,并从码率数组里挑最高清一档。✅ 终端会实时打印进度与成功/跳过统计。
不想碰命令行?项目里还有一款基于同一后端的桌面版 Douzy(内测中),粘贴链接、勾选内容类型就能开下。
主页一次搬完:mode、number、时间、去重四个开关
单条下载只是热身,批量才是这个工具的主场。把链接换成作者主页地址:
link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx mode: - post number: post: 50mode:下什么。post作品、like点赞、mix合集、music原声音乐,可同时开多个;number:下多少。填50取最近 50 条,填0抓到底;- 默认 5 线程并发,几百上千条作品挂机一次跑完。
同一部作品同时出现在"作品"和"合集"里时只下载一次——跨模式去重是自动的。
只想要某个时间窗内的作品?两个字段搞定,工具只收落在区间内的内容,适合按"某次活动""某个月份"做主题收藏:
start_time: "2026-07-01" end_time: "2026-07-31"只要新内容?增量下载一次配好
全量搬完之后,过几天想看博主更新,不必重下。打开两个开关:
database: true increase: post: true🔖 内置的 SQLite 数据库会记住每一部已下载的作品,下次运行自动跳过旧内容、只拉新增。本地库从此和博主保持同步,像个"追更"开关。
想翻下载历史,一行 SQL:
sqlite3 dy_downloader.db "SELECT aweme_id, title, author_name, datetime(download_time, 'unixepoch', 'localtime') FROM aweme ORDER BY download_time DESC LIMIT 20;"四张进阶牌:直播、评论、热搜与 API
直播录制:链接换成直播间地址,加一段live参数即可实时录播。主播下播、网络空闲或手动中断时,已录字节自动保留为正式文件,不会白录一场:
link: - https://live.douyin.com/123456789 live: max_duration_seconds: 3600评论采集:开启comments后,每个作品旁多出一份结构化 JSON,按作品抓取、支持二级回复,做内容分析和舆情整理很方便。
热搜与关键词搜索:两行命令把当天热搜或指定关键词的作品列表导出为 JSONL:
python run.py --hot-board 30 -p ./Downloaded python run.py --search "猫咪" --search-max 100 -p ./DownloadedREST API 服务模式:装一个 fastapi 依赖,用--serve启动,即可通过 HTTP 接口提交下载任务、查询任务状态,接进自己的自动化流水线。
命名、续传、通知推送:4 个收纳技巧
自定义命名与目录:文件默认按"发布时间_标题_ID"组织,也可自定义模板{date}_{title}_{id},配合folderstyle按作品建子目录,下载完的结构一眼看懂:
断点续传与完整性校验:中断后重跑自动续传;每个文件下完做大小比对,不完整的自动清理重下,硬盘里不会留"半截"文件。
完成通知推送:任务结束可通过 Bark、Telegram 或企业微信/飞书 Webhook 推通知。夜里挂批量下载,早上看手机就知道昨晚战绩。
视频转写:可选功能,把视频丢给语音转写接口,自动生成 txt 和 json 两种格式的文字稿。
三个高频问题:风控、Cookie 与速度
为什么只抓到 20 条就停?翻页风控的常见现象。开启浏览器兜底(browser_fallback.enabled: true且headless: false),翻页受限时程序自动弹出浏览器,你手动过一下验证码就能继续抓。
Cookie 过期了怎么办?重跑python -m tools.cookie_fetcher --config config.yml扫码登录即可。有效期一般 7-15 天,建议每周更新一次。
下载速度慢?调高thread并发数(默认 5),确认网络能稳定访问抖音服务器;代理走proxy字段配置。
收尾
从 4 条命令的第一条视频,到主页整页备份、追更、直播、API,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
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考