douyin-downloader 从零跑通：3 步完成抖音批量下载与无水印备份

douyin-downloader 从零跑通：3 步完成抖音批量下载与无水印备份

【免费下载链接】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 这类能批量下载抖音内容的开源工具——平台不给下载按钮，网页工具又怕不安全。翻到它的仓库后，我花了不到十分钟，就把整页作品备份成了无水印原画质文件。这篇就把这条完整路线原样讲给你听，保证每一步都能照着走。

三十秒，先认识它

一句话总结：这是一个用 Python 写的命令行下载工具，开源、免费、跨平台，专治"抖音没有下载按钮"这个老大难。

第一次就成功：三小步拿到无水印视频

不要一上来就研究高级配置，先跑通一单，成就感才是最好的老师。

第一步：把代码请进电脑

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

第二步：让工具认领你的抖音账号

抖音接口需要 Cookie 当凭证，好在项目自带自动获取脚本，全程不用手抄：

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

运行后浏览器会自动打开，你登录一次抖音，回到终端按一下回车，Cookie 就写进配置里了。

第三步：跑通第一单

python run.py -c config.yml -u "https://www.douyin.com/video/视频ID"

看着进度条走到 100%，打开Downloaded/目录：无水印 mp4、封面图、原声音乐、一份完整的 JSON 元数据，全都在。

第一次下载就能看到批量进度统计，下过的文件会被自动标记为"跳过已存在"。

进阶技巧：把工具用出花来

跑通第一单之后，下面这几个技巧能让它的价值翻几倍。

技巧一：整页备份一个作者

把链接换成作者主页，再在配置里声明要下哪些内容：

link: - https://www.douyin.com/user/作者的sec_uid mode: - post # 作品 - like # 点赞过的 - mix # 合集 - music # 用过的原声 number: post: 0 # 0 表示不限制数量

一次任务，作品、点赞、合集、原声全都能带回家，文件还会按作者和日期自动归类。

下载完成后目录自动按日期和标题整理，视频、封面、音乐各归其位。

技巧二：让程序只下"新东西"

打开增量开关并启用内置数据库，下次运行只会下载没下载过的作品，同一任务跑十遍也不会产生重复文件：

increase: post: true database: true

技巧三：直播也能录下来

把链接换成live.douyin.com/{房间号}，工具会按清晰度录制 FLV，主播下播时已录好的内容会自动保留：

live: max_duration_seconds: 0 # 0 表示录到主播下播

解析直播链接后可以挑选清晰度，录制文件会放进作者目录下的 live 文件夹。

技巧四：顺手把评论也带走

配置里打开comments.enabled，每个作品旁会多出一份*_comments.json，做内容研究时省事不少。

我踩过的坑，你绕开走

用了一段时间，我把最常见的几个问题按排查思路整理给你。

坑一：Cookie 过期，突然全部失败。登录态失效后接口会拒绝请求，解决办法就一条——重新执行python -m tools.cookie_fetcher --config config.yml，一分钟满血复活。

坑二：一个作者只抓到 20 条。多半是翻页被风控了。打开browser_fallback并保持headless: false，弹窗出现时手动完成一次验证码，后续就能正常翻到底。

坑三：重复文件越堆越多。去重是"数据库记录 + 本地文件名"双重检查，想重下某个作品，删掉对应文件夹和数据库里的记录即可，不用清空一切。

坑四：下到一半网络断了。工具内置指数退避重试，还会比对文件大小做完整性校验，下载不完整的文件会自动清理重来。

每个文件单独记录大小和耗时，哪个环节出问题一眼就能看出来。

嫌命令行麻烦？还有桌面版和文档

不习惯敲命令也没关系，项目还提供了基于同一套后端的桌面客户端（目前内测中）：粘贴链接就能开始下载，能同步关注列表、逐任务看状态，还能用历史记录做筛选。

桌面版和命令行共用一套后端，会命令行就懂桌面版。

任务中心里可以实时看到每个任务的排队、解析、下载状态。

想深入研究的，可以读仓库里的README.zh-CN.md（功能与配置全表）、config.example.yml（注释版配置模板）和USAGE.md（新旧版本差异说明），细节基本都覆盖到了。

结尾就一句话

抖音不给你下载按钮，但 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