抖音批量下载实战3 条命令归档主页的 30 条无水印视频【免费下载链接】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你想把某个抖音号最近的 30 条无水印视频归档到本地素材库逐条从手机保存显然不现实。douyin-downloader 是一个命令行驱动的抖音批量下载工具把主页或视频链接写进 YAML 配置它会按序抓取作品、自动挑选无水印源并用本地 SQLite 数据库记录每一条已下载内容重跑时自动跳过重复作品。快速上手安装、拿 Cookie、跑通下载git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt cp config.example.yml config.yml克隆仓库、装依赖并把示例配置复制成config.yml。示例配置里预置了一个主页链接和number.post: 1意味着首次运行只下载 1 条作品适合验证环境。python -m tools.cookie_fetcher --config config.yml自动弹出浏览器窗口登录抖音后回到终端按回车Cookie 就被写回config.yml。这是唯一需要手动登录的步骤之后可长期使用想启用浏览器兜底功能需先执行pip install playwright和python -m playwright install chromium。python run.py -c config.yml把配置里的link改成你的目标主页、视频、合集链接都可以跑这条命令后终端会显示进度条和每条作品的下载状态成品落在Downloaded/目录。这就是抖音无水印下载的标准路径。同一套后端还做成了桌面客户端 Douzy内测中粘贴链接即可开始下载附带任务状态跟踪和本地作品档案管理命令行不顺手时可以选它。核心机制双通道兜底与数据库去重最核心的设计是双通道。程序平时走 API 直连拿作品信息和媒体流速度快当翻页被风控掐断时会自动切换到 Playwright 驱动的真实浏览器读取页面自己发出的作品列表请求弹出验证码时你可以手动完成校验任务随后继续。这也是默认配置里browser_fallback.enabled: true的原因——抖音的主页作品接口近期已对非浏览器直连返回 403浏览器兜底是目前 CLI 下保住抖音用户主页批量下载这条主线的主要手段。第二是 SQLite 去重。每条下载过的作品aweme_id都会写进本地dy_downloader.db启动时程序同时扫描本地文件名中的aweme_id做双重校验文件和库记录都在才跳过文件缺失则自动补下。再叠加默认 2 请求/秒的速率限制、指数退避重试1s、2s、5s以及下载完成后按 Content-Length 校验文件大小断网产生的残缺文件会被清理掉重试。这是把批量任务挂到后台长跑不出乱子的原因。进阶使用从主页批量归档到直播录制最常用的需求是抖音用户主页批量下载下面三个例子由浅入深。例一主页作品批量归档加时间过滤目标只归档某主页 2026 上半年发布的作品。操作link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx mode: - post # 只抓已发布作品 number: post: 50 start_time: 2026-01-01 end_time: 2026-06-30然后执行python run.py -c config.yml。结果作品落在Downloaded/作者名/post/下每条作品一个子目录文件名由filename_template模板决定封面、音乐、JSON 元数据用cover/music/json开关按需保存跨模式下载时同一aweme_id也不会重复落盘。例二增量追更每天只抓新作品目标固定跟踪几个博主只下载新增内容不重复劳动。操作配置里保持increase.post: true和database: true交给定时任务0 8 * * * cd /path/to/douyin-downloader python run.py -c config.yml dl.log 21结果程序对照数据库跳过已下载作品只有新增内容写入磁盘。桌面端形态下这件事更直观——关注页会自动标出每个博主的新增作品数点击即可下载例三直播录制中断也不丢数据目标做一次抖音直播录制保存为 FLV。操作link: - https://live.douyin.com/123456789 live: max_duration_seconds: 0 # 0 录到主播下播结果录像保存在Downloaded/作者名/live/下并附带*_room.json直播间元数据快照。主播下播、网络空闲或你按 CtrlC 中断时已录制的字节会提升为正式文件不会丢。关键选项速查选项默认值作用mode[post]下载维度post / like / mix / music可组合number.post等1示例值各模式数量上限0 表示全量start_time/end_time空时间过滤格式YYYY-MM-DDthread5并发下载数retry_times3失败重试次数指数退避video_qualityhighest码率档highest / original / lowest 或指定分辨率databasetrueSQLite 去重与下载历史browser_fallback.enabledtrueAPI 翻页受限时切换真实浏览器排障高频下载问题解答现象主页翻页只抓到 20 条左右就停住原因API 翻页通道被风控切断。解决确认browser_fallback.enabled: true且headless: false弹出的浏览器窗口里手动完成验证不要立刻关闭。现象CLI 直下单个视频 / 合集 / 音乐返回 403原因2026-08 起抖音边缘风控对aweme/detail、mix/aweme等非浏览器直连请求一律拦截带不带 Cookie、重试多少次都一样。解决这几类任务改走浏览器兜底通道或交给桌面客户端 Douzy——它通过内置登录窗口代发请求不受此门禁影响。现象删了数据库记录程序却不重新下载原因去重是数据库 本地文件名双重校验文件还在盘上就仍算已下载。解决重新下载需同时删除对应作品文件和数据库记录文件名里含aweme_id容易定位。现象个别文件反复失败或大小为 0原因网络抖动或触发限频。解决默认 3 次退避重试弱网环境可在proxy项配置代理API 与媒体下载同时生效程序会按 Content-Length 校验文件大小不完整文件自动清理重试无需手动删。现象提示 Cookie 失效下载直接失败原因登录态过期。解决重跑python -m tools.cookie_fetcher --config config.yml刷新即可。使用边界与资源索引这个工具的定位是个人学习、研究与个人数据管理下载他人内容请尊重版权不要用于二次传播或商业用途。平台侧风控随时可能收紧README 的限制说明一节列出了当前各接口的实际可用性启动大任务前值得先读一遍。仓库内部core/ 放下载逻辑与各模式策略config/ 放 YAML 加载与默认值storage/ 放数据库与文件管理想改行为时从这三个目录入手即可。建议先用number.post: 1跑一次小任务确认输出目录结构和附带文件符合预期再把数量调大完整参数说明直接看 config.example.yml每项都带中文注释功能总览与接口限制见 README.zh-CN.md。【免费下载链接】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），仅供参考