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导出 JSONLREST API 服务集成到自己的流水线--serve后通过/api/v1/download提交任务两点需要提前知道一是抖音自 2026-08、2026-09 起的多轮风控已把点赞、收藏、单个视频等直连接口对 CLI 关闭主页作品post目前依赖浏览器兜底官方同时提供了同一后端的桌面客户端 Douzy内测中通过内置登录窗口发请求不受该门禁影响。二是下载产物结构清晰每个作品独立目录含视频、封面、音乐、JSON 元数据统一放在Downloaded/作者名/post/之下。安装与配置douyin-downloader 怎么装、Cookie 怎么配第 1 步装依赖。要求 Python 3.9macOS / 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 自动获取工具浏览器会打开抖音登录完成后回到终端按 EnterCookie 自动写回配置文件比手动复制 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?showTabfavorite_collectionmode用collect收藏视频或collectmix收藏合集即可把当前登录账号的收藏夹整体搬下来。适合定期备份自己收藏的内容注意这两种模式只能单独使用不能和 post 等混用。三个值得开启的进阶功能浏览器兜底。翻页被风控卡住、只能取到二十条时工具会按browser_fallback配置自动启动浏览器接管翻页默认有头模式你只需在弹出的窗口里完成验证。保持browser_fallback.enabled: true且headless: false是应对只抓到 20 条的标准做法相关实现在 core/downloader_base.py 的兜底链路里。增量下载与双重去重。把increase.post设为true下次运行只下载磁盘上不存在的新作品配合database: trueSQLite 历史库 记录每次下载的元数据数据库记录 本地文件名扫描双重判断删除某个作品文件就会在下轮自动补下。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），仅供参考
3 步跑通抖音批量下载：douyin-downloader 完整使用指南
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导出 JSONLREST API 服务集成到自己的流水线--serve后通过/api/v1/download提交任务两点需要提前知道一是抖音自 2026-08、2026-09 起的多轮风控已把点赞、收藏、单个视频等直连接口对 CLI 关闭主页作品post目前依赖浏览器兜底官方同时提供了同一后端的桌面客户端 Douzy内测中通过内置登录窗口发请求不受该门禁影响。二是下载产物结构清晰每个作品独立目录含视频、封面、音乐、JSON 元数据统一放在Downloaded/作者名/post/之下。安装与配置douyin-downloader 怎么装、Cookie 怎么配第 1 步装依赖。要求 Python 3.9macOS / 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 自动获取工具浏览器会打开抖音登录完成后回到终端按 EnterCookie 自动写回配置文件比手动复制 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?showTabfavorite_collectionmode用collect收藏视频或collectmix收藏合集即可把当前登录账号的收藏夹整体搬下来。适合定期备份自己收藏的内容注意这两种模式只能单独使用不能和 post 等混用。三个值得开启的进阶功能浏览器兜底。翻页被风控卡住、只能取到二十条时工具会按browser_fallback配置自动启动浏览器接管翻页默认有头模式你只需在弹出的窗口里完成验证。保持browser_fallback.enabled: true且headless: false是应对只抓到 20 条的标准做法相关实现在 core/downloader_base.py 的兜底链路里。增量下载与双重去重。把increase.post设为true下次运行只下载磁盘上不存在的新作品配合database: trueSQLite 历史库 记录每次下载的元数据数据库记录 本地文件名扫描双重判断删除某个作品文件就会在下轮自动补下。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），仅供参考
