
抖音批量下载完整指南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 正是为此而生的开源工具支持无水印下载视频、图文、合集与音乐也能整页采集博主主页作品自带去重、重试、完整性校验与浏览器兜底把「手工存视频」压缩成「填一个配置文件、敲一条命令」。为什么手动存视频这么折腾先说痛点才知道工具解决了什么。手动方式通常卡在四个环节水印与画质网页端保存下来的多带平台标识想拿到原始无水印文件往往要绕第三方网站既慢又不安全。登录墙与风控部分内容需要登录才能看翻页到一定深度还会被要求验证批量场景下几乎是硬伤。没有元数据手动下载只得到孤零零一个视频文件发布时间、作者、点赞数、音乐信息全丢了后续归档无从谈起。重复劳动同样的视频存了两遍、文件命名乱成一锅粥整理成本远高于下载成本。这些痛点叠加起来就让「存视频」从几秒钟的事膨胀成按小时计的工作。一句话说清它是什么、适合谁douyin-downloader 是一个把「抖音链接」批量变成「本地文件」的命令行工具把链接写进配置文件它会自动解析、去水印、挑最高码率再按你定的规则分类落盘。适合三类人内容创作者收集竞品素材、整理灵感库需要批量且干净的原片。研究者与运营要做话题分析、评论采集、热度追踪需要结构化数据而非零散视频。普通收藏党只想把喜欢的作品离线保存不想折腾太多配置。先记五个亮点后面都用得上链接通吃短视频、图文、合集、音乐、用户主页、直播、短链都能解析。批量可全量number设为 0 就是不限量抓取增量模式只补新作品。无水印优先 自动选最高码率基于视频的码率数组挑最佳源。SQLite 去重数据库与本地文件双重校验跨模式也不重复下载。失败有兜底指数退避重试、完整性校验、浏览器兜底三重保险。三分钟跑通第一个下载任务第一步克隆并安装依赖git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader/douyin-downloader pip install -r requirements.txt如果打算用浏览器兜底翻页受限时自动开浏览器人工过验证再装一个 Playwrightpip install playwright python -m playwright install chromium第二步搞定 Cookie 配置Cookie 是访问抖音接口的凭证有自动和手动两条路自动获取推荐运行下面的命令会弹出浏览器登录抖音后回到终端按回车工具会把 Cookie 自动写进配置文件python -m tools.cookie_fetcher --config config.yml手动填写从浏览器开发者工具里复制 Cookie 字符串粘贴到配置文件底部的cookies字段ttwid、odin_tt、passport_csrf_token等。第三步写一份最小配置link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx path: ./Downloaded/ mode: - post number: post: 50 thread: 5 retry_times: 3 database: true progress: quiet_logs: true browser_fallback: enabled: true headless: falsemode: post表示下载作者发布的作品number.post: 50限制只取 50 条设为 0 则全量。第四步启动并观察python run.py -c config.yml终端会实时显示每个任务的进度、成功失败计数与耗时已经存在的文件会被自动标记「跳过已存在」这正是去重在起作用。进阶玩法批量、直播、热搜与搜索博主主页全量采集一个作者主页能下四种内容发布作品post、点赞作品like、合集mix、音乐原声music可以同时开启并自动跨模式去重link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx mode: - post - like - mix - music number: post: 0 # 0 不限量 like: 100配合增量开关increase.post: true每天定时跑一次就能只拉新增内容。文件会按{日期}_{标题}_{ID}模板组织开启folderstyle后每个作品一个子目录封面、音乐、头像、JSON 元数据一并落盘直播实时录制想录下重要的直播或教学场次把直播链接放进配置link: - https://live.douyin.com/123456789 live: max_duration_seconds: 3600 # 0 录到主播下播 chunk_size: 65536 idle_timeout_seconds: 30录制的 FLV 会存到Downloaded/{作者}/live/并附带直播间元数据快照。主播下播、网络空闲或按 CtrlC 中断时已录制的字节都会保留不会白录热搜榜与关键词搜索不需要指定链接也能拿数据。导出当天热搜榜前 30 条python run.py --hot-board 30 -p ./Downloaded # 输出./Downloaded/hot_board/日期.jsonl按关键词搜索作品默认最多 50 条可用--search-max调整python run.py --search 猫咪 --search-max 100 -p ./Downloaded # 输出./Downloaded/search/猫咪_日期.jsonl结果以 JSONL 结构化落盘方便后续做二次分析。评论采集与视频转写需要互动数据时开启comments每个作品会额外生成*_comments.json可含二级回复想让视频自动出文字稿开启transcript调用 OpenAI 转写接口会生成txt与json两种稿子。附如果不想碰命令行同团队还做了桌面版 Douzy内测中粘贴链接即可下载、可视化管理任务。工具内核是同一套从桌面版切入也完全 OK。原理不复杂三个生活化比喻去重像图书馆登记簿每个作品下载前先查「登记簿」SQLite 数据库再对照书架本地文件确认是否真存在。两个都查过才动手所以重复下载、中断后重跑都不会白费流量。下载策略像双通道电梯默认走 API 通道又快又省一旦 API 被风控挡住比如翻页受限自动切到浏览器通道弹出真实浏览器慢慢滚动抓取必要时还能人工过验证码。两条腿走路成功率自然高。质量挑选像买菜挑最新鲜的接口返回的视频源会带码率数组工具按码率自动挑最高清的版本没有无水印源时再退而求其次宁可降级也不给水印版。整个程序大致是「数据层SQLite 记录与去重— 引擎层链接解析、认证、抓取、下载— 应用层命令行 / REST API」的三段结构理解了这个调参时心里就有谱了。避坑指南四个常见误区与三个高频问答误区一并发越大越快thread调高确实能提速但超过平台承受能力会触发风控反而被限流。实践上 5~8 比较稳妥配合retry_times和指数退避重试1s、2s、5s更省心。误区二只抓到 20 条就停以为是工具坏了这是典型的翻页风控。先确认browser_fallback.enabled: true、headless: false让浏览器弹窗出现后手动完成验证再等它继续不要一弹窗就关。误区三Cookie 配一次就一劳永逸Cookie 会过期。当出现登录相关报错时重跑一次python -m tools.cookie_fetcher --config config.yml刷新即可。误区四下载一半断了之前全白下不会。工具自带完整性校验比对文件大小不完整的文件会被清理并自动重试直播录制中断也会保留已录数据。问答环节Q直播的 HLS 源存下来打不开AHLS 源只保存 playlist 文件需要再用 ffmpeg 后处理合并FLV 源则可直接播放录直播优先选 FLV。Q报错信息看不懂A加-v或--verbose运行能看到 info 级别的详细日志定位到具体是解析、认证还是下载环节出问题。Q想批量下载自己收藏夹的内容A把链接换成/user/self?showTabfavorite_collectionmode用collect收藏作品或collectmix收藏合集注意这两种模式需单独使用。合规边界工具是中立的使用要克制douyin-downloader 默认只按约 2 请求/秒的频率访问接口并提供了可调的限速与并发参数本意就是不干扰平台服务。合理的用法包括个人收藏与学习、非商业性内容分析、学术数据采集、内部培训素材整理。请避免二次分发他人版权内容、大规模爬取干扰平台、采集与内容无关的用户隐私。同时记得尊重创作者注明来源、不用于恶意竞争、遵守平台内容协议。工具省下的是时间不是责任。总结现在就能开始的第一步 回顾一下这个工具解决的核心问题就一句话——把「抖音视频批量下载」从手工苦力活变成可配置、可重跑、可自动化的流程。它不追求花哨胜在把去重、重试、画质、元数据这些琐碎细节都替你打理好了。行动清单克隆仓库、装依赖跑一次cookie_fetcher拿到有效 Cookie从最小配置开始先下载一个视频验证链路按你的场景逐步加like / mix / music、增量、评论或转写把命令挂进定时任务crontab 或任务计划程序实现自动同步。从一条视频开始用半小时熟悉它之后你会发现原来整页博主的作品、整场直播、整张热搜榜都可以是「一条命令」的事。【免费下载链接】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),仅供参考