抖音无水印批量下载完整指南从3分钟配好Cookie到每次重跑只下新增【免费下载链接】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 去重、失败重试、浏览器兜底全部内置认证信息只保存在本地。基于同一套后端的桌面客户端Douzy则把链接队列、任务中心和作品档案做成了图形界面适合不想碰配置文件的人。先做决策五种链接和七个模式分别下什么 这一节解决拿到一条链接到底会下载什么、mode 该怎么配。先看速查表再讲配置。单条链接会自动识别类型不用你指定你粘的链接识别为行为/video/、/note/单条视频 / 图文下载这一条/mix/、/collection/合集下载合集内全部作品/music/原声优先下载原声文件缺失时回退到该音乐下的首条作品v.douyin.com短链短链先解析还原再按上面对应类型处理/user/作者主页用户下载什么由mode决定用户主页按mode选内容源mode下载内容post作者发布的作品最常用like作者公开点赞的内容mix作者的合集music作者使用过的原声collect当前登录账号的收藏夹必须单独使用collectmix当前登录账号的收藏合集必须单独使用不能和其余模式混写数量由number按模式控制0表示全量start_time/end_time按YYYY-MM-DD过滤发布区间包含结束日期当天。画质由video_quality决定默认highest在码率阶梯里挑最高档设为original会额外探测上传原片比最高转码档大时才下载。去重是跨模式自动的——同一个aweme_id抖音每条作品的唯一编号同时出现在 post 和 mix 里只下载一次。一个必须知道的现状受平台风控影响当前命令行版本里主页作品post模式相对稳定单条视频/图文、合集、音乐、点赞、收藏等接口可能被风控拦截官方 README 建议日常下载使用 Douzy 桌面版。最短上手装环境、抓Cookie、下到第一个无水印文件 这一节解决从零到磁盘上出现第一个文件的最短路径。环境要求 Python 3.9Windows、macOS、Linux 均可。第一步装依赖git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt要启用浏览器兜底或自动获取 Cookie再加装pip install playwright python -m playwright install chromium。第二步3分钟配好 CookieCookie 就是你登录抖音后的身份凭证工具靠它访问接口cp config.example.yml config.yml python -m tools.cookie_fetcher --config config.yml它会自动打开浏览器引导你登录抖音登录完成后回到终端按 EnterCookie 就写回配置文件了。已有有效 Cookie 的话直接编辑配置里的cookies字段即可。第三步跑第一次下载python run.py -c config.yml命令行参数可以临时覆盖配置-u追加链接、-t并发数、-p输出目录。想以 REST API 方式提交任务加--serve参数需额外安装 fastapi 和 uvicorn。把内容库管好目录层级和文件名模板怎么定 这一节解决下载多了之后文件怎么找。默认输出到./Downloaded/folderstyle: true时每个作品独立一个子目录group_by_mode: true默认会在作者目录下再分一层post/like/mix。有个容易踩的点默认只保存视频本体music、cover、avatar、json全部默认关闭需要显式打开author_dir: nickname_uid folderstyle: true filename_template: {date}_{title}_{id} cover: true music: true json: trueauthor_dir决定作者目录名有三个取值nickname直观但重名作者会合并、改昵称会分裂sec_uid稳定但不直观nickname_uid昵称_唯一ID兼有两者的优点。切换它只影响之后的下载不会迁移已有目录。filename_template默认{date}_{title}_{id}{id}参与命名可以防止标题重复导致的重名。最终目录长这样Downloaded/ └── 作者名/post/ └── 2024-02-07_作品标题_aweme_id/ ├── 作品.mp4 ├── 作品_cover.jpg └── 作品_data.json怎么只下新增视频双重去重规则与强制重下 ♻️这一节解决为什么有的作品被重下了以及想强制重下该怎么操作。database: true时程序会维护一个 SQLite 文件默认dy_downloader.db去重靠数据库记录 本地文件名中的 aweme_id双重检查任一处命中就跳过。各模式的增量开关是increase.post/like/mix/music默认开启日常定时任务只拉新增内容。查下载历史直接查库sqlite3 dy_downloader.db SELECT aweme_id, title, author_name FROM aweme ORDER BY download_time DESC LIMIT 20;要重新下载某条作品必须文件和记录一起清rm -rf Downloaded/作者名/post/*_aweme_id/ sqlite3 dy_downloader.db DELETE FROM aweme WHERE aweme_id aweme_id;注意判定的不对称性只删数据库记录、本地文件还在不会触发重下文件名扫描仍会命中只删文件、记录还在配合默认的redownload_missing_files: true会触发重下。桌面端的任务中心同样提供按任务重试失败项的入口。跑挂了也不怕兜底、重试、代理、通知、转写都按需打开 这一节解决出问题了该打开哪些开关以下能力全部可选按需启用。浏览器兜底翻页受限时browser_fallback默认enabled: true会启动浏览器继续抓取headless: false会弹出可见窗口出现验证码时手动完成再关max_scrolls和idle_rounds控制滚动上限与空闲判定。失败重试与限速默认retry_times: 3按 1s、2s、5s 退避rate_limit默认 2 请求/秒下载后做 Content-Length 完整性比对Content-Length 是服务器声明的文件大小比对不过说明下了一半不完整的文件自动清理并重试。代理proxy配置一个地址API 请求和媒体下载都走同一出口适合网络受限场景。完成通知notifications的 providers 支持 bark、telegram、webhook 三类多路并发推送单路失败不影响下载主流程。评论采集comments.enabled: true开启include_replies决定是否拉二级回复max_comments为 0 表示不限量结果落在*_comments.json。语音转写只对视频作品生效图文不生成。开启transcript.enabled后默认先用 ffmpeg 本地抽出单声道 mp3 再上传规避 25MiB 的单文件上限密钥建议走环境变量OPENAI_API_KEY输出.transcript.txt和.transcript.json两个文件状态记录在数据库的transcript_job表。三个高频坑直答 ⚠️这一节解决实际使用中最可能撞上的三件事。只能抓到 20 条作品这是翻页风控的典型表现。确认browser_fallback.enabled: true且headless: false浏览器弹窗出现后手动完成验证不要立刻关闭窗口翻页才会继续。为什么有条作品被重新下载了双重去重下数据库有记录但磁盘文件缺失且redownload_missing_files为true就判定为需要补下。反过来只删库记录不删文件不会重下所以强制重下要文件和记录一起清。Cookie 失效了怎么办重跑一遍python -m tools.cookie_fetcher --config 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），仅供参考