douyin-downloader 完整上手指南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上个月想收藏一位博主全部 80 期编程教学视频一条条手动下载显然不现实。后来我找到了 douyin-downloader——一个开源的抖音批量下载工具支持视频、图集、合集、音乐等内容的批量保存也能把直播回放完整录下来。折腾一个晚上之后我不仅把那位博主的作品全数归位还顺手把两场错过直播的回放补了回来。如果你也攒了一堆想看但没时间看的抖音内容这篇文章就是为你准备的。它会带你从环境搭建走到第一份成果落地全程按真实使用场景展开而不是罗列功能清单。先说结论这个工具到底帮你省了什么douyin-downloader 的核心能力可以概括成一句话给一个链接它帮你把链接背后所有值得保存的内容自动、按规则、不重复地搬回本地。链接可以是单条视频、图文、合集、音乐也可以是作者主页、直播房间甚至是自己的收藏夹。对比项手动折腾douyin-downloader保存单条视频右键另存偶尔遇到损坏文件一行命令自动选无水印高清源保存作者全部作品翻页点击几十上百次填一次主页链接并发批量下载直播回放只能眼睁睁错过自动录制 FLV/HLS下播保留已录数据重复内容全凭记忆容易下重SQLite 本地文件双重去重文件命名默认乱码时间戳模板化命名按作者和类型分目录下面的内容全部围绕当你想做某件事时该怎么操作来组织。用之前花 5 分钟把环境配好先把项目拉到本地git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt然后复制一份配置文件cp config.example.yml config.yml最后是很多人卡住的环节——Cookie。项目提供了自动获取方式不需要手动复制粘贴python -m tools.cookie_fetcher --config config.yml命令会打开浏览器让你登录抖音登录完成后回到终端按回车程序自动把认证信息写进配置。全程约一分钟之后就可以正式开始下载了。场景一只想存某一条视频或图文最快的路径是命令行直接追加链接不碰配置文件python run.py -c config.yml -u https://www.douyin.com/video/7604129988555574538程序会先解析链接类型再自动挑选无水印、码率最高的视频源。下载完成后视频、封面、音乐、JSON 元数据会一起落到Downloaded/目录。短链v.douyin.com/...也能直接识别复制分享口令里的链接就能用。场景二把一位作者的主页整个搬下来这是最常见的需求。找到想保存的创作者复制主页地址写进配置文件的link字段link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx mode: - post # 作者发布的作品 - like # 作者点赞过的作品 - mix # 作者创建的合集 - music # 作者的原创音乐 number: post: 50 # 只下载最近 50 条填 0 表示全量 like: 20然后运行python run.py -c config.yml。默认并发 5 线程翻页受限时还能自动拉起浏览器、支持人工过验证码对应配置里的browser_fallback.enabled。下载结果会按作者名和内容类型自动分好目录找东西再也不用靠回忆Downloaded/ └── 作者名/ ├── post/ # 发布作品 ├── like/ # 点赞作品 ├── mix/ # 合集内容 ├── music/ # 音乐作品 └── live/ # 直播回放每个作品文件夹里除了视频本体还附带封面、原声音乐和_data.json元数据——来源、标题、发布时间、作者信息一目了然。场景三错过直播把回放录下来直播是抖音最转瞬即逝的内容形式douyin-downloader 提供实验性的直播录制能力。把直播房间链接放进配置link: - https://live.douyin.com/123456789 live: max_duration_seconds: 3600 # 0 一直录到主播下播 chunk_size: 65536 idle_timeout_seconds: 30支持 FLV 和 HLS 两种协议。主播中途下播、网络空闲或者你按 CtrlC 中断时已经录到的字节会被保留下来临时文件自动提升为正式文件不会白白丢数据。需要提醒的是FLV 文件可以直接播放HLS 源保存的是 playlist 文件需要再用 ffmpeg 转成视频。场景四追更不重复增量下载帮你只下新的如果你打算长期关注某位创作者每次都全量重下显然很浪费。打开增量开关increase: post: true like: true mix: true music: true database: true # 增量依赖数据库记录开启后程序会通过数据库记录 本地文件名双重比对自动跳过已下载的内容只拉取新发布的作品。同一个作品在不同模式下也不会被重复下载。场景五进阶玩法把工具接入你的工作流除了下载本身这个项目还藏了几个高价值入口拉热搜榜快照——想知道今天抖音在聊什么python run.py --hot-board 30 -p ./Downloaded关键词搜索——按兴趣收集素材python run.py --search 猫咪 --search-max 100 -p ./Downloaded两者都会把结果导出成带时间戳的 JSONL 文件方便后续分析。REST API 服务模式——想集成到自己的系统里先装可选依赖再启动pip install fastapi uvicorn python run.py --serve --serve-port 8000之后通过POST /api/v1/download提交下载任务、GET /api/v1/jobs/{job_id}查询进度很适合做自动化流程。下载完成通知——配置notifications.providers支持 Bark、Telegram、Webhook企业微信/飞书/钉钉机器人地址也能用下载结束后手机会收到推送。一次完整的最小实战从零到第一个文件把上面的碎片串起来完整的第一次使用流程是# 1. 拉代码、装依赖 git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt # 2. 生成配置并自动获取 Cookie cp config.example.yml config.yml python -m tools.cookie_fetcher --config config.yml # 3. 编辑 config.yml把 link 换成你想下载的地址 # 4. 运行 python run.py -c config.yml大约几分钟内你就能在Downloaded/下看到第一份完整作品视频、封面、原声、元数据整整齐齐地躺在规范命名的文件夹里。常见误区与避坑提示Q为什么只抓到 20 条作品就停了这是抖音翻页风控的常见现象不是 bug。检查browser_fallback.enabled是否为true、headless是否为false。浏览器窗口弹出后手动完成验证码别急着关窗口程序会接着翻页。Q怎么重新下载某个已下载过的作品去重靠数据库记录 本地文件双重判断所以只删文件或只删数据库都不行。删掉对应的本地文件夹再执行sqlite3 dy_downloader.db DELETE FROM aweme WHERE aweme_id xxx;才能触发重下。QCookie 失效了怎么办重新跑一遍自动获取命令python -m tools.cookie_fetcher --config config.yml登录后回车即可不用手改配置。Q进度条刷屏看得眼花默认配置里progress.quiet_logs: true已经做了静默处理调试时才临时加--show-warnings或-v。三句别人不常讲的效率心法作者目录用nickname_uid。默认的nickname最直观但作者改名或撞名会导致目录分裂、历史文件散落。改成nickname_uid昵称唯一ID一次投资长期受益。命名模板里必须有{id}。项目要求filename_template至少包含{id}否则同名作品会互相覆盖。推荐{date}_{title}_{id}既能按时间排序又保证唯一。用系统定时任务实现自动追更。把python run.py -c config.yml挂进 crontab 每周跑一次配合增量下载你关注的创作者一更新本地资源库就悄悄跟上全程零干预。周边生态桌面版、Docker 与文档如果命令行让你望而生畏项目还提供了一个基于同一套后端打造的桌面版客户端内测中粘贴链接即可下载支持关注列表同步、可视化进度跟踪、作品档案管理。不习惯敲命令的朋友可以从这里入手。服务器或 NAS 用户可以直接用 Docker 部署docker build -t douyin-downloader . docker run -v $(pwd)/config.yml:/app/config.yml -v $(pwd)/Downloaded:/app/Downloaded douyin-downloader想深入了解配置细节可以对照项目里的 config.example.yml 和 USAGE.md实现原理可以参考 core/ 目录下的源码测试代码在 tests/ 里跑一遍python3 -m pytest -q就能验证环境是否正常。现在就可以开始打开终端把第一行git clone敲下去。先用一条视频链接跑通流程再试着搬一个作者主页最后加上增量下载配置——你的个人抖音资源库就从今天这几个命令开始积累。最后提醒一句工具只解决怎么保存的问题该不该保存需要你自己把关。请遵守平台规则尊重创作者版权下载内容仅用于个人学习与研究。技术可以帮你留住精彩别让它越过边界。【免费下载链接】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），仅供参考