3分钟装好抖音批量下载工具:去水印、主页归档完整指南
【免费下载链接】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 要解决的:它是一个命令行抖音批量下载工具,粘贴一条链接就能拿到无水印原片,贴一条主页链接就能把整个账号的作品按模式整理到本地硬盘。
🚀 最短安装路径:3 步拿到第一条有效命令
第一步:拉源码、装依赖。需要 Python 3.8 以上环境,一条命令串起来完成克隆、进入目录和安装:
git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader && cd douyin-downloader && pip install -r requirements.txt第二步:复制配置模板、拿到 Cookie。Cookie 是访问抖音接口的凭证。运行取 Cookie 脚本后会弹出一个浏览器窗口,扫码登录你的抖音账号,回到终端按 Enter,程序自动把凭证写进配置:
cp config.example.yml config.yml && python -m tools.cookie_fetcher --config config.yml第三步:跑起来。把要下载的链接填进 config.example.yml 的link字段(单条作品或作者主页都行),然后执行python run.py -c config.yml,终端立刻开始干活。
提示:浏览器兜底和自动取 Cookie 依赖 Playwright,首次用前先执行
pip install playwright和python -m playwright install chromium各一次。
🔍 去水印下载链路:三个场景,三条链路
贴一条单链接。工具先把v.douyin.com这类短链解析成作品 ID,再请求详情接口,从返回的多档码率里挑无水印源、按画质设置选最高档。你做的只是粘贴,拿到手的是干净 mp4 加一份作品元数据 JSON。
抓一个作者主页。作品列表靠接口翻页,翻到被抖音限流截断时,browser_fallback会自动接管——模拟真实浏览器继续滚动加载,遇到验证码就保留窗口等你人工滑一下。这条兜底链路是它能长期可用的关键:平台收紧策略时,任务不会直接断在半路。
重复运行或中断后重跑。每条作品都会登记进 SQLite 库,同时按aweme_id写进本地文件名,双重去重让重跑时已存在的条目直接标记"跳过";单条失败按 1s→2s→5s 指数退避重试,默认 5 线程并发下载;下载结束还会比对 Content-Length,不完整的文件自动清掉、下次补下,不会留下一堆坏文件。
📁 批量归档实操:把一位博主近半年的作品按日期存进硬盘
假设目标很具体:归档某博主最近六个月的作品,保留原声和封面,以后按日期检索。
在 config.yml 里改四处:start_time与end_time设成起止日期(格式YYYY-MM-DD),music: true保留原声,cover: true保留封面,number.post: 0表示不限条数。然后直接运行python run.py -c config.yml。
过程中终端的 Rich 进度条实时刷新:总条数、已完成、失败数一目了然,已下载的条目显示"跳过";中途断网、断电都无所谓,重新执行同一命令就会接着缺口继续。
跑完后磁盘上的结构是:下载目录下按作者名建一层,再按post模式分层,每个作品一个以"日期_标题_作品ID"命名的文件夹,里面放着无水印视频、封面图、原声 mp3 和元数据 JSON。想要封面、音乐、头像、JSON 之外更完整的产物,看 README.zh-CN.md 的输出目录一节。
不想碰终端的话,基于同一套后端的桌面版 Douzy 可以接住同样的任务:粘贴链接发起抖音批量下载,任务中心里每条记录带状态,失败的可以直接点重试。
⚠️ 三个最常踩的坑,各一行解法
只抓到约 20 条就停。原因是接口翻页触发风控。解法:确认browser_fallback.enabled: true,浏览器弹出时人工过一下验证码。
提示需要登录或解析失败。原因是 Cookie 过期。解法:重跑python -m tools.cookie_fetcher --config config.yml刷新凭证。
想重新下载某条作品却总被跳过。原因是去重按"数据库记录 + 本地文件名"双重判断。解法:把该作品的本地文件夹和数据库里对应记录一起删掉再跑。
今天就做一件事:先粘一条视频链接跑完单条,确认去水印文件和元数据都在下载目录里;有底之后再填作者主页链接和时间范围,把批量任务挂到夜间,第二天收一整个整理好的文件夹。
【免费下载链接】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),仅供参考