抖音批量下载工具指南：3步跑通无水印视频与主页-迪斯科星球

抖音批量下载工具指南：3步跑通无水印视频与主页

【免费下载链接】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 去重和浏览器兜底。适合需要批量收集素材的内容创作者、做数据采集的研究者，以及想把它集成进自己工作流的开发者。

能力全景：先看适不适合你

维度	覆盖内容
内容类型	短视频、图文/图集、合集、音乐原声、直播录制、作者主页批量、收藏夹
核心能力	无水印优先、最高码率自动挑选、并发下载、指数退避重试、数据库+文件双重去重、增量下载、浏览器兜底、完整性校验
数据产出	视频文件 + 封面/音乐/头像/JSON 元数据、评论 JSON、搜索与热搜 JSONL、下载清单 manifest
运行形态	命令行 + YAML 配置、REST API 服务模式（`--serve`）、Docker
典型场景	竞品账号作品归档、话题样本采集、评论数据获取、直播存档、个人收藏备份

不想看命令行的话，它还有一个桌面客户端 Douzy（内测中），粘贴链接直接下载，任务中心可视化跟踪进度：

最短路径上手

全程三件事：装依赖、拿 Cookie、跑一条命令。

git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader && pip install -r requirements.txt

然后复制config.example.yml为config.yml，自动获取 Cookie（会打开浏览器，登录抖音后回终端按 Enter，自动写回配置）：

python -m tools.cookie_fetcher --config config.yml

最小可运行配置，一个作者主页前 50 条作品：

link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx path: ./Downloaded/ mode: - post number: post: 50 thread: 5 retry_times: 3 database: true

运行：

python run.py -c config.yml

看到进度条走完、Downloaded/作者名/post/下出现按"日期_标题_ID"命名的文件夹，就算跑通了。

能力拆解：从链接到二次利用

拿到链接。把链接丢进link即可，工具自动识别 9 种链接形态：单视频/video/、图文/note/或/gallery/、合集/collection/、音乐/music/、用户主页/user/、当前账号收藏夹/user/self?showTab=favorite_collection，以及v.douyin.com短链（含裸 host）。短链不用手动还原。

下载过程。默认 5 并发、2 请求/秒限速、失败按 1s/2s/5s 指数退避重试。视频源自动选无水印版本，并从bit_rate档位里挑最高码率；下载后按 Content-Length 校验，不完整会自动清理重试。关键场景是翻页被风控卡住时：browser_fallback默认开启且非 headless，会弹真实浏览器让你手动过一次验证，避免"只能抓到 20 条"。

文件落地。默认目录结构按"作者/模式/日期_标题_ID"三层组织，每个作品一个子目录，内含视频本体；cover、music、json、avatar默认关闭，按需开启（默认全开会多出几倍文件）。开启database: true后，SQLite 记录下载历史，再次运行同一配置自动跳过已下载内容；increase控制各模式是否只拉新增作品，适合定时任务。

Downloaded/ ├── download_manifest.jsonl └── 作者名/ └── post/ └── 2024-02-07_作品标题_aweme_id/ ├── ...mp4 / _cover.jpg / _music.mp3 / _data.json

二次利用。这是批量下载比单条下载值钱的地方：

评论采集：comments.enabled: true，每个作品旁生成*_comments.json，include_replies: true可带二级回复（请求量翻倍，按需开）
数据导出：python run.py --search "关键词" --search-max 100或--hot-board 30直接落 JSONL，不下载媒体只要元数据
视频转写：transcript.enabled: true+OPENAI_API_KEY，视频旁生成transcript.txt/json
集成到系统：python run.py --serve起 REST API，POST /api/v1/download提交链接、GET /api/v1/jobs/{job_id}查状态

桌面版同样基于这套后端，任务中心里可以直接看成功/失败统计、重试失败项、一键打开输出目录：

进阶调优

大流量并发：thread调到 8 左右、retry_times: 5、timeout放宽；带宽紧张时反而降并发更稳。

定期追更：增量模式配 crontab，每天只拉新作品：

0 2 * * * cd /path/to/douyin-downloader && python run.py -c config.yml >> download.log 2>&1

预期效果：第二天早上Downloaded/里只有新增作品，已下载的秒级跳过。

画质与流量二选一：video_quality支持original（探测上传原片，可能比最高转码档大数倍，每条多一次探测请求）、highest（默认）、1080p/720p等定档。要素材存档选 original，只要可播选 highest。

代理与推送：proxy: "http://127.0.0.1:7890"对 API 和媒体下载同时生效；notifications支持 Bark/Telegram/Webhook，下载完成推手机，长任务不用盯终端。

时间窗过滤：start_time/end_time（YYYY-MM-DD）直接限定作品发布时间范围，采集特定时间段样本时不用自己筛。

避坑速查

问题	常见原因	解法
主页只能抓到 20 条	翻页触发风控	`browser_fallback.enabled: true`且`headless: false`，弹窗出现后手动过验证，别急着关窗口
Cookie 失效	登录态过期	重跑`python -m tools.cookie_fetcher --config config.yml`
想重下某作品但被跳过	数据库和本地文件双重去重	文件目录和`dy_downloader.db`里的记录要一起删，单删一边不生效
终端日志刷屏	进度阶段日志未静默	`progress.quiet_logs: true`；调试时再加`-v`
部分作品失败	作品被删/设私密、网络中断	工具自动跳过继续；用`-v`看日志定位，或加`retry_times`

收藏夹模式注意两条硬限制：collect/collectmix只能下载当前登录 Cookie 对应账号的收藏，且必须单独使用，不能和post/like等混在一个mode里。

使用边界

个人学习研究、非商业内容分析、学术数据采集、个人数据管理是合理用途；商业性分发、侵权二次传播、大规模爬取干扰平台服务不在范围内。工具内置限速（默认 2 请求/秒），保持默认并发和间隔，别为了快把参数拉满。

行动清单

克隆仓库，装好依赖和config.example.yml，跑通一个单视频链接
用cookie_fetcher自动写入 Cookie，替换成你的作者主页链接，批量拉 50 条
打开database: true和increase，配一条 crontab 验证增量追更
需要元数据的话开启json和comments，把 JSONL/JSON 接到你的分析流程里

第一次跑之前先读一遍 README.zh-CN.md 的限制说明，浏览器兜底目前只覆盖post模式，这一点会影响你对 like/mix 模式的预期。

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

企业官网建设流程全解析