抖音下载效率翻倍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 是一个开源的多合一下载工具视频、图集、合集、音乐原声、直播都能抓默认去水印、自动挑选最高清版本还内置了重试、去重、断点续传和浏览器兜底。接下来这份教程不绕弯子直接带你从装环境走到玩转批量归档。主界面粘贴链接点检测工具自动识别是视频、图集还是合集先认识它一张能力清单看懂这工具有多省心开始动手前先用一张表看清它能处理哪些内容避免用到时才发现不支持内容类型入口示例说明单个视频/video/{aweme_id}自动取无水印高清源单个图集/note/{note_id}图文作品也能整组下载单个合集/collection/{mix_id}一次拿下整个合集单个音乐/music/{music_id}优先原声文件缺了会回退作者主页/user/{sec_uid}配合 mode 批量抓 post/like/mix/music我的收藏/user/self?showTabfavorite_collection收藏作品与收藏合集直播live.douyin.com/{room_id}FLV/HLS 录制下播自动保留短链v.douyin.com/...分享口令自动解析除了内容类型它还有三个省心内置值得提前知道双重去重SQLite 数据库记录 本地文件名扫描同一作品不会重复下载失败自愈指数退避重试1秒、2秒、5秒下载不完整的文件会通过 Content-Length 比对自动清理并重下风控兜底翻页受限时自动拉起浏览器让你人工过一下验证就能继续。5分钟跑通第一单安装、配 Cookie、开跑第1步 准备环境与安装依赖只需要 Python 3.8 以上版本Windows、macOS、Linux 都行。先克隆代码并装依赖git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt网络慢的话可以换成清华镜像源。如果你后面想用自动获取 Cookie或浏览器兜底功能再多装一个 Playwrightpip install playwright python -m playwright install chromium第2步 三种方式搞定登录凭证抖音大部分内容需要登录态Cookie 配置有三档可选按优先级排列全自动配置里写cookies: auto运行时自动打开浏览器引导你登录登录完按回车即写入配置整串粘贴从浏览器开发者工具复制整段 Cookie 字符串直接填进配置键值拆分分别填写msToken、ttwid、odin_tt等字段。推荐先用自动方式体验最顺命令如下cp config.example.yml config.yml python -m tools.cookie_fetcher --config config.yml第3步 写一份最小配置打开config.yml最简配置只占几行link: - https://www.douyin.com/video/7604129988555574538 path: ./Downloaded/ music: true cover: true json: true thread: 5thread: 5表示同时开 5 个下载线程music/cover/json分别控制是否顺带下载原声、封面和元数据 JSON默认都开着。第4步 执行下载并查看结果运行命令即可开下python run.py -c config.yml想临时追加链接或改参数不用动配置文件直接命令行覆盖python run.py -c config.yml -u https://www.douyin.com/video/7604129988555574538 -t 8 -p ./Downloaded命令行批量下载并发线程、进度统计、保存路径一目了然下载完成后文件会按作者名/类型/日期_标题_作品ID的结构自动归档每个作品附带 mp4、封面、原声和 JSON 元数据不需要你手动整理。进阶场景一把创作者主页整站归档做内容运营或长期跟踪某个博主时最烦的是今天存几条、明天补几条。这个工具支持对主页做四种模式的批量抓取link: - https://www.douyin.com/user/你的目标用户主页 mode: - post # 发布作品 - like # 点赞作品 - mix # 参与的合集 - music # 用过的音乐 number: post: 0 # 0 表示不限制数量全量下载 increase: post: true # 只下载新增作品配合数据库去重 start_time: 2024-01-01 end_time: 2024-12-31几个关键点帮你避坑number: 0才是全量留空或不写可能只抓前几条increase增量开关依赖数据库记得保持database: truestart_time/end_time是时间过滤器格式固定为YYYY-MM-DD同一作品在 post/like/mix 之间出现会自动去重不会下两遍。如果某次批量下载只抓到 20 条就停了多半是翻页风控把浏览器兜底打开让它在弹窗出现时人工过一下验证browser_fallback: enabled: true headless: false实时进度剩余时间估算、逐任务事件流全在界面里可查进阶场景二搭一条直播评论通知的素材监控流水线除了普通下载这工具还能做内容监控类的工作流三个功能组合起来特别实用。直播录制配置里加一条直播链接录到主播下播或指定时长中断也不丢数据link: - https://live.douyin.com/123456789 live: max_duration_seconds: 3600 # 0 表示录到主播下播 chunk_size: 65536录好的 FLV 保存在Downloaded/作者名/live/下并附带直播间元数据快照即使中途 CtrlC已录制的字节也会保留下来。评论采集想分析某条作品的评论区打开开关即可还能抓二级回复comments: enabled: true include_replies: false # 设为 true 会多拉每条评论的回复 max_comments: 500 # 0 表示不限采集结果会生成独立的*_comments.json方便后续做文本分析。完成通知下载跑完自动推送结果到手机或群聊支持 Bark、Telegram、Webhook企业微信、飞书、钉钉的机器人地址同样适用notifications: enabled: true providers: - type: bark url: https://api.day.app/你的设备Key这三个功能串起来就相当于一个自动蹲直播、采评论、发通知的小型监控台适合做账号内容复盘和竞品观察。任务中心进行中、成功、失败的记录集中管理可批量操作用数据说话一次 50 条作品的归档对比空谈不如实测下表是一次 50 条作品归档任务的耗时对比环节手动操作douyin-downloader节省逐个保存视频2-3 小时10-15 分钟约 2 小时去水印处理每条单独操作下载即无水印全部省下文件重命名整理30 分钟起自动按模板归档30 分钟查重补漏凭记忆逐个核对数据库自动跳过不可估量封面/原声/元数据基本拿不到自动附带额外收益整体算下来一次归档任务从 4 小时级别压缩到半小时以内。如果你每周都要整理素材省下的时间相当可观。让文件井井有条命名模板与档案库文件名决定日后好不好找。工具支持自定义命名模板用花括号引用可用变量folderstyle: true path: ./Downloaded/{author}/{date}_{title}_{aweme_id}/比如示例效果就是2026-04-10_今天去爬山_7412345678901234567/一眼能看出时间、标题和作品 ID。你还可以在设置里看到全部 15 个可用变量按需组合。设置页命名模板可视化配置支持按变量自由组合同时所有下载记录都会写进 SQLite 数据库它既是去重依据也是你的个人档案库。想查历史记录直接敲sqlite3 dy_downloader.db SELECT aweme_id, title, author_name, datetime(download_time, unixepoch, localtime) FROM aweme ORDER BY download_time DESC LIMIT 20;如果你偏好接口化使用还支持--serve --serve-port 8000启动 REST 服务提交链接即返回任务号方便接入自己的脚本或前端。另外--hot-board能导出热搜榜快照--search 关键词能按关键词搜索导出 JSONL适合做榜单追踪和选材调研。新手最容易踩的4个坑坑1为什么只能下载 20 条作品这是抖音翻页风控的典型表现。确认browser_fallback.enabled: true且headless: false浏览器弹窗出现后手动完成验证别急着关窗口翻页限制就会解除。坑2Cookie 过期了怎么办Cookie 一般 7-30 天有效。重新执行python -m tools.cookie_fetcher --config config.yml走一遍登录或手动更新配置文件里的 Cookie 值即可。坑3想重新下载某个作品但程序总是跳过工具靠数据库记录 本地文件双重判断去重。要强制重下需同时删除本地文件文件名含 aweme_id 的目录和数据库记录两边都清掉才会重新下载。坑4进度条刷屏、日志太吵默认progress.quiet_logs: true已经做了静默处理真要排查问题临时加--show-warnings或-v再看详细日志。坑5下载太慢或报错不断先确认thread是否合理3-5 为宜再考虑在配置里加max_per_second限制请求频率或配置proxy走代理线路。频繁报错时优先检查 Cookie 有效性。写在最后到这里你已经掌握了 douyin-downloader 从安装、配置、单条下载到批量归档、直播录制、通知推送的完整玩法。工具是开源的代码结构也很清晰想深入研究的读者可以顺着core/下载逻辑、auth/登录凭证管理、storage/去重与文件管理、server/REST 服务这几个目录往下看。最后提醒一句本工具仅供个人学习、素材管理和合法研究使用请尊重原创作者的版权遵守平台服务条款不要用于商业侵权或任何违法违规用途。合理使用让工具为你的创作效率加分。祝你的素材库越来越整齐创作越来越顺【免费下载链接】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），仅供参考