抖音批量下载：从 1 个 Cookie 到 1 个自动去重素材库

抖音批量下载从 1 个 Cookie 到 1 个自动去重素材库【免费下载链接】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收藏夹清空、主页翻不到底、App 保存的视频全带水印——这批视频正是 douyin-downloader 的批量下载战场。它是一个 Python 命令行工具把博主主页链接丢进配置去水印、自动挑最高码率的源已下载的作品下次自动跳过本地素材库从此增量维护。装好环境先拿到 Cookie依赖与浏览器组件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 chromiumPlaywright 是一套浏览器自动化组件后面扫码登录和「浏览器兜底」都靠它提前装好最省事。扫码登录Cookie 自动写回配置cp config.example.yml config.yml python -m tools.cookie_fetcher --config config.yml浏览器窗口打开后扫码登录回到终端按 EnterCookie 就写进config.yml了。Cookie 是接口认证凭证有效期一过就得重跑这条命令它的读取与刷新逻辑封装在 auth/cookie_manager.pyCookie 生命周期管理。没有有效 Cookie 时作品列表往往翻到 20 条就停这是新手最容易卡住的一步。配置主页下载3 个字段就能跑config.example.yml 是完整配置模板首次使用只需改这几处link: - https://www.douyin.com/user/MS4wLjABxxxx mode: - post number: post: 50 # 0 表示不限量mode: post指定抓主页作品其他取值还有 like喜欢、mix / allmix合集、music原声音频。然后执行python run.py -c config.yml终端会显示 Rich 进度条文件落在Downloaded/。不想改文件命令行临时追加不碰配置文件时参数可以直接挂在命令后面参数作用-u 链接追加下载链接可重复使用-t 5并发下载数-p ./下载目录指定保存位置-v输出详细日志文件怎么落盘默认按「作者名/模式/日期_标题_aweme_id」三层目录归档aweme_id 是作品唯一标识每个作品目录里是 mp4再配上封面、原声和记录点赞数、发布时间的 data.json。增量开关increase.post默认开启已下过的作品直接跳过删掉本地文件后重跑会自动补下配合 SQLite一个免安装的单文件数据库里的dy_downloader.db历史记录做双重去重。并发默认 5 路失败按 1s/2s/5s 退避重试API 层面限到 2 请求/秒并加随机抖动就是为压低风控概率。调参数速度与画质各 1 个旋钮thread控制同时跑几个下载任务家庭宽带 5~8 比较稳再高容易撞限流retry_times管重试次数网络环境复杂就把代理填进proxyAPI 请求和媒体流都会走它。video_quality决定清晰度highest取多路码率里的最高档original会先探测上传原片比最高转码档大才用探测失败退回最高转码档代价是每条作品多一次 10 秒超时的探测请求也能直接指定 1440p、1080p 这类分辨率匹配不到就自动降级到最接近的可用档。翻页被风控截断时的兜底API 翻页被风控掐断时browser_fallback.enabled: true会自动拉起一个 Chromium 窗口你在里面手动过一遍验证码就能继续翻。保持headless: false方便操作翻页深度受限时把max_scrolls默认 240 轮滚动调大。不止主页合集、直播、评论一把梭主页之外的对象都在同一套配置里切换。/collection/合集、/user/self收藏页、/music/原声链接写进link即可产物按作品分目录音乐缺失时回退该音乐下的首条作品。直播间链接live.douyin.com/{room_id}则进入录制live.max_duration_seconds: 0表示录到主播下播或你按 CtrlC已录字节保留为 flv直播流封装格式文件并附房间元数据快照HLS 源只存 playlist需要再用 ffmpeg开源音视频处理工具二次合成。数据向的需求走另外两条路comments.enabled: true给每个作品导出*_comments.json--hot-board 30、--search 关键词 --search-max 100把热搜榜和搜索结果落成 JSONL逐行 JSON 数据文件。想接前端或流水线加--serve --serve-port 8000起 REST 服务POST/api/v1/download提交任务、GET 查询状态入口在 server/app.py。问题 → 解法速查问题解法作品只抓到 20 条就停API 翻页被风控截断开browser_fallback.enabled: true窗口弹出后手动过验证码单个视频/合集/音乐链接 403接口已加风控门禁主页作品改 post 模式加浏览器兜底单条走桌面版 Douzy删了文件仍被跳过SQLite 记录还在双重去重生效sqlite3 dy_downloader.db DELETE FROM aweme WHERE aweme_id id;列表抓空、下载全挂Cookie 过期重跑python -m tools.cookie_fetcher --config config.yml三步收尾跑通 cookie_fetcher 拿 Cookie把主页链接填进config.yml执行python run.py -c config.yml。下一个主页作品开始你的素材库自己长。策略模式入口在 core/user_modes/新增下载类型时在这里加一个策略类并注册即可。【免费下载链接】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），仅供参考