抖音主页批量下载完整教程4 步把 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上周六凌晨四点我被硬盘灯叫醒——config 里的 number 忘了改整个主页批量下载还在往磁盘里灌。这篇用本地抖音批量下载工具 douyin-downloader去水印、SQLite 去重带你从零跑通装环境、拿登录态、首次运行、定时任务。同后端桌面版工作台粘贴链接后自动识别作品类型界面为演示数据能力边界抖音批量下载工具能干什么、不能干什么先说结论主页批量下载是它的强项但 2026 年 9 月起部分 CLI 直连接口被抖音风控挡下动手前先看边界。能做的作者主页作品post、点赞、合集、音乐四种模式批量下载单个链接评论采集热搜榜与关键词搜索默认无水印按码率自动挑最高清。要留意的2026-08 起点赞/收藏夹接口、2026-09 起单个视频/图文/合集/音乐接口对 CLI 直连一律 403主页作品 API 翻页同样被拒——需保持浏览器兜底playwright开启或改用同后端的桌面版 Douzy官方 README 已标注此限制。为什么本地跑比解析站稳请求直连接口Cookie 只存在自己机器上不过第三方服务器没有每日次数限制服务方说关就关的风险为零。做不到的绕不过风控也拿不到非公开内容收藏夹类模式仅限当前登录账号自己的数据。收藏与收藏合集按集合一键下载仅限登录账号自己的数据从零跑通的最小闭环抖音主页批量下载安装步骤第 1 步装好抖音下载器环境需要 Python 3.9 以上一共五条命令两分钟装完git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt pip install playwright python -m playwright install chromium cp config.example.yml config.yml前 3 条装主程序第 4 条装浏览器依赖tools/cookie_fetcher.py 的登录流程和后面的翻页兜底都靠它最后把示例配置复制成正式配置。第 2 步登录态 Cookie 一键获取python -m tools.cookie_fetcher --config config.yml会弹出一个浏览器窗口扫码登录抖音回终端按回车Cookie 就自动写回 config.yml全程不用手拼字段。我这次卡了半分钟——页面没等它加载完就按了回车重新跑了一次才成功。第 3 步首次运行与验证产物python run.py -c config.yml配置里自带一条主页链接config.example.yml 默认number.post是 1建议先改成 2 试跑。终端里每个作品一条进度条滚过去结束打印下载统计。打开 Downloaded/ 目录核对结构Downloaded/ └── 作者昵称/ └── post/ └── 2026-09-19_作品标题_aweme_id/ └── 视频.mp4每个作品独立目录命名默认日期_标题_id开了 cover/music/json 会多出对应文件如果翻页中途被风控限住浏览器兜底会自己接管弹出真实浏览器你在窗口里完成验证后别急着关它读完作品列表继续跑。桌面版任务中心把每次任务记成一笔账哪个主页、共几项、完成还是失败演示数据一份配置文件讲透只改 5 个键的最快配置方法config.example.yml 里真正要动的就这 5 处其余保持默认键作用推荐值不改会怎样link抖音主页/作品链接目标主页链接没东西可下path保存根目录./Downloaded/文件散落难找mode下载模式[post]默认就是 postnumber.post数量上限0全量先试 2默认 0 即全量磁盘有风险thread并发线程数5默认 5稳定展开讲 3 个键number.post就是开头让我凌晨四点醒来的那个键。第一次填 2确认路径和命名符合预期再放开成 00 表示不限全量拉取。database默认 true是整个去重的地基。它和 Downloaded/ 里的文件名、工作目录下的 dy_downloader.db 一起决定下过没路径定下来就别挪数据库也别随手删。thread默认 5。程序里有速率限制默认 2 请求/秒并发拉到 20 只会多挨限流不会更快。其余常用项默认值都够用retry_times 默认 3按 1s/2s/5s 退避重试、video_quality 默认 highest、increase 默认 true、browser_fallback.enabled 默认 true。⏰ 长期无人值守用法增量下载加定时任务增量加去重的组合是关键increase.post: true且database: true时重跑只拉新发布的作品旧文件一个字节都不动。配置项翻车版正确版increase.postfalse每次都全量重扫true只拉新增databasefalse重跑全部重新下trueSQLite 去重thread1 太慢20 容易被限流5稳定retry_times0失败全靠手动补3自动重试定时任务一行命令Linux crontab每天凌晨 4 点Windows 换成任务计划程序0 4 * * * cd /path/to/douyin-downloader python run.py -c config.yml配合增量开关博主当天新发的作品会在半夜自动补进本地库第二天早上打开目录就是最新的。桌面版关注页按博主标记新增作品有更新点一下下载即可演示数据⚠️ 避坑清单5 个高频翻车点症状一批全失败提示要登录或 403。原因Cookie 过期或撞上 2026-09 的 Argus 风控门禁。解法重跑python -m tools.cookie_fetcher --config config.yml接口仍 403 就是门禁所致保持浏览器兜底开启或改用桌面版 Douzy。症状只下了几条就停数量远小于预期。原因翻页被风控限制或 number 设了上限。解法检查 number.post 是否为 0确认 browser_fallback.enabled 为 true、headless 为 false弹窗验证完成前别关窗口。症状重跑把下过的内容又下一遍。原因database 关了或中途挪过保存路径。解法保持 database: truepath 定下来就不动。症状删了本地文件想重下却一直被跳过。原因去重是文件名里的 aweme_id 数据库双重检查只删数据库不删文件照样被跳过。解法文件与数据库记录一起清理具体命令见 README.zh-CN.md 的重新下载一节。症状跑到一半报磁盘空间不足。原因全量 音乐 封面 元数据全开体积成倍增长。解法用 start_time/end_time格式 YYYY-MM-DD卡时间窗或把 video_quality 设为 lowest 省体积。收尾回到凌晨四点那个硬盘灯number 有了上限、重跑有 database 兜底同样的事不会再发生第二次而博主哪天把作品删了本地目录里那份照样在。最后一句请只用于个人学习、研究和备份不商用尊重创作者权益。【免费下载链接】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），仅供参考