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 是一个跑在你自己电脑上的抖音下载工具。贴链接、改配置,它自动挑无水印高清源并去重,省掉你逐条手动保存、自己翻找重复的麻烦。不收费、无水印、全程本地运行。
谁该用、谁不用
需要批量、免费、无水印地保存抖音作品,你就对得上这个工具。
- 把某个博主发布的全部作品存到本地
- 隔几天追更关注的主页,只搬新作品
- 长系列合集一次整存,不用逐条点
- 只想留原声,把其他附带资源全关掉
如果你想用手机下、或想要免配置的 App,这个工具帮不上忙——它是命令行(CLI,即在终端里敲命令操作)工具,会敲命令就能用。
如何从零跑通第一条
全程只有三条命令,跑完第一条无水印视频就落在本地磁盘。
第一步:装好运行依赖
git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt # 安装 Python 依赖成功标志:✅ pip 进度条走完,终端没有红色报错。
第二步:扫码拿到登录 Cookie
Cookie(登录凭证)靠扫码登录写入一次。程序会弹出浏览器,扫一次抖音登录,回终端按回车。
cp config.example.yml config.yml python -m tools.cookie_fetcher --config config.yml成功标志:✅ 终端提示登录成功,Cookie 已写入 config.yml。
第三步:跑第一个下载任务
把想存的作品短链填进 config.yml 的link字段,然后执行:
python run.py -c config.yml成功标志:✅ 进度条走完,Downloaded/目录出现视频文件,按"作者 → 类型 → 日期"分好文件夹。
常见需求速查
所有开关都在 config.example.yml 这份样例里,对号入座改字段:
| 你想做的事 | 改哪个字段 + 怎么填 |
|---|---|
| 批量下载某个主页 | 主页链接填进link,mode加post,number.post写条数上限,0表示全收 |
| 追更博主不重复下载 | increase.post: true且database: true,再跑时自动跳过已下载的 |
| 合集一次整存 | 合集页链接直接填进link,number.mix: 0,合集下作品全收 |
| 只留原声省空间 | video: false、music: true、cover: false,只保存原声文件 |
| 只要某段时间的作品 | 设start_time和end_time,格式YYYY-MM-DD |
| 控制速度与稳定性 | thread: 5控并发,retry_times: 3自动重试,限流时填proxy |
关键旋钮怎么拧
默认值跑不动你的网络时,改这几个字段就够。
并发thread:默认 5。被限流、下载开始频繁失败时,降到 2~3。速度变慢,成功率明显回升。
重试retry_times:默认 3。单条作品失败时按间隔自动重试,不用你盯着重跑。
浏览器兜底browser_fallback:默认开启。翻页被风控卡住时弹出浏览器让你手动过验证;弹窗没出现就检查enabled和headless两个开关。
thread: 5 # 并发下载数,被限流就降到 2~3 retry_times: 3 # 单条失败后的自动重试次数 proxy: "" # 下载变慢或被限流时填代理地址 database: true # 增量与去重都依赖这份数据库 increase: post: true # 增量模式,只下载新作品卡住了先看这里
卡住大多是下面四种,对号入座。
- 主页只抓到二十条就停→ 翻页触发风控 →
browser_fallback.enabled: true、headless: false,弹窗里手动过验证,别急着关窗口。 - 终端提示登录态失效→ 抖音登录有时效,属常态 → 重跑第二步的 Cookie 命令刷新一次。
- 个别作品反复失败→ 作品被删或设了私密 → 正常现象;若只是限流,
retry_times: 3会按间隔自动重试。 - 整体变慢或超时→ 网络波动或被限流 → 给
proxy填代理地址,或临时把thread调小,隔一会儿再跑。
写在最后
本工具仅限个人学习与备份,请尊重创作者版权,不商用、不二次传播。
完整参数说明见 README.zh-CN.md,配置样例见 config.example.yml,下载核心逻辑在 core/ 目录。
👉 现在打开 config.yml,把link换成你真正想存的那条抖音链接,跑一次——结束那一刻,干净的文件就在你的Downloaded/目录里。
【免费下载链接】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
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考