3 步命令搞定抖音封面下载：从单条到批量的本地原图

3 步命令搞定抖音封面下载从单条到批量的本地原图【免费下载链接】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 三行命令就能完成抖音封面下载到本地克隆仓库、配置里打开cover、跑python run.py。作为抖音封面提取工具它同时支持视频、图文、音乐等内容的批量获取。下面是我实际走通的完整流程加上三种批量用法和几个容易卡住的地方。先说清楚它能干什么只要封面也行video、music、cover、avatar、JSON 元数据是五个独立开关各存各的封面归档不依赖视频下载成功三种输入形态单条作品链接、创作者主页、配置文件里的链接列表走同一套入口不重复劳动已下载作品记入 SQLite 历史第二次跑自动跳过磁盘上的文件缺失可以补风控兜底接口遇到验证时可切真实浏览器Playwright抓取主页作品克隆、登录、跑起来五步完成初始化 需要 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复制 config.example.yml 模板然后完成一次抖音登录会弹出浏览器窗口登录回终端按 Enter 保存 Cookiecp config.example.yml config.yml python -m tools.cookie_fetcher --config config.ymlWindows PowerShell 里复制文件那步换成Copy-Item config.example.yml config.yml。接着在config.yml里打开封面开关、填上目标link: - https://www.douyin.com/user/YOUR_SEC_UID # 换成目标主页或作品链接 path: ./Downloaded/ video: false # 只要封面就关掉视频本体 cover: true # 默认是 false必须显式打开 mode: [post] number: post: 0 # 0 表示不限数量跑第一个任务python run.py -c config.yml./Downloaded/里出现_cover.jpg文件说明链路通了。按场景选输入形态丢一条作品链接命令行直接给v.douyin.com短链会自动解析python run.py -u https://v.douyin.com/xxxx/注意-u是追加不会替换配置里的link首次运行前先把config.yml里的示例链接换成自己的目标或清空免得把示例主页也跑一遍。封面和视频同目录保存文件名为{作品名}_cover.jpg命名由filename_template模板控制默认{date}_{title}_{id}。丢一个整个主页批量保存视频封面link:填主页地址mode选内容类型post作品、like、mix合集、music等number.post限数量、0就是全量。抖音弹出验证时保持browser_fallback.enabled: true和headless: false在弹出的浏览器里手动过验证即可。仓库里还有配套的 Douzy 桌面版下图是它的抖音任务配置页选项与配置文件字段一一对应丢一个列表文件config.yml的link:列表里堆多条链接作品、主页、合集都行一次python run.py -c config.yml全部处理完。命令行侧-u可重复传临时追加-p临时改保存目录-t临时调并发数。抖音封面下载的内部逻辑速览 拉取到每个作品的 JSON 后下载器从video字段取封面 CDN 地址列表顺带下载逻辑集中在 core/metadata.py。三个要点取址顺序origin_cover原图→cover_original_scale→cover预览图命中即止优先拿原图多镜像兜底一张封面常带多个镜像p3-*这类 403 概率高的域名被排到最后按序下载、首个成功即停存放规则统一{作品名}_cover.jpg与作品同目录天然按时间戳排序抖音封面下载卡住了先看这三处Cookie 失效先刷新登录别硬重试典型症状是链接解析失败、主页返回空列表。重跑一遍登录命令python -m tools.cookie_fetcher --config config.yml即可。反复重试旧任务解决不了问题刷新 Cookie 才是正解。配置不生效cover 默认是 false最常见原因——cover默认关闭只改了path却忘了打开cover: true结果只存了视频本体。video、music、avatar、json 同样默认全关按需逐个检查。加-v看详细日志定位问题python run.py -c config.yml -v风控与并发先降线程数当前抖音接口风控会拦截 CLI 对单个作品、合集、音乐等类型的下载主页作品可走浏览器兜底但不保证成功。批量任务超时时先降并发-t 3配置里thread默认 5单条失败会按retry_times默认 3自动重试不用手动补。要长期收集抖音封面截图不是办法配置里打开cover把链接丢进去剩下交给批量任务。先把仓库克隆下来跑通一条作品链接再回头批量跑主页。【免费下载链接】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），仅供参考