3 步跑通抖音批量下载：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 历史管理，帮你把"收集抖音内容"这件事变成一条命令的事。
它的能力清单：douyin-downloader 能下载什么
| 能力 | 适用场景 | 亮点 |
|---|---|---|
| 视频 / 图文单条下载 | /video、/note、/gallery及短链 | 无水印源优先，按码率阶梯自动选最高清 |
| 合集下载 | /collection、/mix | 合集内作品批量入库 |
| 音乐（原声）下载 | /music | 优先原声文件，缺失时回退到关联首条作品 |
| 用户主页批量 | /user/{sec_uid} | post / like / mix / music 四种模式，跨模式去重 |
| 收藏夹下载 | 当前登录 Cookie 对应账号 | collect/collectmix模式，须单独使用 |
| 直播录制 | live.douyin.com/{room_id} | FLV/HLS，中断或下播时保留已录数据 |
| 评论采集 | 随作品下载 | 可含二级回复，输出*_comments.json |
| 热搜 / 关键词搜索 | 舆情监控、数据收集 | --hot-board/--search导出 JSONL |
| REST API 服务 | 集成到自己的流水线 | --serve后通过/api/v1/download提交任务 |
两点需要提前知道：一是抖音自 2026-08、2026-09 起的多轮风控，已把点赞、收藏、单个视频等直连接口对 CLI 关闭，主页作品（post）目前依赖浏览器兜底；官方同时提供了同一后端的桌面客户端 Douzy（内测中），通过内置登录窗口发请求，不受该门禁影响。二是下载产物结构清晰：每个作品独立目录，含视频、封面、音乐、JSON 元数据，统一放在Downloaded/作者名/post/之下。
安装与配置：douyin-downloader 怎么装、Cookie 怎么配
第 1 步：装依赖。要求 Python 3.9+，macOS / Linux / Windows 均可。基础依赖一条命令装完；浏览器兜底和 Cookie 自动获取需要 playwright。
pip install -r requirements.txt pip install playwright && python -m playwright install chromium第 2 步：准备配置。仓库根目录自带 config.example.yml，复制一份改名即可：
cp config.example.yml config.yml第 3 步：自动获取 Cookie。这是访问抖音接口的关键凭证。运行 Cookie 自动获取工具，浏览器会打开抖音，登录完成后回到终端按 Enter，Cookie 自动写回配置文件，比手动复制 ttwid、odin_tt 省事得多：
python -m tools.cookie_fetcher --config config.yml第 4 步：跑第一条下载。最小配置只需要链接、目录、模式和数量（0 表示全量）：
link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx path: ./Downloaded/ mode: - post number: post: 0python run.py -c config.yml跑通后终端会显示 Rich 进度条，文件按"作者名 / 模式 / 日期_标题_aweme_id"组织落盘。
怎么批量下载抖音视频：三个高价值用法
创作者素材与备份。给link填多个主页链接，number.post: 50限制每人只取最新 50 条，再配start_time: 2024-01-01只取时间范围内的作品。多个链接共享一次运行，thread: 5控制并发，失败按 1s、2s、5s 指数退避自动重试。
研究与数据采集。不下载媒体也能跑：python run.py --hot-board 30 -p ./Downloaded导出热搜榜快照，--search "关键词" --search-max 100导出搜索结果 JSONL。需要互动数据时，把comments.enabled设为true，每条作品旁会多一个评论 JSON，可直接喂给后续分析脚本。
个人收藏管理。在link填/user/self?showTab=favorite_collection，mode用collect（收藏视频）或collectmix（收藏合集），即可把当前登录账号的收藏夹整体搬下来。适合定期备份自己收藏的内容，注意这两种模式只能单独使用，不能和 post 等混用。
三个值得开启的进阶功能
浏览器兜底。翻页被风控卡住、只能取到二十条时，工具会按browser_fallback配置自动启动浏览器接管翻页（默认有头模式），你只需在弹出的窗口里完成验证。保持browser_fallback.enabled: true且headless: false是应对"只抓到 20 条"的标准做法，相关实现在 core/downloader_base.py 的兜底链路里。
增量下载与双重去重。把increase.post设为true，下次运行只下载磁盘上不存在的新作品；配合database: true，SQLite 历史库 记录每次下载的元数据，数据库记录 + 本地文件名扫描双重判断，删除某个作品文件就会在下轮自动补下。
REST API 服务化。装好fastapi和uvicorn后执行python run.py --serve --serve-port 8000，即可用POST /api/v1/download提交任务、GET /api/v1/jobs/{job_id}查状态，把下载能力嵌进你的定时任务或内部系统。
常见问题与解决办法
只抓到 20 条左右就停了？原因是翻页触发了风控限制。解法：确认browser_fallback.enabled: true、headless: false，浏览器弹出后手动完成验证，不要提前关窗口。
Cookie 过期报错？原因是 Cookie 有有效期。解法：重新运行python -m tools.cookie_fetcher --config config.yml刷新一遍即可。
进度刷屏、日志重复？默认progress.quiet_logs: true已在进度阶段静默日志；调试时再临时加-v或--show-warnings查看 info/warning 输出。
单个视频 / 点赞 / 收藏夹下载失败（403 Blocked by ArgusSecurityPlugin）？原因是 2026 年抖音风控门禁拦截了 CLI 的直连 API 请求，重试无效。解法：主页作品改用浏览器兜底路径，或改用桌面版 Douzy 完成这类下载。
小结
- ✅ 视频、图文、合集、音乐、直播全类型覆盖，无水印源优先、自动选最高码率
- ✅ 批量下载带并发控制、指数退避重试、Content-Length 完整性校验
- ✅ SQLite + 本地文件双重去重，增量模式只拉新作品
- ✅ 评论、热搜、关键词搜索数据可直接导出为 JSONL
- ✅ 浏览器兜底应对翻页风控，REST API 模式方便集成
- ✅ MIT 协议开源，Dockerfile 开箱即用
按上面的四步走完，你现在就能用python run.py -c config.yml跑起第一条批量下载任务；遇到风控变化，先看仓库的 Current Limitations 一节再决定用 CLI 还是桌面版。
【免费下载链接】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），仅供参考
