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-downloaderdouyin-downloader 是一款偏实用取向的抖音批量下载工具支持视频、图文、合集、音乐原声的去水印保存自带进度展示、指数退避重试、SQLite 去重和浏览器兜底能力。这篇文章从安装讲起演示单个作品、作者主页、收藏夹三个真实使用场景最后梳理关键配置项和最容易碰到的几个问题。下载成果长什么样文件按作者和模式自动归档先说运行结束后的样子所有文件会落在path指定的目录默认./Downloaded/层级是「作者名 → 下载模式 → 作品」。比如post目录下会生成2024-02-07_作品标题_aweme_id这样的子目录里面有视频本体.mp4以及可选的_cover.jpg、_music.mp3、_data.json元数据、_avatar.jpg。跨模式自动去重后同一个作品只会出现一次。 文件层面的几个工程细节值得说明下载时优先选择无水印视频源并基于video.bit_rate数组自动挑最高码率版本下载不完整会按 Content-Length 比对、自动清理并重试下载历史写入本地 SQLite 数据库再叠加本地文件名扫描做双重去重所以同一份配置重跑时已下载的作品会被直接跳过不会重复占空间。5 分钟完成环境准备与首次配置它只要求 Python 3.8macOS / Linux / Windows 均可。先拿到代码并安装依赖git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt接着把示例配置复制成工作配置并用自带的浏览器工具获取 Cookiecp config.example.yml config.yml python -m tools.cookie_fetcher --config config.ymlcookie_fetcher 会打开浏览器登录抖音后回到终端按 EntermsToken、ttwid 等字段会自动写进配置文件。浏览器组件Playwright只在需要浏览器兜底时才必须安装用pip install playwright加python -m playwright install chromium即可。✅ 第一次运行前你只需要关心配置里这几行——改好link、path、mode就能跑link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx path: ./Downloaded/ mode: - post number: post: 0 # 0 表示不限量 thread: 5 database: true三种典型用法单作品、主页批量、收藏夹配置就绪后用python run.py -c config.yml执行临时链接也可以直接追加-u 链接覆盖配置里的link。下面是最常用的三种姿势。下载单个视频、图文或合集把作品链接写进link即可。单视频/video/、图文/note/或/gallery/、单合集/collection/、单音乐/music/各有对应链接形式v.douyin.com短链也会被自动解析link: - https://www.douyin.com/video/7604129988555574538不想每次改配置的话可以等桌面版 Douzy内测中与 CLI 共用同一套下载后端粘贴链接即自动识别类型点一下开始下载。批量下载作者主页作品把link换成作者主页链接用mode和number控制范围number是各模式的数量上限0 表示全量多模式可同时开启link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx mode: - post - like - mix number: post: 50 like: 0运行过程中终端有实时进度条桌面版的任务中心则能看到每个任务的成功、失败明细失败的项可以单独重试。增量同步与当前账号收藏夹给increase加上post: true就只下载数据库里没有记录的新作品适合定期盯某个作者的更新依赖database: true。收藏夹模式比较特殊链接是/user/self?showTabfavorite_collectionmode用collect或collectmix只能单独使用、不能与post/like/mix/music混用且只能抓取当前 Cookie 所登录账号的收藏。关键配置速查模式、数量、并发与命名配置项默认说明mode[post]可选 post/like/mix/musiccollect/collectmix 仅单独使用number.*0各模式数量上限0 为不限量increase.*true各模式增量开关依赖数据库thread5并发下载数建议 3-8retry_times3失败重试次数1s/2s/5s 指数退避rate_limit2请求限速请求/秒video_qualityhighest可选 original / highest / lowest 或指定分辨率filename_template{date}_{title}_{id}命名模板folder_template同规则databasetrueSQLite 去重与下载历史start_time/end_time空时间过滤格式YYYY-MM-DDcomments.enabledfalse按作品采集评论输出*_comments.jsonnotifications关完成后推送 Bark / Telegram / Webhook命名模板支持一组固定变量id、title、author、date、year/month/day、time、mode、type等。默认{date}_{title}_{id}让文件天然按日期排序想带上作者名就改成{author}_{date}_{title}_{id}变量白名单和渲染逻辑见 utils/naming.py。只能抓到 20 条、Cookie 过期、想重下常见问题排查只能抓到约 20 条作品——这是翻页被风控的典型信号。检查browser_fallback.enabled是否为 true、headless是否为 false浏览器弹窗出现后手动完成验证验证完再关窗口。注意浏览器兜底目前只对post完整验证过like/mix/music 仍依赖 API 正常分页。Cookie 过期——重新执行 Cookie 获取命令即可python -m tools.cookie_fetcher --config config.yml其他配置不用动。想重新下载已下载过的作品——去重是「数据库 本地文件」双机制两边都要清理删掉Downloaded/下对应作品目录目录名含 aweme_id再用 sqlite3 删除aweme表中对应记录。只删数据库不删文件不会触发重下只删文件不删数据库则会重下。日志刷屏——默认progress.quiet_logs: true已在进度阶段静默日志调试时再加--show-warnings或-v查看详细输出。适合谁用以及如何把下载接进自己的工作流个人存档和自媒体素材收集是最对口的场景配合increase增量与数据库去重可以定期同步关注博主的新作品而不用操心重复桌面版的关注管理还能标注新作品、加备注。需要程序化调用时装好 fastapi 和 uvicorn 后加--serve --serve-port 8000启动POST /api/v1/download提交任务、GET /api/v1/jobs/{job_id}查状态接定时任务很方便。另有两条轻量采集入口--hot-board 30导出热搜榜快照、--search 关键词导出作品搜索结果结果都是 JSONL。直播录制、评论采集、视频转写需 OpenAI API Key均为可选扩展。⚠️ 需要留意的限制桌面版 Douzy 处于内测期collect/collectmix 仅支持当前登录账号且必须单独使用直播录制为实验性功能HLS 源需 ffmpeg 后处理。整体来看这是一个把进度、重试、去重、完整性校验都补齐的抖音去水印批量下载工具最新版本与更新记录以仓库为准。【免费下载链接】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），仅供参考