简单免费的抖音批量下载工具：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 历史记录和浏览器兜底。对个人用户备份自己的作品、对内容创作者收集同领域参考素材都比较合适：命令行方式轻量直接，另外还有一套基于同一后端的桌面版 Douzy 可选。

从"想存几个别人的作品"说起

想参考某位创作者的剪辑思路时，第一步往往是把对方的作品存到本地反复分析。但从 App 里保存的视频带角标水印，画质也不稳定；创作者如果有几百条作品，手动逐条保存和整理几乎不现实。存下来之后文件混在一起没有分类，再想找某一条还得翻很久。douyin-downloader 针对的就是这条链路：无水印源文件、批量抓取、按结构自动归档，工具完成这些动作，使用者只需要提供链接。

项目概览：一次看清它能做什么

清单看着长，但主路径很单纯：一个视频链接对应单条下载，一个主页链接对应批量任务，工具按 URL 类型自动分发给对应下载器，入口逻辑在 core/downloader_factory.py。项目还配套了一份桌面端截图，可以感受一下"粘贴链接即开始"的形态：

桌面版 Douzy 目前处于封闭测试，本文主线介绍的是命令行版本。

快速上手：三条命令装好并启动

环境前提只有一条：Python 3.8 以上，macOS、Linux、Windows 均可。

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

接着把示例配置复制为cp config.example.yml config.yml，在link里填入要下载的链接，运行python run.py -c config.yml即可。首次运行建议先获取一次 Cookie：执行python -m tools.cookie_fetcher --config config.yml会打开浏览器，登录抖音后回到终端按回车，Cookie 自动写入配置 ✅。若要使用浏览器兜底，还需额外安装 playwright。

核心功能走读

批量下载一个创作者的主页

特性：主页链接配合mode与number就能启动批量任务。价值：整个主页按"作者/模式/日期_标题_aweme_id"的结构自动建目录，封面、原声、元数据 JSON 均可按需附带保存，不需要事后整理。用法：修改 config.yml 中这几处：

link: - https://www.douyin.com/user/xxx mode: [post] number: post: 50

number配0表示不限量；配合start_time/end_time还能只取某个时间段内的作品。

增量下载与历史去重

特性：磁盘上已存在主媒体文件时跳过该作品，同时把每次任务写入 SQLite（storage/database.py）。价值：同一份配置每周重跑一次，只会补上新发布的作品，不用人工核对哪些存过。用法：

increase: post: true

要注意重下机制是"数据库记录 + 本地文件"双重判断：删掉数据库但保留文件不会触发重下，删掉文件保留数据库则会重新下载。

浏览器兜底：只翻到 20 条时怎么办

特性：API 翻页被风控限制时，工具自动打开浏览器，由人工完成验证码后继续采集。价值：避免"批量下载只拿到前 20 条"的常见断点。用法：保持browser_fallback.enabled: true、headless: false，在弹出的窗口里完成验证，别过早关闭窗口。

直播录制（实验性功能）

特性：live.douyin.com直播链接会走 FLV/HLS 录制，播主下播、网络空闲或按 Ctrl+C 时，已录到的数据都会保留。用法：填入直播链接，用live.max_duration_seconds控制最长时长，文件落在该作者的live/目录并附一份房间元数据。

实用技巧与常见问题

批量下载只拿到约 20 条作品？大概率是翻页风控，确认browser_fallback已启用且非无头模式，并在弹出的浏览器里人工完成验证。

提示需要登录或 Cookie 失效？重新执行python -m tools.cookie_fetcher --config config.yml；非交互环境下可以手动更新config/cookies.json，获取脚本源码见 tools/cookie_fetcher.py。

下载速度慢或中途中断？用-t调整并发、用proxy配置代理；重试与限速策略默认已开启（control/retry_handler.py），重新运行同一条命令即可从中断处继续。

结语

douyin-downloader 的定位是一个务实的命令行下载器：单条视频是一条链接的事，主页批量是一份配置文件的事，去重、重试、限速这些工程细节都预先配好了，也提供了 Docker 部署选项。想把它用起来，最直接的方式就是按"快速上手"一节跑通第一个视频，再从单条扩展到整页批量。

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