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 是一款免费开源的抖音批量下载工具粘贴链接即可自动下载无水印视频支持作者主页批量下载重复运行时自动跳过已下载内容。它覆盖视频、图文、合集、音乐四类内容附带直播保存、进度条展示和失败重试。 能下载什么视频、图文、合集、音乐与直播流这个项目覆盖以下下载能力全部通过配置文件加命令行驱动默认自动挑选无水印源和最高码率单个视频 / 图文 / 合集 / 音乐优先原声文件短链 v.douyin.com 自动解析作者主页批量下载mode 支持 post / like / mix / music 四种模式当前登录账号的收藏夹与收藏合集collect / collectmix需单独使用直播流保存FLV/HLS下播保留已录数据、评论采集、热搜榜与关键词搜索导出SQLite 数据库加本地文件双重去重、增量下载、指数退避重试、翻页受限时的浏览器兜底可选视频转写OpenAI API、下载完成 Bark / Telegram / Webhook 推送、REST API 服务模式与同类工具最大的差异去重、增量与浏览器兜底内建在默认配置里第二次运行自动跳过已下载内容无需手动清理。安装与环境配置克隆、装依赖、拿 Cookie环境只要求 Python 3.8macOS、Linux、Windows 均可。运行下面四条命令完成克隆、装依赖和初始化配置git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt cp config.example.yml config.yml配置就绪后最关键的一步是获取 Cookie运行python -m tools.cookie_fetcher --config config.yml程序会弹出浏览器窗口登录抖音后回到终端按 EnterCookie 会自动写入 config.yml。⚠️前置条件必须有一个已登录抖音账号的浏览器。Cookie 是访问抖音数据的凭证也是新手最容易卡住的一步后续下载出现 403、提示需要登录时先检查 Cookie 是否还有效。若要用浏览器兜底功能另跑pip install playwright并执行python -m playwright install chromium。配置完成后同源的桌面版 Douzy内测中见仓库 Releases也可以接管下载粘贴链接、点下载即可下方是它的抖音链接下载工作台 从单条链接到批量下载三种跑法入口统一是python run.py -c config.yml区别只在于传什么链接、配什么模式。下载单个视频或图文打开 config.yml把作品链接填入link字段也可以直接在命令行用-u传入。执行下面命令运行之后会看到 Rich 进度条完成后文件落在Downloaded/下。确认 mp4 已保存封面、音乐、JSON 元数据是否附带取决于cover/music/json开关。python run.py -c config.yml -u https://www.douyin.com/video/7604129988555574538 -p ./Downloaded批量下载作者主页作品打开创作者主页复制浏览器地址栏里含/user/sec_uid的完整链接。在配置里填link、mode、number其中number.post为 0 表示全量建议先设 20~50 试跑。执行python run.py -c config.yml达到数量或主页翻不动时自动停止。link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx mode: [post] number: { post: 50 }保存直播流与特殊内容把https://live.douyin.com/{房间号}链接填入link工具会按直播任务保存live.max_duration_seconds设为 0 会一直录到主播下播中断时已保存的字节也会保留。FLV 可直接播放HLS 源只保存 playlist 文件需要 ffmpeg 后处理。配置文件关键字段时间区间、画质与并发日常最常调整的字段都在 config.yml 里默认值来自 config.example.ymlmode: [post] # post / like / mix / music number: { post: 50 } # 0 不限 start_time: 2026-01-01 # 只抓该日期之后的作品 end_time: 2026-06-30 thread: 5 video_quality: highest comments: { enabled: true }start_time/end_time按时间区间过滤格式 YYYY-MM-DD批量抓取主页时避免拉进几年的老内容。video_quality默认 highest 取最高转码档original 会额外探测上传原片文件更大画质更好也可指定 720p、1080p 等档位匹配不到自动降级。comments.enabled开启后每个作品旁会生成*_comments.json可选二级回复。参数默认值推荐值thread53~5网络差时调低number.post0 不限先设 20~50 试跑video_qualityhighestoriginal磁盘充足时start_time不限制填写避免全量抓取三种常见场景个人收藏、批量研究、直播存档三个场景共用同一套命令区别只在配置组合。个人收藏你的目标是把喜欢的几条视频留在本地反复看 → 推荐路径单链接模式 默认配置自动去水印后直接落盘 → 注意重复运行同一链接会自动跳过不会重复占磁盘。批量研究你的目标是拿一位创作者近三个月的更新连同评论做分析 → 推荐路径主页链接 mode: [post] 时间区间过滤 comments.enabled: true并保留increase.post: true之后每次运行只拉新作品 → 注意若只抓到 20 条说明翻页触发了风控保持浏览器兜底开启并在弹出的窗口里手动完成验证。直播存档你的目标是保存一场重要直播 → 推荐路径直播链接 live.max_duration_seconds: 0录完 FLV 落在Downloaded/{作者}/live/下并附直播间元数据快照 → 注意直播录制接口覆盖的场景有限README 标注为实验性功能。Downloaded 输出目录与文件命名规则默认folderstyle: true时输出按「作者 / 模式 / 作品」三层组织Downloaded/ └── 作者名/ ├── post/ │ └── 2024-02-07_作品标题_aweme_id/ │ ├── xxx.mp4 │ ├── xxx_cover.jpg │ └── xxx_data.json └── live/命名默认模板是{date}_{title}_{id}文件名里固定包含 aweme_id去重就靠它想改格式用filename_template作者目录名可用author_dir切换昵称或 sec_uid。常见卡点速查风控 403 到重下载不触发下表对应 README 中的常见问题先对现象再找原因现象可能原因处理建议单个视频 / 合集下载失败返回 403抖音 Argus 风控拦截 CLI 直连2026-08 起逐步加严开启浏览器兜底并在浏览器里过验证或改用桌面版 Douzy主页只能抓到 20 条作品翻页被风控限制browser_fallback.enabled: true 且 headless: false弹窗后手动过验证下载中断、提示需要登录Cookie 失效重跑python -m tools.cookie_fetcher --config config.yml改了文件却触发不了重下载数据库记录 本地文件双重去重本地文件和 sqlite 记录要同时删没生成 transcript 文件开关未开 / 图文不转写 / 缺 API Key确认是视频作品且 OPENAI_API_KEY 有效进度条重复刷屏日志未静默保持 progress.quiet_logs: true调试时再加 -v核心目录职责与改代码前的验证方式想改代码的话先看这四个位置core/各内容类型的下载引擎url_parser.py 负责解析链接video_downloader.py、user_downloader.py 分别处理单条与主页作品live_downloader.py 处理直播auth/Cookie 与 msToken 的管理、失效重登逻辑都在这里storage/SQLite 去重、下载历史与文件落盘管理tools/cookie_fetcher.py浏览器自动获取 Cookie 的入口所有配置默认值集中在 config/default_config.py改动手前先跑python3 -m pytest -qtests/ 下的用例覆盖了下载、去重、风控处理等核心路径通过与否能最快验证改动是否破坏现有行为。先跑通单条再扩展到批量douyin-downloader 是一个以「粘贴链接即可归档」为设计目标的免费开源命令行工具单条与批量、去重与增量、直播与评论采集开箱即用Cookie 配置一次可长期复用。建议的节奏是先跑通单条视频下载再试小数量主页作品最后放开到批量与直播。本项目仅供技术学习与个人内容归档使用请尊重原创作者权益并遵守平台服务条款与相关法律法规。【免费下载链接】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），仅供参考