抖音批量下载工具实操手册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手机里的收藏夹越堆越满直播回放想存没处存喜欢的作者更新了几百条作品自己却只在 App 里零散点过几次赞。这种看着眼馋、存不下来的感觉刷抖音的人多少都体会过。douyin-downloader 就是为这类场景准备的开源抖音批量下载工具视频、图文、合集、音乐、直播回放都能落地作者主页可以整页打包还内置进度展示、失败重试、SQLite 去重和浏览器兜底。这篇手册按从浅到深的顺序把你从第一条命令一路带到进阶玩家的位置。先跑通再谈其他一条命令下载单条视频这个工具最短的用法其实就三步填链接、跑命令、收文件。假设环境已经就绪你只需把config.yml里的链接换成想保存的视频地址link: - https://www.douyin.com/video/1234567890123456789 path: ./Downloaded/然后运行python run.py -c config.yml看到终端里刷出进度条稍等几秒这条视频就被请进了下载目录。和它一起落地的还有封面图、背景音乐和一份 JSON 元数据文件——相当于每件藏品都附了一张身份卡以后想查发布时间、作者、标题都不用再翻回 App。从抖音 App 里直接分享出来的短链也能贴程序会自动解析还原成真实地址。上图就是它干活时的样子右侧进度全部顶到 100%后面的排队、重试、统计全是自动完成的。一次性准备装好环境把 Cookie 钥匙领回来跑上面那条命令之前需要完成两件一次性的事。第一件是装依赖。克隆仓库后进入主程序目录git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader/douyin-downloader pip install -r requirements.txt第二件是认证。抖音不少数据要先验明正身才肯给你看手动从浏览器开发者工具里复制 Cookie又长又容易漏。douyin-downloader 把这件事做成了自动流程python -m tools.cookie_fetcher --config config.yml命令会弹出一个浏览器你正常登录一次抖音回到终端按回车程序就把认证信息写进配置了。全程不用碰任何技术细节相当于有人帮你把钥匙配好你只管进门。如果之后想用浏览器兜底或自动刷新 Cookie再补装 Playwrightpip install playwright python -m playwright install chromium这步可选日常用 API 下载不一定需要。批量下载作者主页一份配置四种模式打包带走单条链接只是热身这个工具真正的主场是作者主页整页下载。发现一个宝藏创作者想把他的作品、点赞、合集、原声全部留档手动翻几百页显然不现实而这里只需要一份配置link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx path: ./我的素材库/ mode: - post # 发布的作品 - like # 点赞过的作品 - mix # 合集内容 - music # 用过的原声 number: post: 50 # 下载 50 个发布作品 like: 0 # 0 表示不限制全量拉取运行python run.py -c config.yml后程序会按作者名建目录四种类型分门别类存放互不串味我的素材库/ └── 作者名_MS4wLjABAAAAxxxx/ ├── post/ ├── like/ ├── mix/ └── music/上图是一次真实的批量任务自动识别出 274 个作品按时间范围过滤后跳过已存在内容5 个线程并发抓取。这种一次下单、批量到货的体验手动操作给不了。批量场景下有个容易忽略的细节去重。同一个视频今天在作品里下过明天换个模式又出现一次怎么办工具内置 SQLite 数据库加本地文件双重检查相当于给每个作品记指纹跨模式也不会重复入库。再配合增量下载开关increase: post: true like: true mix: true它就像一位只补新货的采购员上次下到哪、哪些已入库都记得清清楚楚下次运行只补齐新增内容。想限定时间范围加两行start_time/end_time即可。下载完的内容按日期_标题建文件夹一眼就能定位。这种收纳方式等于给硬盘请了个自动归位的整理员。直播、热搜与推送把下载器调成你的值班员短视频没了可以重看直播不等人——主播下播那一刻错过的基本就错过了。douyin-downloader 支持直播录制配置里加上直播链接和录制参数link: - https://live.douyin.com/123456789 live: max_duration_seconds: 3600 # 录制 1 小时0 表示录到主播下播 chunk_size: 65536 idle_timeout_seconds: 30它会先解析出直播流地址自动读取标题、在线人数和清晰度选项上图就是解析过程然后开始录制。就算主播中途下播、网络断开或者你按 CtrlC 中断已经录到的字节也会保留不会白忙一场。除此之外还有几个适合进阶玩家的小功能热搜与搜索python run.py --hot-board 30拉取抖音热搜榜前 30python run.py --search 关键词 --search-max 100做关键词检索结果统一导出 JSONL方便后续做数据分析和内容选题完成通知批量下载动辄几十分钟配置notifications后任务结束会通过 Bark、Telegram 或企业微信、飞书、钉钉的 Webhook 把结果推到你手机REST API 服务装好fastapi和uvicorn后运行python run.py --serve --serve-port 8000就能用 HTTP 接口提交下载任务、查询任务状态适合想把它接进自己系统的玩家。三个高频翻车点与对应解药工具用顺手之后难免遇到几个共性问题提前知道能少走弯路。为什么只抓到 20 条作品这是抖音翻页风控的常见现象。确认browser_fallback.enabled: true且headless: false浏览器窗口弹出后手动过一下验证码不要急着关程序会继续翻页。Cookie 失效了怎么办重跑一次自动获取命令即可几十秒搞定python -m tools.cookie_fetcher --config config.yml。想重新下载某个视频怎么办程序靠数据库记录 本地文件双重判断是否跳过。删掉对应文件并清掉数据库记录即可SQLite 文件就在当前目录想查历史记录也能直接查sqlite3 dy_downloader.db SELECT aweme_id, title, author_name FROM aweme ORDER BY download_time DESC LIMIT 20;不想敲命令同一套内核的桌面版 Douzy如果你对黑底白字的终端提不起兴趣项目还基于同一套后端做了桌面版 Douzy目前处于内测期。粘贴链接即可下载、一键同步关注列表、可视化跟踪任务进度文件命名规则也能在设置里点点鼠标就配好。命令行适合自动化桌面版适合日常使用两条路线共用同一套内核怎么顺手怎么来。今天就能完成的三个动作工具本身不难难的是先跑起来。放下这篇文章你可以立刻做三件事克隆项目并安装依赖跑一次 Cookie 自动获取完成认证挑一条喜欢的视频链接用python run.py -c 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），仅供参考