抖音无水印下载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 能去水印下载抖音视频、图集、合集和音乐,还能批量备份整个账号的作品,自带去重、重试和限速,照这份指南复制粘贴,五分钟内跑通第一条链路。
五分钟跑通最小链路
做完这节,你会在本地得到一个无水印的视频文件,全程只有几行命令。
先装环境和依赖(需要 Python 3.9 以上):
git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txtrequirements.txt里是网络请求、进度条、配置解析这些基础库,装全了后面排错能省一半时间。
再准备一份配置:
cp config.example.yml config.yml打开 config.yml(即你刚复制出来的文件),把link换成你想下载的视频链接:
link: - https://www.douyin.com/video/7604129988555574538 path: ./Downloaded/然后获取一次登录态,工具会弹出一个浏览器窗口,你在里面完成抖音登录后回终端按 Enter,Cookie 会自动写回配置:
pip install playwright python -m playwright install chromium python -m tools.cookie_fetcher --config config.yml登录态是批量下载主页的基础,单条视频不登录一般也能下,但先弄好一劳永逸。最后运行:
python run.py -c config.yml怎么验证:终端会逐条刷进度,结尾打印"成功/失败/跳过"的汇总统计;打开Downloaded/目录,能看到作者名/post/日期_标题_ID/文件夹,里面就是无水印的.mp4。默认只保存视频本体,想连作品的标题、话题、发布时间等元数据一起留档,把配置里json: true打开即可。
按目的选场景
批量备份一个账号的作品
给谁用——想长期存档某个创作者全部内容的人,一个主页链接就能把他的作品分批拉下来,重复运行不重复下载。
怎么做——把config.yml改成:
link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx mode: - post # post=他发布的作品,like=他点赞的 number: post: 50 # 本次最多 50 条;0 表示不限 increase: post: true # 增量模式:只下新增 start_time: "2024-01-01" end_time: "2024-12-31"运行python run.py -c config.yml即可。
为什么——increase依赖 SQLite 库(默认dy_downloader.db)和本地文件双重去重,已存在的作品直接跳过;判断口诀是:长期追更就开增量,一次性搬家就关掉。start_time/end_time按作品发布时间过滤,number限制数量,两个一起用先把范围圈小。
怎么验证——终端结尾有总统计;Downloaded/作者名/post/下每个作品一个文件夹;想知道某条作品下没下过,直接搜清单文件:
grep "作品ID" Downloaded/download_manifest.jsonl采集合集与音乐,顺带抓评论
给谁用——剪辑素材党。把下载维度从"账号"换成"内容",一个合集、一位博主用过的全部原声都能拉下来。
怎么做——合集直接把链接换成合集页:
link: - https://www.douyin.com/collection/xxxxx mode: - mix要博主全部配乐时,link放他的主页链接,mode改成music。想让每条作品旁边多一份评论存档,打开:
comments: enabled: true max_comments: 500 # 每作品最多抓多少条评论,0 为不限为什么——音乐模式优先取原声文件,缺失时回退到该音乐下首条作品,所以拿到的基本就是干净的原声素材。
怎么验证——媒体文件旁会多出{日期}_{标题}_{ID}_comments.json;Downloaded/作者名/下会按mix/、music/分层存放,打开文件夹核对条数即可。
没有链接也能开工:热榜和搜索
给谁用——不知道存什么、想"顺藤摸瓜"找选题的人。不用先有链接,先拉数据再挑。
怎么做——两条命令,结果都以结构化 JSONL 落盘:
python run.py --hot-board 30 -p ./Downloaded python run.py --search "教程" --search-max 50 -p ./Downloaded--hot-board拉当天抖音热搜榜(数字是条数上限),--search按关键词搜作品。
为什么——结果不是直接下载视频,而是存成 JSONL 清单,一条作品一行,含链接和元数据;挑出感兴趣的后,把链接复制进config.yml的link就能接着批量下载,从"发现"到"归档"闭环。
怎么验证——看终端提示的输出路径,Downloaded/hot_board/和Downloaded/search/下各生成一个带时间戳的.jsonl文件,用文本编辑器打开核对条数。
录制直播:错过开播也留底
给谁用——追直播的人。把直播间链接放进配置,开播期间挂着跑,主播下播时已录部分会自动保留。
怎么做——link指向直播间地址即可:
link: - https://live.douyin.com/123456789为什么——中断或主播下播时,已写入的字节不会被丢弃(临时文件自动转正)。注意直播录制是实验性功能,网络中断时间太长仍可能丢片段,重要场次建议全程盯着。
怎么验证——Downloaded/作者名/live/下按日期_标题_房间号建文件夹,.flv可直接播放,旁边有_room.json元数据快照。
跑不动了先看这里
失败基本集中在登录态、限流、去重三件事上,先对照这张表,不用逐条排查:
| 症状 | 大概率原因 | 一行修复 |
|---|---|---|
| 提示"登录态失效"或大量 4xx 错误 | Cookie 过期 | python -m tools.cookie_fetcher --config config.yml重新登录(交互终端下工具会自动重登录并重试一次) |
| 只翻出 20 条左右就停 | 主页翻页触发风控 | 保持browser_fallback.enabled: true,浏览器弹窗出现后手动完成验证再关 |
| 下载频繁报错、进度很慢 | 被限流或网络不稳 | thread: 2降并发、rate_limit: 1降频,有代理就填proxy |
| 已下载的作品想强制重新下载 | 去重数据库里有记录 | 删掉对应本地文件夹,并删除dy_downloader.db里该作品的记录 |
另外两件事别踩坑:只删数据库不删文件不会触发重下,只删文件不删数据库反而会计为"需要重下";进度条刷屏难看是日志问题,加-v参数查看详细信息即可。
更省事的方式(可选)
不想敲命令的话,基于同一套后端的桌面版 Douzy 把"粘贴链接、多链接队列、任务中心、作品档案"都做成了界面,贴链接点下载就行:
命令行这边还有两个可选开关:python run.py --serve --serve-port 8000可以把下载能力暴露成 REST 接口给其他程序调用(需先pip install fastapi uvicorn);在配置里填好notifications的 Bark / Telegram / Webhook 地址后,长任务跑完会自动推一条完成通知。
开工清单
git clone仓库后pip install -r requirements.txt,再cp config.example.yml config.yml- 运行
python -m tools.cookie_fetcher --config config.yml扫码登录一次 - 把链接填进
config.yml的link,执行python run.py -c config.yml,去Downloaded/验收
现在就可以动手:放一条你喜欢的视频链接进去,几分钟内第一个无水印文件就会出现在Downloaded/里——之后无论追更、备份还是找素材,都是改几行配置的事。
【免费下载链接】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),仅供参考