抖音无水印视频批量下载：douyin-downloader快速上手完整指南

抖音无水印视频批量下载：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 去重和增量下载。一个配置文件就能定义下载范围、并发数与文件命名规则。

一张表看懂 douyin-downloader 的能力

先确认场景和环境是否匹配，再决定怎么用：

快速上手：安装、Cookie 配置、跑通首个任务

第一步：安装工具

需要 Python 3.9+，克隆仓库后安装依赖即可开始：

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

第二步：获取 Cookie

抖音需要登录态才能取到内容，下面的命令会自动弹出浏览器，扫码登录后回终端按回车，Cookie 就写进配置了：

pip install playwright python -m playwright install chromium cp config.example.yml config.yml python -m tools.cookie_fetcher --config config.yml

第三步：跑通第一个任务

把 config.yml 里的 link 换成要下载的用户主页链接，mode 保持 post，然后运行：

python run.py -c config.yml

文件会按"作者名/作品类型/日期_标题_aweme ID"存入 Downloaded/ 目录，终端进度条实时显示每个文件的下载状态。

配置 douyin-downloader 的批量下载与文件组织

批量下载用户主页作品

一条配置就能拿到某创作者的全部作品，无需逐个访问。在 config.yml 中这样写：

link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx mode: - post number: post: 0 # 0 表示全部；填数字则只取前 N 条

运行后每条作品一个独立子文件夹，视频本体之外，打开 music、cover、json 开关还会附带背景音乐、封面和元数据；同时勾选多个 mode 时，相同作品跨模式去重，不会重复落盘。

调整下载范围与文件命名

常用开关都在 config.yml 中，按需开关即可：

• video/music/cover/json：视频本体、背景音乐、封面、元数据的独立开关
• start_time/end_time：按发布时间过滤，格式 YYYY-MM-DD
• increase：设为 true 时跳过本地已有的作品，只拉新内容
• folderstyle/filename_template：控制目录层级与命名，模板里必须包含{id}防重名

用桌面版一键下载

Douzy 桌面版（Beta，在项目的 Releases 页面获取）把同一套后端做成了图形界面，粘贴链接点"下载"就能开始，不用碰命令行：

任务中心集中展示每条批量下载任务的状态与成功/失败数量，失败项可单独重试：

真实场景：每日跟进关注的创作者并沉淀新作品

需求：关注了 10 个舞蹈类创作者，希望每天归档他们的新作品，且隔天运行不重复下载。

做法：桌面版登录账号后同步关注列表，用"新作品 > 0"筛出有更新的作者，从列表直接加入下载队列；用 CLI 则保持increase: true每天跑一次增量。

效果：任务中心逐条记录成功/失败数，第二天运行只下载新作品，已归档文件保持原样，无需手动对比。

命令速查与常见问题

排错三条：

1. 只抓到约 20 条作品：触发了平台翻页风控。把browser_fallback.enabled设为 true、headless设为 false，在弹出浏览器里手动完成验证。
2. CLI 下载不了单条视频、点赞、收藏：2026-08 起平台安全策略对非浏览器请求返回 403。用户主页作品可走浏览器兜底，其余内容建议改用 Douzy 桌面版。
3. Cookie 过期、取不到内容：重新执行python -m tools.cookie_fetcher --config config.yml扫码更新。
4. 想重下已下载过的内容：把对应 mode 的increase设为 false 会重下并覆盖；或删除本地文件和数据库记录（只删数据库不生效）。

调优建议：并发默认 5，弱网环境可用-t降到 2~3；需要走代理时在配置里填proxy字段；平台侧默认限速 2 req/s，不必盲目调高并发。

到这里，单条下载、批量下载、增量归档三条核心流程都已跑通。完整功能清单见 README，各配置项的注释说明可直接参考 config.example.yml；使用中遇到 Bug 或功能建议，到项目 Issue 页面反馈即可。

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