抖音无水印批量下载完整教程：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 能做什么

• 无水印下载：视频/图集本体，可选附带原声音乐、封面、头像和作品 JSON
• 批量模式：博主主页作品（post）、喜欢（like）、合集（mix）、音乐（music）四种入口
• 进度与重试：终端实时显示每个作品的下载进度，失败自动重试（默认 3 次）
• 去重与增量：SQLite 记录下载历史，重复运行自动跳过已下内容，支持按日期筛选
• 浏览器兜底：接口受阻时自动切换 Playwright 模拟浏览器抓取，提升成功率

安装与首次运行：douyin-downloader 从零跑通

整个流程只有三步：装依赖、登录存 Cookie、跑命令。

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

前三行拉取代码并安装 aiohttp、rich 等依赖；第四行装 Playwright 和 Chromium 浏览器内核，供兜底抓取使用。

接下来登录并把 Cookie 存进配置文件：

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

终端会弹出一个浏览器窗口，登录抖音后回到终端按 Enter，Cookie 就保存好了——这是全程唯一需要手动操作的环节。

最后运行：

python run.py -c config.yml

深入一个场景：批量下载博主主页的全部作品

最典型的用法是"把某个博主的主页作品整建制保存下来"。官方示例 config.example.yml 里每个字段都有中文注释，只需关注这几行：

link: - https://www.douyin.com/user/xxxx # 换成目标博主的主页链接 path: ./Downloaded/ mode: - post # 已发布作品；可再加 like / mix / music number: post: 0 # 0 表示不限量 increase: post: true # 跳过已下载的作品

执行python run.py -c config.yml后：

• 终端按作品逐个显示实时进度，失败的作品自动重试
• 文件按"作者 / 作品"两级文件夹落到Downloaded/，命名遵循{date}_{title}_{id}
• 下载历史写入本地 SQLite（dy_downloader.db），再次运行同一命令时数据库里已有的作品会被自动跳过，不重复下载
• 只想要某个时间段的作品，填start_time/end_time（格式YYYY-MM-DD）即可

💡 如果不习惯命令行，同一项目还提供 Douzy 桌面版，抖音页面里"作品 / 喜欢 / 合集 / 音乐"四个选项和 CLI 的mode一一对应：

实用小贴士：参数调优与常见坑

• Cookie 失效是第一变量：失效后重新跑python -m tools.cookie_fetcher --config config.yml即可；如果主页只抓到少量作品，保持browser_fallback.enabled: true并在浏览器里手动完成验证。
• 对风控保持清醒：抖音接口目前对 CLI 直接下载单个视频、合集、音乐有风控限制，刷新 Cookie 或反复重试都解决不了这类拦截，官方建议日常下载改用 Douzy 桌面版。
• 重下不必清数据库：把对应模式的increase改为false，即可在筛选范围内覆盖重下；自定义命名模板时务必保留{id}变量，避免重名文件互相覆盖。
• 并发与频率用默认值最稳：thread: 5、rate_limit: 2（每秒请求数）是保守配置，配 cron 或任务计划做定时归档时不建议调太高；想看详细日志加-v，想临时改并发用-t。

这套工具的价值，在于把"逐条打开逐个保存"变成"写好配置、跑一条命令"——批量、去重、重试交给 SQLite 和进度系统自动完成。完整配置项见 config.example.yml，最新版的使用说明与限制说明见 README.zh-CN.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