企业官网建设流程全解析

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 是一款命令行抖音下载工具，支持单条视频、图集、音乐、合集的无水印下载，也能批量下载用户主页的全部作品，内置进度显示、自动重试、SQLite 历史记录和对已下载内容的增量跳过。下面按"安装 → 单条下载 → 批量 → 排错"的顺序，把从零跑通一个批量任务的路径完整走一遍。

安装依赖并准备配置文件

环境要求 Python 3.8+，Windows、macOS、Linux 均可运行。

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：把要下载的抖音链接写进link，path指向保存目录。若打算启用浏览器兜底或自动获取 Cookie，需额外安装：

pip install playwright python -m playwright install chromium

自动获取Cookie：扫码一次即可

Cookie 是浏览器里证明你已登录抖音账号的凭证，工具靠它调用 API，过期后请求就会被拒绝。手工复制容易漏字段，推荐用内置脚本：它会打开浏览器，你扫码登录后回到终端按回车，Cookie 即写入config.yml，详见 Cookie 管理模块。

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

跑通第一条抖音无水印下载 📦

Cookie 就绪后，链接填进link并运行：

python run.py -c config.yml

分享短链（https://v.douyin.com/xxx/）、视频、图集、合集、音乐链接都能被自动识别（由 URL 解析器 判断类型）。也可以直接在命令行传入链接，优先于配置文件生效：

python run.py -u "https://www.douyin.com/video/1234567890"

文件按作者昵称自动分文件夹存放；开启元数据选项后，标题、作者、发布时间等会一并保存为 JSON，方便后续做内容分析。

批量下载用户主页作品怎么操作

传入用户主页链接（https://www.douyin.com/user/…）时，mode决定抓取范围：

• post该用户发布的作品；like其点赞的作品；mix其创建的合集；music音乐相关内容
• number限定各模式条数，写0表示不限量
• link可一次放多条链接，或重复传-u，多个作者可一起跑
• 多种模式可组合，同一作品跨模式会去重，不会下载两遍

link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx mode: - post - like number: post: 50 like: 0 thread: 5

收藏夹模式（collect/collectmix）只针对"你自己"登录后 Cookie 对应的账号，且不能与上述模式混用。

开启增量下载，只抓新增内容

把increase中对应模式设为true后，工具会先检查磁盘：对应视频文件已存在且非空就直接跳过，只下载新增作品。这个判断只依据本地文件、与 SQLite 历史无关——删掉某文件，下次就会重新下载。它是定期跟踪某作者更新的必要配置。

下载失败常见原因排查 🔍

• Cookie 过期被拒：最常见原因，重跑一次cookie_fetcher命令重新获取即可。
• 单条作品下载失败：旧版 V1.0 代码库的流程是改配置后运行DouYinCommand.py，单视频是它的主要场景；现行 V2.0 代码库统一走run.py，重心在主页批量与自动 Cookie，单视频场景偶有 API 兼容问题。某条作品反复失败时，先单独下载它，排除内容权限问题（付费、地区限制）。
• 翻页被风控拦截：启用browser_fallback，工具会自动打开浏览器让你手动处理滑块验证；该方式在post模式验证最完整，like/mix/music仍以 API 翻页为主。
• 速度慢：thread控制并发（默认 5，可在 1–20 间调），工具默认限速 2 请求/秒，不建议把并发拉太高；失败会按 1s、2s、5s 退避自动重试 3 次。
• 长任务可改用桌面客户端 Douzy（同一后端）查看任务中心，每位作者的成功/失败数量一目了然：

使用须知

• 仅供学习和研究使用，请遵守抖音平台服务条款
• 尊重原创内容版权，下载内容不用于商业盈利
• 抓取量越大接口压力越大，控制频率、按需下载

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