douyin-downloader 抖音批量下载快速上手教程10 分钟去水印归档博主全部作品【免费下载链接】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是一个命令行抖音批量下载工具基于 Cookie 登录态去水印下载视频、图文、合集与原声自带 SQLite 去重和浏览器风控兜底。装好依赖、扫一次码大约 10 分钟你能把配置跑通让第一条无水印 mp4 落到本地。先说一句实话抖音接口风控目前会拦截 CLI 的单条视频/图文、合集、音乐等下载路径见 README.zh-CN.md 的命令行版现状。所以本文按最稳的路径走——整页主页作品归档加增量追更单条链接只用来验证环境。 它做什么不做什么它能做无水印下载自动选档默认取最高转码档video_quality可改original探原片或指定720p、540p这类分辨率链接即入口-u传单条链接v.douyin.com短链自动解析配置里link传博主主页增量不重下已下载作品记进dy_downloader.dbincrease.post默认开启重跑只补新增风控兜底翻页被拦时browser_fallback拉起真实浏览器Playwright 驱动 chromium留给你手动过验证附带产物可选music、cover、json默认全关打开才额外保存原声、封面、作品数据它不擅长单条视频/图文、合集、音乐页当前接口风控会直接拦截 CLI 请求更新 Cookie 或反复重试都绕不过日常零散下载几条视频官方 README 建议改用同源桌面版 Douzy命令行版更适合长期批量归档 首次跑通安装、扫码登录到数据库就绪环境要求 Python 3.9 以上Windows、macOS、Linux 都能用。先把代码拉下来下面的命令都在仓库根目录里执行。git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader装 Python 依赖pip install -r requirements.txt装完跑python -c import aiohttp, yaml, rich没有任何输出就是依赖齐了。Cookie 获取和风控兜底都靠 Playwright 驱动的真实浏览器先把浏览器内核装好pip install playwright python -m playwright install chromium看到 chromium 下载完成的提示、进度走完这步就成了。接下来是登录环节。Cookie 是浏览器的登录凭证工具拿着它才能向抖音接口要数据。复制一份配置模板再跑项目自带的取 Cookie 脚本它会弹出浏览器让你扫码cp config.example.yml config.yml python -m tools.cookie_fetcher --config config.ymlWindows PowerShell 用Copy-Item config.example.yml config.yml复制文件。在弹出的 Chromium 窗口里完成抖音登录回终端按 Enter。跑通后的信号终端打出Updated config file且config.yml的cookies段里不再是YOUR_XXX占位值。登录成功后正式下载跑起来就会自动初始化dy_downloader.db数据库终端出现Database initialized之后重跑同一份配置时它会带着这张历史账本做去重。 核心任务从验证环境到整页归档用 -u 跑一条视频验证环境通了不想动配置文件时链接直接用-u传给命令行它只进内存、不会写回配置跑完不留痕python run.py -u https://v.douyin.com/换成你的短链/ -c config.yml跑完看终端汇总里成功是否大于 0./Downloaded/里是否出现新的 mp4 文件。两个都满足环境就通了。终端提示登录态失效需要重新登录的话回 Cookie 脚本重新扫一次码再来。受前面说的风控影响单条路径可能被拦真遇到就跳过主页整页路径是主力。主页整页批量下载一位博主的全部作品打开config.yml只动三个字段link换成博主主页地址mode保持postnumber.post改成0模板里默认是 1不改只会下 1 条0表示不限数量link: - https://www.douyin.com/user/换成某博主主页地址 mode: - post number: post: 0跑python run.py -c config.yml -t 2-t 2把并发从默认的 5 压到 2请求越慢越不容易触发风控。主页作品可能上百条跑完看终端汇总成功大于 0且./Downloaded/博主昵称/post/下出现按日期标题命名的文件夹、每条作品有非空 mp4这一页就算归档完成。增量追更只补博主新发的作品模板里database: true和increase.post: true默认就是开的不用改任何字段。定期把同一份配置重跑一次同一位博主即可。工具先查dy_downloader.db里的记录再核对磁盘上主媒体文件是否非空两者都成立就跳过只补新作品。跑完看汇总里的跳过数——它明显大于 0就是增量在工作而不是把整页重新拉一遍。想强制重下某个范围内的作品把increase.post改成false会重下并覆盖不用手动清数据库。⚙️ 进阶开关按需改的几个配置video_quality默认highest——决定多档码率里选哪一档。要存上传原片就改original工具会为每条作品多一次探测请求找不到自动退回最高档省流量就写720p、540p匹配不到会降级到最接近的可用档start_time/end_time默认空——格式YYYY-MM-DD只归档某个时间段时才有用包含结束日期当天thread默认 5/retry_times默认 3——前者控制并发下载数可用命令行-t临时覆盖后者是单条失败的重试次数网络不稳时中断的条目按它自动补browser_fallbackenabled默认trueheadless默认false——翻页被风控拦截时自动拉起真实浏览器让你手动过验证。headless必须保持false否则你看不到也点不了那个验证窗口music/cover/json默认全false——原声、封面、作品数据这类附带产物一开文件数和请求量翻几倍确认要某类产物再打开对应开关重跑该博主❓ 下载卡住了怎么办出现登录态失效需要重新登录通常是 Cookie 过期有效期往往只有几天。处理重跑python -m tools.cookie_fetcher --config config.yml重新扫码。出现主页只抓到少量作品就停下通常是接口风控拦了翻页。处理确认browser_fallback.enabled: true且headless: false在弹出的浏览器窗口里手动完成验证再等它继续仍被拦说明风控没解官方 README 明确不保证成功。出现下载中断或速度骤降通常是网络波动或并发偏高。处理中断后重跑未完成文件会按retry_times自动重试批量跑时加-t 2或-t 3压并发。出现重跑时旧文件没被跳过、反复覆盖通常是increase.post被改成了false。处理改回true让增量逻辑生效只有想强制重下某个范围时才临时关掉它。找不到 mp3 原声或封面通常是music、cover开关默认关着。处理配置里改成true后重跑该博主只对重新下载的作品生效。看不到具体哪一步卡住默认控制台只输出错误级日志。处理加-v参数重跑完整流程日志就出来了。 收尾凭证、合规与最小可行路径Cookie 是你的登录凭证只留在本地config.yml里别把带 Cookie 的配置文件发到聊天群或公开仓库。下载内容建议仅用于个人存档和研究别做二次商用搬运。最小可行路径先用-u跑一条视频确认./Downloaded/里出现无水印 mp4再改配置上主页整页批量最后把number.post保持0定期重跑做增量追更。想深挖默认开关看 config/default_config.py完整配置示例在 config.example.yml下载主逻辑在 core/。【免费下载链接】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），仅供参考