5分钟跑通抖音批量下载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 记录和磁盘文件双重判断跳过已下载的内容失败了自动重试下次再跑只补新增的部分。单条视频、图文、合集、音乐链接也能直接喂给它处理。下面按装好 → 登录 → 跑通 → 用好的顺序走一遍。它是什么桌面版与 CLI 版怎么选项目里有两套入口先分清场景再动手Douzy 桌面版Python CLI 版形态Windows/macOS 图形界面终端 YAML 配置覆盖平台抖音、TikTok、YouTube、Telegram、X仅抖音适合日常随手下载、批量管理任务写脚本、定时任务、自动化流水线获取方式项目 Releases 页面下载克隆仓库装依赖即可CLI 版的核心能力一张表说清批量下载用户主页作品、点赞列表、合集、音乐一条链接一个任务无水印输出默认取最高转码档可选探测上传原片断点续传增量开关 缺失文件自动重下SQLite 记录历史并发与限速线程数、请求频率、重试次数均可配置范围筛选按日期区间、数量上限控制下载范围可选副产物评论 JSON、语音转文字、下载完成通知需要直说的一点2026 年 8 月起抖音接口加了风控校验CLI 版单视频、合集、音乐等接口目前会被拦截主页作品可走 Playwright 浏览器兜底但不保证成功。日常下载建议优先用桌面版CLI 更适合熟悉命令行、愿意看日志排查的人。三步跑通第一个下载任务1. 装依赖并登录拿 Cookie需要 Python 3.9Windows、macOS、Linux 均可git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader python -m pip install -r requirements.txt登录这一步会自动弹出一个浏览器窗口你在里面扫码或输密码登录抖音然后回终端按回车Cookie 就存好了python -m pip install playwright python -m playwright install chromium cp config.example.yml config.yml python -m tools.cookie_fetcher --config config.ymlCookie 过期后重跑cookie_fetcher这条命令即可不用手动复制任何东西。2. 改配置只动 5 个字段编辑config.yml把示例链接换成你的目标主页其余保持默认link: - https://www.douyin.com/user/你的sec_uid path: ./Downloaded/ mode: [post] # 下载已发布作品like 是点赞列表 number: post: 0 # 0 表示不限制条数# ... 其他配置保持不变。配置文件完整字段说明参考 config.example.yml。3. 运行python run.py -c config.yml跑完后去Downloaded/目录看结果默认按作者名/模式/日期_标题_作品ID分层存放。常用命令行参数参数作用-u URL临时追加一个链接不用改配置-p DIR临时指定下载目录-t N临时设置并发线程数-v输出详细日志排查问题必开三个真正省时间的进阶开关增量下载下次只补新内容默认increase.post: true时工具会先查磁盘上主文件是否存在已下载的作品直接跳过。断网、中断、博主又发了新作品——重跑同一条命令就是断点续传。increase: post: true # true 跳过已下载false 强制重下并覆盖 redownload_missing_files: true # 磁盘文件丢了就补注意区分跳过判断依据是磁盘文件而不是数据库。想全量重下当前筛选范围把increase.post改成false即可不需要清数据库。按日期和数量圈定下载范围start_time: 2026-01-01 end_time: 2026-06-30 # 含结束当天 number: post: 100 # 只取前 100 条0 为不限效果只做某几个月的内容或者先小批量试跑验证 Cookie 和目录结构再放开上限跑全量。配合video_quality还能控制清晰度——highest取最高转码档默认、最快original会多一次探测请求去够上传原片720p这类值匹配不到时自动降级到最接近的档。并发、限速与代理慢和卡都在这里调thread: 5 # 并发下载线程数 rate_limit: 2 # 每秒 API 请求上限 retry_times: 3 # 单条失败重试次数 proxy: # 需要时填 http://host:port网络好就把thread提到 8~10出现大量超时或风控提示就降rate_limit、加代理。所有请求的节流和重试逻辑集中在 control/ 目录改默认行为前先看那边的实现。用起来之后的真实体验场景竞品账号内容库。之前让运营每周花两三个小时手工存视频存完还是水印版断网就白干。现在主页链接丢进配置跑完一杯水的功夫Downloaded/里是带日期分层的无水印文件每周一重跑一次只补增量。场景按时间倒查旧内容。以前要翻几个月主页才能找齐某段时间的作品现在start_time/end_time一填直接只下载目标区间。踩坑提醒CLI 版只下出来几条保持browser_fallback.enabled: true且headless: false弹出的浏览器里手动过完人机验证再回终端报登录失效重跑cookie_fetcher仍不行就加-v看详细日志想省事日常下载直接用桌面版CLI 留给自动化下一步与合规边界想深入的话两个入口最值得看core/ 里的 URL 解析与下载器分发是二次开发的主战场可选功能还有热搜/关键词搜索导出 JSONL、评论采集、语音转文字和下载完成通知Bark/Telegram/Webhook都在 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），仅供参考