企业官网建设流程全解析

抖音批量下载工具上手指南：主页作品一次存全，无水印、不重复下载

【免费下载链接】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 是一个 Python 写的抖音批量下载工具，把博主主页链接丢给它，无水印视频和图文会成批落盘，第二次运行还会自动跳过已存的内容。

它能做什么：以及做不到什么

• 整站主页作品批量下载：给一个博主主页链接，它自动翻页下载全部（或指定数量）作品，视频和图文都支持
• 自动去重与增量：SQLite 数据库记录下载历史，再次运行跳过已下载作品，只补缺失的文件
• 按日期和数量筛选：用start_time/end_time圈定时间段、number.post限定条数，只取需要的范围
• 并发与容错：多线程并发下载、失败自动重试，还能加开评论采集、视频转写和完成通知

边界先说清楚：受抖音接口风控影响，命令行版目前无法直接下载单个视频、合集、音乐、点赞与收藏；直播录制也是实验功能，HLS 源只保存播放列表、得不到可播放的视频。日常单条下载建议用同项目的 Douzy 桌面版。

同项目的 Douzy 桌面版把这些选项做成了可视化界面，本文带你在命令行版上跑通。

从零跑通：安装、登录、第一次下载

环境需要 Python 3.9+，Windows / macOS / Linux 都支持。先拿代码装依赖，浏览器内核是后面扫码登录用的，一并装好：

git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader python -m pip install -r requirements.txt python -m pip install playwright python -m playwright install chromium

接着拿自己的抖音账号换取登录态：工具会自动打开浏览器，你扫码登录后回到终端按 Enter，Cookie 就存进配置了：

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

最后把博主主页链接填进config.yml的link字段，运行。参数之所以放进配置文件，是因为项多，写一次后面每次批量都能直接复用同一套设置：

python run.py -c config.yml

文件默认落在./Downloaded/，按「作者名 / 日期_作品标题_作品ID」自动分层，还会生成download_manifest.jsonl清单，记录每条作品的日期、标题和文件路径，方便日后检索。

按需进阶

如果还要下别的博主：跑python run.py -c config.yml -u "主页链接"，-u直接追加链接，不用改配置文件。

如果只取某段时间的作品：填start_time和end_time（格式 YYYY-MM-DD），结束当天完整包含；翻到起始日期前它会提前停翻页，不浪费请求。

如果追求最高画质：video_quality默认highest（最高转码档），改成original会尝试探测上传原片、失败自动回退，也可以指定 1080p / 720p 这类分辨率。

如果想重下覆盖：把increase.post改为 false，会在当前筛选范围内重新下载并覆盖文件，无需清空数据库。

如果主页只抓到少量作品：保持browser_fallback.enabled: true且headless: false，翻页受限时它会切换到真实浏览器滚动抓取，遇到验证码在浏览器里手动完成即可。

避坑清单

• 二次运行全部跳过、但文件其实丢了：redownload_missing_files设成 false 且数据库仍有记录时会跳过，保持默认 true 会补下缺失文件。
• 作品突然拉不到、提示「请先登录」：Cookie 失效或被风控，重跑cookie_fetcher命令重新登录；仍受限就改用 Douzy 桌面版。
• 文件名互相覆盖：命名模板filename_template必须包含{id}变量，这是工具的硬性要求，保证每个作品文件唯一。
• 线程开大反而失败：thread默认 5，网络一般时先加-v看详细日志（python run.py -c config.yml -v），按带宽调并发，别盲目拉满。
• 以为直播录制能当存档：录制属实验功能，HLS 源只存播放列表、不能直接播放，重要内容别依赖它。

先用number.post限几条跑通流程，再放开限制批量下。全部配置项见 config.example.yml，模块结构见 PROJECT_SUMMARY.md。

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