抖音批量下载器教程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 数据库去重还能自动挑选无水印视频源。本文带你用一份配置文件三步跑通环境再完整走一遍批量下载任务并教你核对落盘文件。 能力全景先看它能做什么先对照需求确认是否合适避免装完用不上解析抖音视频、图文、合集、音乐链接支持v.douyin.com短链自动展开用户主页批量下载模式可选post作品、like喜欢、mix合集、music原声增量下载按本地文件判断已存在的作品自动跳过重复运行不会白下附带动作封面/音乐/头像/JSON 元数据、评论导出、热搜榜与关键词搜索、直播录制桌面版 Douzy 基于同一后端提供图形界面与任务中心当前内测⚠️ 注意2026 年 8 月起抖音上线 Argus 风控门禁命令行直连已无法下载单个视频/图文、合集、音乐和点赞/收藏类内容用户主页作品下载依赖浏览器兜底browser_fallback。这些受限场景建议用桌面版 Douzy。 三步跑通从克隆到首次成功第 1 步安装环境与依赖。要求 Python 3.8Windows/macOS/Linux 均可git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt装完再执行浏览器兜底和自动取 Cookie 所需的依赖完成后终端不再报缺少包pip install playwright python -m playwright install chromium第 2 步准备配置并获取 Cookie。从示例配置生成你自己的 config.ymlcp config.example.yml config.yml然后运行自动 Cookie 抓取器浏览器里登录抖音后回到终端按 EnterCookie 会自动写进配置文件无需手动复制python -m tools.cookie_fetcher --config config.yml第 3 步首次运行。配置里先只放一条链接试跑看到进度条推进、无报错即为成功python run.py -c config.yml -v # -v 打开详细日志方便第一次定位问题✅ 跑一个真实任务批量下载某创作者的作品以把某创作者最近 50 条主页作品存到本地为例。先编辑config.yml只改这几处link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx # 替换为该创作者主页链接 mode: - post # 只下载主页作品 number: post: 50 # 条数上限0 表示不限运行任务python run.py -c config.yml你会看到每个作品一行进度条失败项按 1s/2s/5s 指数退避自动重试结束后终端输出本次成功/失败计数。到Downloaded/目录检查产物folderstyle: true时每个作品独立一个文件夹Downloaded/ ├── download_manifest.jsonl # 本次任务清单 └── 作者昵称/ └── post/ └── 2024-02-07_标题_aweme_id/ ├── 视频.mp4 ├── 封面_cover.jpg # 需 cover: true └── 数据_data.json # 需 json: true 小贴士如果只拿到约 20 条就停了是翻页触发了风控。确认browser_fallback.enabled: true且headless: false弹窗浏览器里手动完成验证后再等它继续翻。 避坑手册常见问题一次说清问题常见原因解决办法主页下载只拿到约 20 条抖音翻页风控限制保持browser_fallback.enabled: true、headless: false在弹窗浏览器里手动过验证码单条视频/合集报 4032026-09 起 Argus 门禁拦截 CLI 直连请求改用桌面版 Douzy或改走主页批量模式 浏览器兜底Cookie 失效、取不到数据Cookie 有有效期重新运行python -m tools.cookie_fetcher --config config.yml删了文件却不重新下载数据库与本地文件双重校验删掉对应作品目录即可触发重下只删dy_downloader.db不删文件则不会重下转写文件没生成仅视频参与转写且需 API Key依次检查transcript.enabled: true、视频非图文、OPENAI_API_KEY有效️ 进阶开关速查最常改的 6 项配置项默认值说明thread5并发下载数网络一般时 3~5 即可retry_times3失败重试次数内部按 1s/2s/5s 退避start_time/end_time空时间过滤格式YYYY-MM-DD只下载区间内作品video_qualityhighest画质档位original探测原片、highest最高转码档也可指定1080p等分辨率increase.posttrue增量下载本地已有非空主文件就跳过该作品comments.enabledfalse开启后每个作品额外输出*_comments.json评论文件更多字段直播录制、完成通知、REST 服务见 config.example.yml 内的逐行注释。适合想存档主页作品、做内容整理或批量备份的人。先跑通第 2 章三步再用一条链接验证产物落盘。请仅将本工具用于个人学习与研究尊重内容创作者的劳动成果。【免费下载链接】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），仅供参考