douyin-downloader 完整指南5 分钟跑通抖音主页批量下载【免费下载链接】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 去重。它到底能干什么这一节用四条列清楚它的核心能力后面所有操作都围绕它们展开。主页批量下载link指向/user/{sec_uid}主页mode控制下载post/like/mix/music哪种内容number限制每种模式的数量0 表示不限无水印优先自动选择无水印视频源并从video.bit_rate档里挑最高码率浏览器兜底API 分页被风控拦截时自动拉起浏览器读取页面自身的作品列表请求browser_fallback.headless: false下可人工过验证码SQLite 历史 增量database: true时写入下载记录increase控制按本地文件跳过已下载内容不想碰终端的话仓库里还附带了桌面客户端 Douzybeta粘贴抖音链接即可开始下载界面如下演示数据下载任务提交后可以在任务中心里跟踪每条任务的成功、失败数量和重跑入口第一次跑通这一节给出从克隆到看到首次成功输出的最短路径只装必要依赖。克隆仓库并进入目录git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader安装 Python 依赖要求 Python 3.8pip install -r requirements.txt浏览器兜底和自动 cookie 获取需要 Playwright再装一次pip install playwright python -m playwright install chromium复制一份配置文件config.example.yml 里每个字段都有注释cp config.example.yml config.yml获取 cookie。命令会拉起浏览器登录抖音后回到终端按回车cookie 自动写入 config.ymlpython -m tools.cookie_fetcher --config config.yml运行。示例配置默认从示例主页下载 1 条作品number.post: 1跑完在./Downloaded/下能看到结果和进度汇总python run.py -c config.yml到这里你已经完成了环境、cookie、配置、首次运行四件事。典型用法这一节给三个最小配置片段直接替换 config.yml 里的对应字段即可。批量下载创作者作品限制下载前 50 条发布作品link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx mode: - post number: post: 50文件落在Downloaded/{作者昵称}/post/{date}_{title}_{id}/filename_template可以改命名模板。只拉指定时间段配合mode: [post]使用格式为YYYY-MM-DDstart_time: 2026-01-01 end_time: 2026-06-30顺带收集评论启用后每个作品旁边多一个{date}_{title}_{aweme_id}_comments.jsoncomments: enabled: true include_replies: false max_comments: 500不想改配置文件也可以用命令行参数临时追加链接和并发python run.py -u https://www.douyin.com/user/xxxx -p ./Downloaded -t 8关键参数速查这一节列出日常最可能动的参数默认值来自 config/default_config.py。参数默认值什么情况下改path./Downloaded/换保存目录mode[post]要下喜欢 / 合集 / 音乐时number.post等0不限限制下载条数thread5提速下载过高易触发风控retry_times3失败率高时调大rate_limit2req/s被限流时调低video_qualityhighest追原片用original省流量用lowest或具体分辨率start_time/end_time空按时间范围过滤browser_fallback.headlessfalse分页被风控时保持有头模式过验证increase.posttruefalse强制重下并覆盖当前范围databasetrue需要下载历史查询时保持开启遇到坑怎么办这一节只列出现频率最高的三种情况按现象 → 原因 → 处理来。只下到 20 条左右就停了→ 主页分页触发了平台风控API 翻页被限制。 → 保持browser_fallback.enabled: true、headless: false弹出的浏览器窗口里人工完成验证别提前关窗口。cookie 过期、请求大面积失败→ 登录态失效抖音接口拒绝匿名或过期请求。 → 重跑python -m tools.cookie_fetcher --config config.yml重新获取cookie 管理逻辑见 auth/ 目录。删了文件却不再重新下载或反之→ 跳过判断是数据库记录 本地文件双重检查。只删数据库、保留文件时程序扫描本地文件名发现文件还在不会重下只删文件、保留数据库记录时则会触发重下。 → 强制重下某条内容时本地目录和数据库记录要按场景一起清理方法见 README.md 的 Re-downloading Content 一节。需要留意的是 README 中 Current Limitations 的记录自 2026-09 起抖音的 Argus 风控门拦截 CLI 对单条视频 / 图文、合集、音乐、喜欢 / 收藏的直接 API 请求返回 403主页post模式主要依赖浏览器兜底直播录制也仍标注为实验功能。这个工具解决的是把已有内容按规则批量落到本地它不做账号同步发布、批量分享之类的操作。想深入实现从 core/下载调度与 URL 解析、config.example.yml全部配置项入手即可。【免费下载链接】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），仅供参考