douyin-downloader 抖音下载工具教程:免费去水印,从单条视频到主页批量备份
2026/8/27 13:31:40 网站建设 项目流程

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 是一款免费去水印的抖音下载工具,用命令行保存抖音视频、图文笔记、合集、音乐和直播内容,适合想把博主作品备份到本地电脑的新手和普通用户。环境一次装好、Cookie 一次配好,之后复制链接就能下载,全程不花钱。

它是什么,为什么值得装

一句话定位:你给它一个抖音链接,它解析出无水印源文件,按"作者→类型→日期"存好,再顺手附上封面和元数据。

和网页版下载站相比,这款免费去水印的抖音下载工具差异点很实在:

  • 完全免费开源:代码全开放,跑在自己电脑上,没有会员门槛和弹窗,数据都留在本地。
  • 类型覆盖全:视频、图文笔记、合集、音乐原声、作者发布与点赞作品、直播都能收,不同类型的链接可以混在同一个列表里。
  • 批量且自动去重:多线程并发、失败自动重试,并用 SQLite 记录历史,重复运行会自动跳过已下载的作品。
  • 跨平台:Windows、macOS、Linux 都能跑,只需要 Python 3.8 以上。

拿到第一个结果:环境、Cookie、首次运行

第一步:安装依赖

确保已安装 Python 3.8 及以上版本,依次执行下面三条命令拉取项目并装好依赖:

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

看到 pip 进度走完、末尾没有红色报错,环境就算就绪。

第二步:配置 Cookie

工具需要借用你的登录态访问抖音接口。运行下面的脚本,它会一步步教你从浏览器开发者工具里复制 Cookie:

python get_cookies_manual.py

看到"Cookie 包含必要字段"的校验提示、并写入配置文件,就算配好了。不想手动的话,也可以装好 Playwright 后运行python cookie_extractor.py,浏览器扫码登录即可自动提取。

第三步:下载第一条视频

复制任意抖音视频的分享链接,直接传给下载器:

python downloader.py -u "https://v.douyin.com/xxxxxxx"

终端刷完进度后,去Downloaded/目录看——无水印视频旁边还有封面图和一份元数据 JSON,作者、发布时间、描述都写在里面。

还能做什么

主页批量备份配置

适用情况:想收藏某位创作者的全部作品。怎么配置:把主页链接写进配置文件,运行python downloader.py -c config.yml

link: - https://www.douyin.com/user/主页ID mode: - post # post=发布作品,like=点赞作品 number: post: 50 # 只取最近50条,0 表示全部

得到什么:每个作品一个独立文件夹,文件名带发布日期,终端实时刷新进度和成功/失败/跳过统计。

增量更新开关

适用情况:隔几天重跑同一个主页,只搬新增作品。怎么配置:把increase.post设为true并保留database: true,SQLite 会记住历史自动去重;再加一行start_time: "2025-01-01"可只保留该日期之后发布的内容。得到什么:已下载的作品被跳过,终端会明确显示"跳过已存在"的条数。

合集、图文与音乐

适用情况:想保存长系列教程或某首原声音乐。怎么配置:把合集页面或音乐页面的链接直接写进link列表,工具自动识别类型。得到什么:合集下的作品被逐个遍历存完,音乐单独存为音频文件。

直播录制

适用情况:想回看某场直播。怎么配置:运行python DouYinCommand.py -l "https://live.douyin.com/直播间ID" -p 保存目录,先展示房间标题、主播和在线人数,再让你选清晰度并生成 FLV 流地址。得到什么:文件落在Downloaded/{作者}/live/目录,下播或手动中断时已录部分完整保留。

文件归档结构

所有内容默认按"作者→类型→日期"归档,每个作品一个独立文件夹,找东西很顺手:

问题排查

  • 下载中途失败、提示登录失效现象:任务跑一半报错或返回空数据。原因:Cookie 有时效,一般 7~30 天会过期。解法:重新运行python get_cookies_manual.pypython cookie_extractor.py刷新登录态。
  • 主页作品只抓到 20 条现象:作品数量明显偏少。原因:翻页触发了风控。解法:隔一会儿重跑同一任务,增量模式会自动补齐;遇到验证提示时手动完成验证,别急着关窗。
  • 个别作品下载失败现象:列表里少数几条标红。原因:多为作品被删除或设为私有;若是接口临时限流,自带的指数退避重试会自动顶上,网络不稳时可在配置里加代理。
  • 磁盘空间吃紧现象:下载速度快但占地方。原因:封面、音乐、头像、JSON 默认全下。解法:把path指到大容量盘,或把covermusicavatarjson设为false减负。

延伸资源

  • 官方文档:USAGE.md,覆盖安装、Cookie 配置和两个版本入口的用法,新手先读这份。
  • 核心源码:apiproxy/douyin/ 是下载主流程、接口封装与 Cookie 管理所在,downloader.py 是统一版命令行入口,想看懂解析与限流重试的实现思路可以翻这里。

提醒一句使用边界:下载内容仅用于个人学习、备份或研究,请尊重创作者版权,不要二次传播或商用。

现在去复制你的第一条抖音视频链接,跑通第三步的命令。 几分钟后,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),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询