企业官网建设流程全解析

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 记录下载历史。它提供 Douzy 桌面版和 Python 命令行版两种形态，下面带你从安装到跑通第一次下载，控制在 10 分钟内。

能力速览：抖音批量下载能做什么

去水印下载：视频、图文、音乐都直接保存为无水印文件，默认选取可用码率中的最高档。

主页批量抓取：填入博主主页链接，可按模式抓取发布作品（post）、喜欢（like）、合集（mix）、音乐（music）、收藏（collect）。

并发与重试：thread 参数控制并发数（默认 5），失败默认自动重试 3 次，并有限速保护。

增量去重：重跑同一任务时，会检查磁盘上的主文件，已下载的作品直接跳过，不必清空记录。

浏览器兜底：接口翻页受限时，可尝试用 Playwright 浏览器自动化补全作品列表。

限制说明：抖音接口风控目前已阻止 CLI 下载单个作品、合集、音乐、喜欢与收藏；主页作品可尝试浏览器兜底，但不保证成功，日常下载建议用 Douzy 桌面版。

5分钟上手：抖音批量下载从安装到首次运行

1. 获取并安装

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

需要 Python 3.9+，支持 Windows、macOS、Linux。这一步装好项目依赖；如果要用浏览器兜底，再补装一个浏览器内核：

python -m pip install playwright python -m playwright install chromium

2. 配置 Cookie 并登录

复制示例配置，启动浏览器登录抖音：

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

Windows PowerShell 用Copy-Item config.example.yml config.yml代替 cp。登录完成后回到终端按 Enter，Cookie 就保存好了。再把 config.yml 里的 link 换成目标博主主页，关键几行这样写：

link: - https://www.douyin.com/user/YOUR_SEC_UID path: ./Downloaded/ mode: [post] number: post: 10 increase: post: true

number.post: 10表示只抓 10 条作品，填 0 表示不限数量。

3. 首次运行

python run.py -c config.yml

终端会实时显示下载进度，文件按目录规则落到./Downloaded/。常用命令行参数：-u追加链接、-p改下载目录、-t调并发，完整参数看python run.py --help。

核心功能详解：批量去水印下载与关键参数

主页批量下载与模式切换

mode 列表决定抓取主页的哪些内容，最小配置如下：

mode: [post, like, mix] number: post: 0 like: 20 mix: 10

post 是发布作品、like 是喜欢、mix 是合集、music 是使用过的音乐、collect 是收藏。每种模式的数量独立控制，0 表示不限量。效果就是博主对应内容按作者目录一次性落到本地。

去水印画质与智能命名

video_quality 控制码率档：original 会探测上传原片、失败自动回退，默认 highest 更稳定：

video_quality: highest filename_template: "{date}_{title}_{id}" folder_template: "{date}_{title}_{id}"

模板支持{date}、{title}、{author}、{id}等变量，每个作品按"日期_标题_作品ID"归档，同时生成 download_manifest.jsonl 清单，方便日后核对和检索。

Douzy 桌面版：多平台下载

桌面版还支持 TikTok、YouTube、Telegram、X：在对应工作台粘贴链接即可提交任务，左侧有任务中心和本地作品档案，进度一目了然。

实战工作流：两个完整使用案例

案例一：批量保存博主某段时间的作品

目标：把博主 2026-01-01 到 2026-06-30 之间发布的作品全部去水印归档。

关键配置（只改三个字段）：

link: - https://www.douyin.com/user/目标主页地址 start_time: "2026-01-01" end_time: "2026-06-30"

执行：

python run.py -c config.yml

预期结果：作品按日期落入./Downloaded/作者名/post/日期_标题_aweme_id/，同步生成清单文件，下载历史写入dy_downloader.db，下次重跑自动跳过已有作品。

案例二：收集博主使用过的音乐素材

目标：把博主用过的音乐收进个人素材库，并保留元数据。

关键配置：

mode: [music] number: music: 20 music: true json: true

执行：

python run.py -c config.yml -v

预期结果：保存博主使用过的 20 首音乐文件；json: true会额外输出每个作品的作者、发布时间等元数据，-v让日志更详细，出问题好定位。

进阶技巧与参数调优：常见问题 Q&A

Q：下载速度怎么调？A：用-t或配置里 thread 调并发，默认 5，网络稳可提到 8 以上，被限制就调低；配合 retry_times: 3 自动重试失败项。

Q：提示 Cookie 失效怎么办？A：重新运行python -m tools.cookie_fetcher --config config.yml，登录后再按 Enter 保存即可，已下载文件不受影响。

Q：主页只抓到少量作品？A：保持browser_fallback.enabled: true且headless: false，在弹出的浏览器里手动完成验证。注意风控仍可能拦截，重要任务建议改用 Douzy 桌面版。

Q：想让已下载的作品重下怎么办？A：把对应模式的增量开关改为 false，例如increase.post: false，会重下并覆盖当前筛选范围内的文件，无需清空数据库。

Q：想看详细日志或排查失败？A：加-v参数运行：python run.py -c config.yml -v。限速、重试、并发队列都在 control/ 模块里，日志里能看到每次重试的原因。

项目生态与后续

完整配置参考 config.example.yml，每个字段都有中文注释；架构说明见 PROJECT_SUMMARY.md。下载主流程与接口封装在 core/，文件落盘和 SQLite 历史库在 storage/，Cookie 工具在 tools/。项目采用 MIT 许可，配有 QQ 交流群和社区讨论，更新节奏跟随抖音接口变化。日常下载建议先用 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