企业官网建设流程全解析

3分钟上手：用 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-downloader

做混剪和合集时，你常需要把一批抖音视频的封面存下来当素材，但逐条截图既慢又难保画质。douyin-downloader 的思路很直接：把链接写进配置文件，打开cover开关，跑一条命令，目录里就会批量生成对应的_cover.jpg文件。下面带你从零走到能批量取封面，全程 3 分钟。

快速上手：装好依赖，下载第一张封面

这一节帮你把环境装好并看到第一张封面文件。

项目要求 Python 3.9 以上。克隆仓库并安装依赖，再把示例配置复制成正式配置：

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里填一个视频链接，并打开封面开关（video: false表示只存封面，不拉视频文件，省带宽）：

link: - https://www.douyin.com/video/7604129988555574538 path: ./Downloaded/ video: false cover: true

主页批量下载依赖登录态，所以先取一次 Cookie（会弹浏览器让你登录，登录后回终端按回车，它自动写回配置）：

python -m tools.cookie_fetcher --config config.yml

最后运行并验证：

python run.py -c config.yml

跑完后打开Downloaded/目录，能找到*_cover.jpg文件就说明成功了。

从单条到批量：三种取封面的方式

这一节帮你把"取一条"扩展成"取一主页"。

单条取封面：就是上一节的用法，link里放视频、图文或合集链接，cover: true。

配置文件列清单：link本身是个列表，塞进任意多条链接，一次运行全部处理：

link: - https://www.douyin.com/video/7604129988555574538 - https://www.douyin.com/note/7341234567890123456 - https://v.douyin.com/xxxx/

主页整批取封面：把link换成作者主页地址，加mode和数量限制，跑完后该作者的作品封面会按作者名/post/日期_标题_id/的层级各存一份：

link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx mode: - post number: post: 50

不想每次都改文件，也可以在命令行临时追加链接和并发数：

python run.py -c config.yml -u "https://www.douyin.com/video/7604129988555574538" -t 8

常用参数速查：改哪几项最有用

这一节帮你省得翻整份配置模板，最常动的 6 项在这里。

完整模板（含proxy、start_time/end_time时间过滤、increase增量开关等）见 config.example.yml。

背后是怎么做的

封面不是截图，而是从作品详情接口里直接读字段。core/metadata.py 按origin_cover→cover_original_scale→cover的顺序找静态封面字段，取到镜像地址列表后挑一张下载；图文作品没有视频封面，就用第一张图兜底。只要cover打开，每个作品都会在同目录生成*_cover.jpg。

高频问题与解决

这一节帮你处理跑批时最容易卡住的 4 个情况。

• 只能抓到 20 条左右就停：翻页触发了风控。确认browser_fallback.enabled: true且headless: false，浏览器弹窗后手动完成验证再关窗。
• Cookie 失效、接口报错：重新跑python -m tools.cookie_fetcher --config config.yml刷新即可。
• 没有生成_cover.jpg：先查cover是否仍是默认false；图文作品生成的是第一张图，属正常。
• 想重下已下载的作品：程序用"数据库记录 + 本地文件"双重去重，两边记录都要清掉才会重新下载，方法见 README.zh-CN.md 的"重新下载"一节。

收尾

douyin-downloader 把封面下载做成一个配置开关，配合主页批量和增量模式，可以沉淀一个长期维护的封面素材库。

核心文件：config.example.yml（配置模板）、core/metadata.py（封面地址解析）、run.py（入口）。

现在就可以打开config.yml，把cover改成true，先拿一条链接跑通。

【免费下载链接】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