抖音去水印批量下载完整指南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-downloaderdouyin-downloader 是一款免费的开源抖音去水印批量下载工具覆盖视频、图文、合集、音乐与直播间最擅长的是把一个作者的主页作品整批抓下来做归档。它提供两个入口面向脚本与自动化场景的 Python 命令行版仅支持抖音以及面向普通用户的 Douzy 桌面版Windows / macOS另覆盖 TikTok、YouTube、Telegram、X。选错入口是新手最常见的卡点所以先把两者的边界讲清楚再按流程从零跑通。先判断该用命令行版还是桌面版两个入口共用同一套下载内核但能力边界不一样。命令行版走的是抖音开放接口加浏览器兜底目前受平台风控影响明显受限桌面版因为内置了完整的页面环境日常下载更稳。选之前先看这张对比表使用场景命令行版Douzy 桌面版单个作品视频 / 图文⚠️ 当前被抖音风控拦截✅ 支持作者主页批量采集✅ 支持依赖浏览器兜底不保证 100% 成功✅ 支持合集、喜欢、音乐、收藏⚠️ 当前被风控拦截✅ 支持时间范围筛选、数量上限、增量跳过✅✅评论采集、视频转写、完成通知✅ 可配置文档未说明TikTok / YouTube / Telegram / X❌ 不支持✅ 支持脚本化、crontab 定时、REST API 服务✅❌一句话结论要做定时化、结构化的主页采集用命令行版日常想存几条视频用桌面版。桌面版下载 Windows / macOS 安装包后粘贴链接即可在界面里选类型与数量上限还可用本地 SQLite 档案检索历史下载。命令行版怎么从零跑通环境要求只有一个Python 3.9Windows、macOS、Linux 均可。安装分三步每步给的依据不同——第一步拿代码git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader第二步装依赖python -m pip install -r requirements.txt # 全部运行依赖 python -m pip install playwright # 浏览器自动化用于取 Cookie 和兜底 python -m playwright install chromium # 安装兜底用的 Chromium后两条是主页采集能不能跑通的关键Cookie 获取和翻页受限时的浏览器兜底都依赖它。第三步登录拿 Cookie 并准备配置cp config.example.yml config.yml python -m tools.cookie_fetcher --config config.ymlWindows PowerShell 里复制文件用Copy-Item config.example.yml config.yml。cookie_fetcher会拉起一个浏览器在里面登录抖音回到终端按 EnterCookie 就写进配置了。Cookie 获取逻辑在 tools/。最后一步把示例配置改成你的目标link: - https://www.douyin.com/user/你的SEC_UID # 博主主页链接 path: ./Downloaded/ # 下载目录 mode: [post] # 采集发布作品 number: post: 10 # 先下 10 条验证0 表示不限 increase: post: true # 跳过已下载的作品然后启动python run.py -c config.yml建议第一次就把number.post设小一点跑通确认目录结构和去水印效果符合预期后再改成0放开数量。主页采集怎么配这几个字段决定结果完整字段以 config.example.yml 为准每个字段都有中文注释加载逻辑和默认值在 config/。最常改的字段如下字段作用默认值mode下载模式post/like/mix/music可组合[post]number各模式数量上限0表示不限各为 0increase增量开关true跳过已下载false重下并覆盖truestart_time/end_time发布日期窗口YYYY-MM-DD包含结束当天空不限video_quality默认highest最高转码档original会探测原片、失败自动回退也可指定 1080p / 720p 等highestthread/retry_times并发数 / 失败重试次数5 / 3redownload_missing_files主媒体文件缺失或为空时是否补下trueauthor_dir作者目录命名nickname/sec_uid/nickname_uidnicknamefilename_template文件命名模板必须含{id}避免重名覆盖{date}_{title}_{id}proxy代理地址空则不走代理空几个值得展开说的点目录自动按发布日期组织。文件夹日期前缀取作品的发布时间而不是下载时间配合folderstyle: true落盘后大致是Downloaded/作者名/post/2024-02-07_标题_作品id/这种结构无需手工整理。重下旧作品不用清数据库。增量判断看的是磁盘上的主媒体文件把对应模式的increase改成false就会重下并覆盖当前筛选范围内的文件。反过来删了文件又不想补下把redownload_missing_files关掉即可。重名博主多的时候把author_dir换成nickname_uid昵称加 sec_uid直观且唯一注意切换只影响之后下载的内容不会迁移已有目录。一段带时间窗的常用组合改完就能跑path: ./Downloaded/ start_time: 2025-01-01 end_time: 2025-06-30 video_quality: original thread: 5 mode: [post] number: post: 0把主页采集跑成长期任务命令行版真正的价值不在一次性下载而在可以无状态地反复执行。围绕长期采集有三个高频操作1. 定时增量更新。把作者主页链接写进link保持increase.post: true同一配置反复执行时已下载的作品自动跳过。把python run.py -c config.yml交给系统计划任务或 crontab 定期跑素材库只增不重。底层是 SQLite 下载历史加磁盘文件检查历史库逻辑在 storage/。2. 结构化数据导出。除了媒体文件命令行版还能把数据以 JSON / JSONL 落盘python run.py --hot-board 30 # 拉热搜榜导出 JSONL python run.py --search 美食教程 --search-max 50 # 关键词搜索最多 50 条配合配置里的json: true保存原始元数据、comments.enabled: true导出每个作品的评论 JSON*_comments.json再加上始终生成的download_manifest.jsonl下载清单一次采集就能得到媒体文件 评论 清单 历史库的全套结构化数据可以直接接进后续分析脚本。3. 命令行临时覆盖配置。不改配置文件也能改行为常用开关开关作用-u追加下载链接可重复使用不替换配置里的link-p临时指定下载目录-t临时调整并发数-v输出详细日志排查问题必备--serve --serve-port 8000以 REST API 服务模式运行需另装 fastapi uvicorn完整列表跑python run.py --help即可。下载失败怎么排查四个高频问题先对号入座再动手能省掉大量无效折腾现象原因判断解法单条视频、合集、喜欢、音乐直接失败抖音接口风控不是配置问题反复刷新 Cookie 无效日常单条下载改用 Douzy命令行加-v看详细日志下载报错、疑似登录态失效Cookie 过期重跑python -m tools.cookie_fetcher --config config.yml主页只抓到少量作品翻页被风控掐断保持browser_fallback.enabled: true和headless: false在弹出的浏览器里自己完成验证仍抓不全则属当前风控限制删除的文件没被补下redownload_missing_files被关了改回true默认值特别提醒直播录制属于实验功能HLS 源只保存播放列表不是可直接播放的视频别拿它当常规录制工具。最后说一句边界这个工具定位是个人学习与数据管理下载频率自己把握平台风控随时在变今天能跑的通路明天可能失效功能可用性以项目最新文档为准。【免费下载链接】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），仅供参考