抖音下载器上手指南：从 Clone 到批量下载无水印作品只需 10 分钟

抖音下载器上手指南从 Clone 到批量下载无水印作品只需 10 分钟【免费下载链接】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。这个项目有两种使用方式先分清再选Douzy 桌面版日常使用首选粘贴链接即可下载带任务中心、作品档案等图形化面板除抖音外还支持 TikTok、YouTube、Telegram、X。Python 命令行版脚本集成首选YAML 配置驱动适合批量任务、定时任务和二次开发。需要注意一个现实限制自 2026 年 8 月起抖音接口风控陆续覆盖了作品详情、合集、音乐、喜欢、收藏等接口CLI 目前能稳定走通的主要是博主主页作品的批量下载可借助 Playwright 浏览器兜底但不保证成功。日常下载单个视频、合集等内容官方建议直接使用 Douzy。Douzy 桌面版界面一览抖音平台的主任务配置页勾选作品、喜欢、合集、音乐等下载模式并设置数量上限与筛选条件其他平台走统一的链接任务流程粘贴链接、检测、提交YouTube 工作台支持频道、播放列表与 Shorts 的扫描式处理 快速上手从 Clone 到第一次下载环境要求不高Python 3.9Windows、macOS、Linux 均可。安装分两步基础依赖加浏览器自动化支持Cookie 抓取和浏览器兜底都需要 Chromiumgit clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader python -m pip install -r requirements.txt python -m pip install playwright python -m playwright install chromium # 下载 Chromium 内核接下来配置 Cookie。把示例配置复制为config.yml运行抓取工具cp config.example.yml config.yml python -m tools.cookie_fetcher --config config.yml命令会弹出一个浏览器窗口你在里面登录一次抖音回到终端按 EnterCookie 就写入配置了。之后只需把link换成目标博主的主页链接加上数量限制即可跑通最小流程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运行后终端会用 rich 渲染实时进度完成后在./Downloaded/下得到按作者分目录的作品文件。全部命令行参数可用python run.py --help查看最常用的几个参数用途-c, --config指定配置文件默认config.yml-u, --url临时追加下载链接不替换配置中的链接可重复使用-p, --path覆盖下载目录-t, --thread覆盖并发下载数-v, --verbose输出详细日志 模块分层谁负责什么这个抖音下载器的代码组织很清晰七个子目录各司其职看目录名就能猜到职责douyin-downloader/ ├── run.py # 入口转交给 cli.main ├── cli/ # 参数解析、异步主循环、进度展示 ├── config/ # YAML 配置加载、环境变量覆盖、默认值 ├── core/ # URL 解析、API 客户端、各类下载器 ├── auth/ # Cookie 与 MS token 管理 ├── control/ # 限速、重试、并发队列 ├── storage/ # SQLite 历史库、文件管理、元数据 ├── tools/ # 浏览器 Cookie 抓取等独立工具 └── utils/ # 日志、文件名清洗、反爬签名几条值得知道的实现细节配置优先级是命令行 环境变量 配置文件 默认值环境变量用DOUYIN_*前缀方便在 CI 里覆盖。core/里用工厂模式把 URL 类型映射到具体下载器/video/、/note/、/user/、合集、音乐等链接各自路由到对应实现全部继承同一个BaseDownloader。用户主页的多种下载模式post / like / mix / music / collect以策略模式放在core/user_modes/注册表自动发现加新模式不用改主流程。全部 I/O 是异步的aiohttp aiosqlite aiofiles限速、重试、队列集中在control/下载逻辑本身保持干净。⚙️ 核心能力拆解增量下载磁盘文件说了算批量采集最怕的是重复下载。这个工具的去重逻辑是先查磁盘上该作品的非空主媒体文件是否存在存在就跳过。increase.post控制每个模式是否启用增量设为false会强制重下并覆盖当前筛选范围内的文件——不需要清空数据库。另一个开关redownload_missing_files默认true决定文件缺失时是否补下。SQLite 库只记录下载历史aweme明细表 download_history任务表不参与跳过判断所以关掉database也不影响去重。并发、限速与重试批量任务默认 5 个并发线程thread每次 API 请求间隔由rate_limit默认 2 次/秒约束失败自动重试retry_times默认 3 次。这套组合的目的是在保证速度的同时尽量不触发频率限制网络不稳时可以把retry_times调到 5。浏览器兜底翻页被限时的 Plan B当 API 翻页被风控卡住比如只返回 20 条时可以启用browser_fallback用 Playwright 驱动真实浏览器加载主页滚动采集作品 ID 再补全详情。headless: false时窗口可见方便你手动过验证码。要提前管理预期这是尝试而非保证风控收紧时可能同样拿不到数据。无水印与附带产物下载默认只保存视频本体封面、音乐、头像、原始 JSON 都是可选开关cover/music/avatar/json默认关闭。图文会优先选用无水印字段取不到才回退到带水印地址。 关键配置详解以下是最常用的配置项完整带注释的配置见 config.example.yml配置项默认值作用建议mode[post]下载模式post / like / mix / music / collect 等按目标选number.*0各模式数量上限0 不限首次试跑设 10 左右increase.*true是否增量跳过已下载长期任务保持truestart_time/end_time空日期范围YYYY-MM-DD含结束日按需video_qualityhighest画质档位original会额外探测原片省流量用lowest存原片用originalthread5并发下载数3-8 之间retry_times3失败重试次数网络差时 5rate_limit2API 请求速率次/秒被限流就调低databasetrue是否写入 SQLite 历史保持开启folderstyletrue每个作品建子目录保持开启video/cover/music/jsontrue/false/false/false各产物开关按需打开browser_fallback.*enabled: true,headless: false浏览器兜底参数见常见问题命令行参数会覆盖配置文件所以配置文件设默认、命令行做一次性调整是比较顺手的用法。️ 输出目录结构与命名模板默认folderstyle: true落盘结构是三层作者 → 模式 → 单个作品Downloaded/ ├── download_manifest.jsonl # 每行一条作品的下载清单 ├── dy_downloader.db # SQLite 历史库 └── 作者名/ ├── post/ │ └── 2024-02-07_作品标题_aweme_id/ │ ├── 2024-02-07_作品标题_aweme_id.mp4 │ ├── 2024-02-07_作品标题_aweme_id_cover.jpg # 开启 cover 后 │ ├── 2024-02-07_作品标题_aweme_id_music.mp3 # 开启 music 后 │ └── 2024-02-07_作品标题_aweme_id_data.json # 开启 json 后 ├── like/ ├── mix/ └── music/命名由两个模板控制默认都是{date}_{title}_{id}。可用变量 15 个{id}{title}{author}{author_id}{date}{year}{month}{day}{time}{hour}{minute}{second}{timestamp}{type}{mode}。日期取作品发布时间create_time缺失时回退当天并记录告警。两个容易踩的坑模板里去掉{id}虽然允许但基于文件名的判重会失效默认配置下重跑会重复下载。author_dir控制作者目录命名nickname默认直观但重名会合并、sec_uid唯一但不直观、nickname_uid兼顾重度用户推荐。切换只影响后续下载不会迁移旧目录。️ 典型工作流当你要长期跟踪一个博主把number.post设为0、increase.post保持true定期重跑同一条命令即可只补新作品。想存档更全可打开author_url: true和homepage_screenshot: true在作者根目录各存一份主页地址文本和首屏截图number: post: 0 # 不限数量 increase: post: true # 增量只下新作品 author_url: true当你只需要某个时间段的内容用start_time/end_time圈定范围格式YYYY-MM-DD含结束日比如只收集 2025 年的作品start_time: 2025-01-01 end_time: 2025-12-31当你做趋势分析而不是囤视频两条命令直接导出结构化数据为 JSONL不需要下载媒体文件python run.py --hot-board 30 # 热搜榜前 30 名 python run.py --search 关键词 --search-max 50 把下载器变成 REST 服务如果要把这个抖音下载器接入自己的系统它内置了一个轻量的 FastAPI 服务模式fastapi和uvicorn是可选依赖python -m pip install fastapi uvicorn python run.py --serve --serve-port 8000服务复用同一套配置和 Cookie接口很薄方法路径说明POST/api/v1/download提交下载任务请求体{url: ...}返回job_idGET/api/v1/jobs/{job_id}查询单个任务状态与结果GET/api/v1/jobs列出任务GET/api/v1/health健康检查任务在内存中保留server.max_jobs默认 500条完成态保留job_ttl_seconds默认 24 小时。并发数同样受thread约束。 常见问题速查现象原因解决Cookie 失效、接口返回异常Cookie 有效期有限重跑python -m tools.cookie_fetcher --config config.yml重新登录主页只抓到少量作品如 20 条API 翻页被风控限制保持browser_fallback.enabled: true、headless: false弹窗中手动过验证风控收紧时不保证成功单视频/合集/音乐链接下载失败2026 年起相关接口被风控门禁覆盖CLI 暂不可用改用 Douzy 桌面版下载想重新下载已有作品增量开关跳过了旧作品对应模式increase.*设为false无需清空数据库文件缺失或为空上次中断或写入失败保持redownload_missing_files: true默认重跑即可补下出问题时不知道卡在哪默认隐藏详细日志python run.py -c config.yml -v查看完整日志另外提醒Cookie 建议每月至少更新一次下载内容请仅用于个人学习、个人数据管理遵守平台规则与版权要求。✅ 总结douyin-downloader 把批量下载抖音无水印作品这件事做成了可脚本化的流程YAML 配置 增量去重 并发限速重试外加评论采集、转写、通知、REST 服务这些按需开启的扩展能力。架构上分层清晰core/的下载器和control/的调度是解耦的想扩展新下载模式或新通知渠道都有现成的模式可以套。建议先用默认配置跑通一次最小流程cookie_fetcher登录、number.post限制到 10 条、确认目录结构和增量行为符合预期再按需要逐项打开评论、转写、通知或服务模式。【免费下载链接】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），仅供参考