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 就是一个值得先看看的开源命令行工具。它同时支持单条作品下载和整个主页的批量抓取内置去重、重试、日期筛选和 SQLite 下载历史日常用于个人素材整理非常顺手。它解决的问题先看清楚这个项目的定位是实用而不是大而全。它面向的具体问题有这几类拿不到无水印原片。工具直接请求抖音服务端接口返回的视频源落盘的就是未叠加水印的原始文件画质取决于上传原片质量。手动保存太慢。你可以把一个博主主页丢给它配合mode与number参数一次拉取作品、喜欢、合集、音乐原声多线程并发下载。重复劳动太多。SQLite 数据库和磁盘文件双重判断实现增量下载已经下载过的作品自动跳过下次运行只补新内容或补缺失文件。过程不可控。内置速率限制默认每秒 2 个请求和失败自动重试默认 3 次并发数、画质档位、时间窗口都可在配置里约束。下载完只是一堆散文件。默认按作者/模式/作品建目录文件名带发布日期另可导出download_manifest.jsonl清单和原始 JSON方便做素材库或数据分析。此外还有几个可选增强项评论采集含二级回复、视频语音转写、下载完成通知Bark/Telegram/Webhook、关键词搜索与热搜榜导出、REST API 服务模式以及接口受限时的 Playwright 浏览器兜底。不想用就保持默认关闭。项目同时提供图形界面版本 DouzyWindows/macOS覆盖抖音、TikTok、YouTube 等平台粘贴链接即可下载并跟踪任务命令行版则专注抖音适合脚本化与批量任务。本文以命令行版为主线。环境与前置准备整个过程分四步装依赖、准备登录态、复制配置、验证运行。1. 获取代码并安装依赖需要 Python 3.9支持 Windows / macOS / Linuxgit clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt2. 安装浏览器兜底组件可选但建议装。接口分页受限时会用它补全主页作品列表pip install playwright python -m playwright install chromium3. 准备 Cookie。访问抖音内容需要有效的登录态最省事的办法是运行 Cookie 获取工具它会打开浏览器让你扫码登录然后回终端按 Enter 保存cp config.example.yml config.yml python -m tools.cookie_fetcher --config config.ymlCookie 会以 JSON 形式写入配置之后由 Cookie 管理模块 统一维护。登录态失效时程序会提示重新登录交互环境下还能自动弹出浏览器重登一次。4. 把配置文件里的示例link换成你的目标链接其余保持默认即可先跑起来。需要提前知道的限制抖音接口风控Argus 门禁目前会拦截单条视频、合集、音乐、喜欢/收藏等部分接口主页作品可走浏览器兜底但不保证成功率。若这类场景是你的主要用途建议改用 Douzy 桌面版命令行版更适合作品批量与自动化场景。核心场景实战场景一下载单条视频拿到v.douyin.com短链或douyin.com/video/...链接两种方式任选python run.py -c config.yml -u https://v.douyin.com/xxxxx/-u会追加链接不覆盖配置文件里的link可以重复传入多条。短链会先自动解析再下载。场景二主页批量下载 时间/数量筛选把博主主页地址填进link在配置里限定范围link: - https://www.douyin.com/user/xxxxxx mode: [post] start_time: 2025-01-01 # 只下载该日期之后的作品 end_time: number: post: 100 # 0 表示不限制然后执行python run.py -c config.ymlmode可填post作品、like喜欢、mix合集、music音乐原声等一次任务可以混合多种模式每条模式都能单独设上限。场景三搭建可增量的素材库首次全量下载后把increase.post保持为true默认之后每周重跑同一份配置工具会跳过磁盘上已存在的非空文件只下载新增作品。缺失的文件由redownload_missing_files默认true负责补下。落盘结构大致如下Downloaded/ ├── download_manifest.jsonl # 每次下载的明细清单 └── 作者昵称/ └── post/ └── 2025-03-01_作品标题_aweme_id/ ├── 2025-03-01_作品标题_aweme_id.mp4 ├── ..._cover.jpg # 开启 cover 后 └── ..._data.json # 开启 json 后日期取自作品发布时间而非下载时间素材归档时天然有序。场景四可选扩展python run.py --search 关键词 --search-max 50 # 关键词搜索导出 python run.py --hot-board 30 # 热搜榜导出 python run.py --serve --serve-port 8000 # 启动 REST API 服务评论采集、语音转写、完成通知均在 config.example.yml 中有对应段落打开enabled并按需填写即可转写功能依赖额外安装 whisper 相关组件。配置与参数详解日常使用只需要碰几个键完整示例见 config.example.yml默认值定义在 config/default_config.py。配置项作用建议值link目标视频/图文/主页链接列表必填path下载根目录./Downloaded/mode下载模式可多选[post]number.post各模式数量上限0 为不限按磁盘空间start_time/end_time日期窗口YYYY-MM-DD含结束日建素材库时启用video_quality画质original/highest/lowest/1440p…360phighest默认original会多一次探测请求尝试原片thread并发数3~5rate_limit每秒请求上限2retry_times失败重试次数3increase各模式增量开关设false强制重下并覆盖当前筛选范围trueredownload_missing_files磁盘文件缺失时是否补下truevideo/music/cover/json分别控制视频本体、背景音乐、封面、元数据 JSON 的落盘默认只开video按需叠加filename_template/folder_template命名模板可用{date}_{title}_{id}等变量必须含{id}防重名默认即可browser_fallback浏览器兜底开关与滚动/超时参数enabled: true、headless: falsedatabase是否写 SQLite 历史true命令行参数可临时覆盖配置优先级更高-c指定配置、-u追加链接、-p下载目录、-t并发数、-v详细日志。高频疑问与问题排查Cookie 失效或提示需要登录怎么办重新运行python -m tools.cookie_fetcher --config config.yml即可。交互环境下程序检测到登录态失效时会自动弹浏览器重登一次并继续重试不需要手动中断。主页作品只拿到几条确认browser_fallback.enabled为true、headless为false让兜底浏览器以有界面模式打开你在里面手动完成验证和滚动翻页上限由max_scrolls控制。注意接口风控严重时兜底也可能拿不全这不是配置错误。想强制重新下载一批作品把对应模式的increase设为false再运行工具会重下并原子覆盖当前筛选范围内的文件数据库无需清空想只补缺失文件则保持redownload_missing_files: true即可。下载慢或经常失败先加-v看详细日志定位卡点网络波动大时把thread降到 3、确认rate_limit不低于接口承受范围若配了proxy而代理不通会直接导致全部请求失败先排查代理。为什么有些链接解析了却下不了单条视频/图文、合集、音乐、喜欢、收藏等接口目前被抖音风控拦截工具会直接报出具体原因而不是静默失败。这类内容建议改用 Douzy 桌面版下载命令行的稳定能力集中在主页作品批量与自动化流程上。文件命名或目录想自定义改filename_template和folder_template变量清单{date}、{title}、{author}、{id}等写在配置文件注释里作者目录想避免重名合并把author_dir改为nickname_uid。横向选型参考维度douyin-downloaderCLIDouzy 桌面版在线无水印网站手机录屏画质无水印最高转码档可选原画无水印通常有压缩取决于设备含平台叠加层批量能力主页/合集/音乐多模式批量多任务队列基本单次无元数据与清单JSON manifest SQLite 历史作品档案管理无无增量去重磁盘 数据库双判断本地档案去重无无部署成本Python 环境 Cookie直接安装客户端打开即用零成本适合人群脚本化、素材库、数据分析日常收藏、多平台临时单条需求应急选型建议一句话要自动化、要留数据痕迹选 CLI要开箱即用、偶尔跨平台装 Douzy 更省事。写在最后工具能帮你高效保存内容但下载下来的作品版权仍属于创作者。请把使用范围限定在个人学习、研究与合法授权内避免高频大规模抓取遵守平台规则接口与风控会随平台变化功能可用性以最新版 README 为准。如果只想记住一件事装好依赖、配好 Cookie、python run.py -c 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），仅供参考