抖音无水印批量下载工具 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第一次用 douyin-downloader 时我只想保存一位美食博主最近发的 30 个视频。手动录屏有平台水印在线解析网站画质压得一塌糊涂一个个右键保存更是折磨。抱着试试看的心态敲下python run.py -c config.yml十几分钟后Downloaded文件夹里整整齐齐躺着 30 个无水印原画质视频、30 张封面和 30 段原声。这篇文章记录的就是我从零上手这款开源工具的完整过程覆盖安装、配置、进阶玩法和踩坑修复照着做你也能跑通。30 秒看懂它能做什么适合谁douyin-downloader 是一款面向实用场景的抖音下载工具核心能力是去水印批量下载支持视频、图文、合集、音乐原声、作者主页、收藏夹等多种内容类型并自带进度展示、失败重试、SQLite 去重和浏览器兜底。能力说明适合谁单个视频/图文/合集/音乐下载粘贴链接即下自动选无水印高清源普通用户随手收藏作者主页批量下载一次拉取发布、点赞、合集、音乐作品追更博主、素材收集者收藏夹下载下载当前登录账号收藏的作品与合集重度用户直播录制解析直播流FLV 保存下播保留已录数据直播回放收藏评论采集 / 热搜 / 搜索导出评论 JSON、热搜榜 JSONL、关键词搜索数据分析爱好者REST API 服务模式把下载能力封装成 HTTP 接口二次开发者项目同时维护着两套入口根目录的DouYinCommand.pyV1.0 稳定版单视频下载最稳和douyin-downloader/目录下的run.py功能最全的重构版。后面我会先讲两条最快路径再分层递进讲配置。最快跑通两条路选一条五分钟看到第一个视频落地路径 AV1.0 稳定版三步下载单个视频# 1. 安装依赖 pip install -r requirements.txt这一步把 aiohttp、pyyaml 等核心依赖装进当前 Python 环境是后续所有命令的前提。# 2. 复制配置模板并编辑 link 与 path cp config.example.yml config.yml# 3. 运行默认读取当前目录 config.yml python DouYinCommand.py把config.yml里link换成你的视频分享短链程序会自动解析短链、抓取无水印地址并下载到path指定目录。整个流程全自动几秒完成下载。路径 B重构版 run.py一条命令下载作者主页# 在 douyin-downloader/ 目录下 pip install -r requirements.txt cp config.example.yml config.yml python run.py -c config.ymlrun.py是重构版主入口-c指定配置文件。它聚合了批量、去重、重试、浏览器兜底等全部能力适合作为长期主力工具。无论走哪条路你都会在控制台看到类似的进度输出成功 1/1、用时、保存路径一清二楚。第一步配置Cookie 的三种获取方式抖音需要登录态才能访问内容Cookie 是运行前提。config.example.yml里写了三种方式按优先级从上到下# 方式一自动获取推荐需要 Playwright cookies: auto # 方式二直接粘贴整串 Cookie # cookies: msTokenxxx; ttwidxxx; odin_ttxxx; ... # 方式三键值对逐项填写 # cookies: # msToken: xxx # ttwid: xxx # sid_guard: xxx方式一最省事前提是先装 Playwrightpip install playwright python -m playwright install chromium然后用项目自带的抓取脚本扫码登录后自动写入配置python -m tools.cookie_fetcher --config config.yml登录抖音网页版后回到终端按 EnterCookie 自动落到配置文件里无需手动复制粘贴。方式二、方式三适合你手里已经有一串有效 Cookie 的情况注意三选一不要同时保留。进阶闯关从新手到高手的配置递进新手关改三个字段先跑起来link: - https://www.douyin.com/video/7604129988555574538 path: ./Downloaded/ music: true # 下载背景音乐 cover: true # 下载封面 json: true # 保存元数据 JSON这段配置定义了下载什么、存到哪、附带哪些资源。music、cover、json默认都是true不想存可以改成false。进阶关批量与去重作者主页批量下载是高频场景配置mode指定内容类型number限制数量link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx mode: - post # 发布作品还可写 like(点赞)/mix(合集)/music(音乐) number: post: 50 # 最多 50 个0 表示全量配合database: true启用 SQLite 去重后重复运行同一配置只会补下新增内容。再加一句增量开关就能做到只下载新作品increase: post: true database: true # 增量模式依赖数据库记录高手关时间过滤、命名模板与浏览器兜底长时间挂机收集素材时建议用时间过滤框定范围避免把三年老内容全拉下来start_time: 2024-01-01 end_time: 2024-12-31下载后的文件名可以完全自定义模板变量包括{id}{title}{author}{date}{year}{month}{day}{time}{type}{mode}filename_template: {date}_{title}_{id} folder_template: {date}_{title}_{id} author_dir: nickname # 作者目录命名可选 nickname/sec_uid/nickname_uid注意模板里至少要保留{id}否则重名作品会互相覆盖。当 API 翻页被风控、只抓到 20 条时浏览器兜底会启动真实浏览器帮你继续翻页browser_fallback: enabled: true headless: false # 弹窗出现后手动完成验证别急着关窗口 max_scrolls: 240实战演练三个真实场景的完整配置场景一追更博主主页全量备份把一位创作者的发布、点赞、合集、音乐一次拉全跨模式自动按aweme_id去重不会重复下载link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx mode: - post - like - mix - music number: post: 0 like: 0 mix: 0 music: 0 path: ./博主备份/下载完你会得到一个按作者、按内容类型分层的目录结构视频、封面、音乐、元数据 JSON 各归其位Downloaded/ └── 博主名/ └── post/ └── 2024-02-07_作品标题_aweme_id/ ├── ...mp4 ├── ..._cover.jpg ├── ..._music.mp3 └── ..._data.json场景二直播间回放录制把直播链接放进link程序自动解析直播流并给出清晰度选项python DouYinCommand.py -l https://live.douyin.com/123456789 -p ./直播存档-l传直播链接-p指定存档目录。录制参数可在配置里微调主播下播、网络空闲或手动中断时已录制的字节都会被保留为正式文件link: - https://live.douyin.com/123456789 live: max_duration_seconds: 0 # 0 录到主播下播 idle_timeout_seconds: 30场景三数据分析热搜榜与关键词搜索做内容趋势分析时不需要下载视频本体只要结构化数据。run.py提供了两个轻量出口# 拉取热搜榜前 30 条导出 JSONL python run.py --hot-board 30 -p ./Downloaded # 关键词搜索猫咪最多 100 条导出 JSONL python run.py --search 猫咪 --search-max 100 -p ./Downloaded结果分别落在Downloaded/hot_board/和Downloaded/search/下每条含标题、热度等元数据可直接进 pandas 处理。更进阶的做法是开启comments.enabled采集评论每个作品会额外生成*_comments.json点赞数、评论内容、二级回复都在里面适合做用户反馈分析。避坑手册五个高频问题一次讲清问只能抓到 20 条作品翻页就没了排查这是翻页风控的典型表现。解决确认browser_fallback.enabled: true且headless: false浏览器弹窗出现后手动完成验证码不要立即关闭窗口。问Cookie 失效下载全部报错排查控制台会出现登录相关的错误日志。解决重新执行python -m tools.cookie_fetcher --config config.yml扫码刷新几秒即可恢复。问进度条刷屏日志被淹没排查进度阶段默认会打印大量行。解决配置里progress.quiet_logs: true即可静默进度日志需要调试时再加--show-warnings或-v临时打开。问想重新下载某个作品但它被跳过了排查程序通过数据库记录 本地文件双重检查判断是否已下载只删数据库不删文件不会触发重下。解决同时清理对应 aweme_id 的本地目录和数据库记录sqlite3 dy_downloader.db DELETE FROM aweme WHERE aweme_id aweme_id;先删掉Downloaded/作者名/post/*_aweme_id/目录再删数据库行。问下载很慢怎么办排查默认并发 5、默认速率限制 2 请求/秒慢通常是网络或线程数问题。解决在配置里调thread: 8视机器配置而定或给proxy填上代理地址如http://127.0.0.1:7890。收尾照着这份行动清单走完克隆仓库git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader进入目录装依赖pip install -r requirements.txt需要自动 Cookie 时再加装 Playwright配 Cookie运行python -m tools.cookie_fetcher --config config.yml扫码登录跑最小用例python DouYinCommand.py或python run.py -c config.yml先验证单视频下载按需进阶从进阶闯关和实战演练里挑一个场景配置抄进config.yml定期维护Cookie 失效就重跑抓取脚本升级代码前备份config.yml与数据库文件最后提醒一句工具本身开源免费但请尊重原创内容版权仅在个人学习、研究或合理使用范围内使用下载内容并留意平台规则与接口策略的变更。项目地址https://gitcode.com/GitHub_Trending/do/douyin-downloader开源协议MIT License适用平台Windows / macOS / Linux依赖环境Python 3.8另有可选依赖 Playwright、fastapi uvicorn【免费下载链接】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），仅供参考