抖音批量下载工具 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如果你也曾在深夜为保存喜欢的抖音视频翻遍各种网页解析站结果下载回来全是带水印的压缩画质如果你也曾为了整理某位博主的上百条作品一条一条点开复制链接……那今天这篇教程就是为你准备的。douyin-downloader 是一款开源的抖音批量下载工具主打去水印、多类型批量下载视频、图文、合集、音乐原声、收藏夹全覆盖内置进度展示、失败重试、SQLite 去重和浏览器兜底。我把它当作日常工作里的素材搬运工前后用了两个多月踩过坑也摸透了脾气下面把从安装到进阶的完整经验一次讲清楚。一次存档 300 条视频的周末它替我做了什么先讲个真实场景。上个月我想把一位钓鱼博主的全部作品离线备份一共 274 条。按老办法逐条打开主页、复制链接、丢进在线解析站、下载、重命名——光想想就头大。用上 douyin-downloader 之后整个流程变成把博主主页链接贴进配置文件写清楚下载作品 274 条敲一条命令剩下的交给进度条。期间我去泡了杯咖啡回来看统计成功 274/274每个视频自动按日期_标题_ID命名封面、头像、JSON 元数据也一并落盘。后来再跑一次它直接跳过已存在的文件只补新增内容——这就是它区别于普通下载脚本的核心体验。先看清它的家底能下什么、识别哪些链接很多下载器只认一种链接douyin-downloader 的可识别范围要宽得多我整理成了一张表链接类型对应路径/示例说明单个视频/video/{aweme_id}单条作品去水印优先单个图文/note/{id}、/gallery/{id}图文内容也能整包保存单个合集/collection/{mix_id}、/mix/{mix_id}一整个合集的内容单个音乐/music/{music_id}优先原声文件缺失时回退用户主页/user/{sec_uid}配合mode批量下载作品/喜欢/合集/音乐收藏夹/user/self?showTabfavorite_collection备份当前账号收藏需登录态短链v.douyin.com/...自动解析无需手动展开直播live.douyin.com/{room_id}FLV/HLS 实时录制主页批量下载时mode可以填post作品、like点赞、mix合集、music音乐甚至四种组合使用等于把一位博主的全部内容形态一次搬空。另外它还内置了最高清自动挑选逻辑会读取视频的码率数组选出最清晰的一版不用自己手动比较清晰度。三步完成环境搭建从零开始第一次下载第一步准备运行环境项目要求 Python 3.8 以上macOS、Linux、Windows 都能跑。克隆代码后安装依赖即可git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt如果你需要浏览器兜底或自动抓 Cookie再补装 Playwright 和 Chromiumpip install playwright python -m playwright install chromium第二步用一条命令搞定 CookieCookie 是访问抖音接口的通行证它提供了自动抓取和手动粘贴两条路。自动方式最省心python -m tools.cookie_fetcher --config config.yml执行后会自动唤起浏览器你扫码登录抖音回到终端按一下回车Cookie 就写进配置文件了。手动方式也保留着打开抖音网页版从开发者工具里复制 Cookie 串贴到配置文件对应字段即可。第三步写一份最小配置并启动复制示例配置再按需精简一份能跑的最小配置长这样link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx path: ./Downloaded/ mode: - post number: post: 50 thread: 5 retry_times: 3 database: true启动下载就一行命令python run.py -c config.yml终端里会实时滚动每个任务的下载进度条成功、跳过、失败都一目了然。实测演示增量下载与去重是怎么省时间的这张图是我第一次跑增量模式时的真实输出。左侧是已获取的作品总数中间是每个文件的下载进度注意那些跳过已存在的记录——封面、头像、视频逐一比对已下载过的直接跳过。右下角的统计成功1/1看起来简单背后是两套去重机制在协作SQLite 数据库记录历史 文件系统按文件名智能识别。配合配置里的increase.post: true之后每次跑同一份配置都只补新发布的视频。我习惯把它挂在每天的定时任务里博主更新了我就自动有存档一次都不用手动盯。进阶玩法拆解把下载从能用变成好用直播录制重要直播一帧不丢错过直播回放直接用live.douyin.com链接即可录制。命令行解析直播信息、给出清晰度选项和流地址的过程见下图录制参数在配置的live段max_duration_seconds: 0表示一直录到主播下播idle_timeout_seconds控制无数据多久算断流。主播中途断网也没关系已录数据会保留不会整段作废。评论采集与热搜搜索让数据沉淀下来如果你想做竞品分析或选题调研两个隐藏功能很实用# 按关键词批量搜索结果落 JSONL python run.py --search 猫咪 --search-max 100 -p ./研究数据/ # 或抓取热搜榜前 N 条 python run.py --hot-board 30 -p ./研究数据/需要评论数据的在配置里开启comments段include_replies: true会顺带拉二级回复max_comments: 0表示不设上限每个作品会额外生成一份*_comments.json方便后续做结构化分析。文件命名与目录管理技巧下载几千个文件后命名规则直接决定你找不找得到东西。模板支持{id}{title}{author}{date}{year}{month}{day}{time}{type}等变量我的习惯是filename_template: {date}_{title}_{id} folder_template: {date}_{title}_{id} author_dir: nickname_uidauthor_dir有三个选项nickname直观但重名会合并sec_uid唯一稳定但不友好nickname_uid两者兼顾重度用户强烈推荐。另外开启folderstyle: true后每个作品会放进独立子目录和封面、音乐、JSON 打包在一起整理起来非常清爽。视频转写与完成通知需要给视频做文字稿的可以开启transcript段调用 OpenAI 转写接口自动生成 txt 和 json 两种格式的文稿。下载完成提醒也内置了 Bark、Telegram、Webhook 三种推送渠道长任务挂后台时手机收到通知就知道跑完了。常见问题急救箱四个高频坑的解法坑一Cookie 失效下载大面积报错工具会自动检测登录态异常。解法是重跑一次python -m tools.cookie_fetcher --config config.yml重新扫码几十秒就能恢复。坑二主页只能抓到 20 条作品这是翻页风控的典型表现。确认配置里browser_fallback.enabled: true、headless: false触发时浏览器会弹出手动完成一次验证再关闭窗口即可继续翻页。注意like、mix、music模式目前主要依赖 API 正常分页浏览器兜底只对post做了完整验证。坑三下载速度上不去先看thread并发数5~8 一般够用再检查是不是被限速——内置了默认 2 请求/秒的速率限制这是有意为之的合规设计。遇到 IP 被封的情况配置proxy走代理即可。坑四个别视频一直失败视频被删除或设为私密时无解工具会自动跳过失败项继续跑后面的任务。想看详细原因加--verbose参数跑一遍日志。更多玩法与周边生态定时任务自动化Linux/Mac 用 crontab 每天自动增量0 2 * * * cd /path/to/douyin-downloader python run.py -c config.yml download.log 21Windows 则把同样命令写进.bat文件交给任务计划程序调度。REST API 服务模式想把它嵌入自己的系统安装fastapi和uvicorn后启动服务模式python run.py --serve --serve-port 8000对外暴露任务接口下载任务可排队、可查询状态适合团队共享一个下载中心。桌面版 Douzy 与 Docker基于同一套后端项目还带一个正在内测的桌面客户端粘贴链接即可开下还能同步关注列表任务中心把每次下载的数量、状态、时间都记录在案懒得配环境的也可以直接走 Docker一条命令挂载配置和下载目录就能跑docker build -t douyin-downloader . docker run -v $(pwd)/config.yml:/app/config.yml -v $(pwd)/Downloaded:/app/Downloaded douyin-downloader写在最后回头看我这两个多月的使用体验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），仅供参考