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.py或python cookie_extractor.py刷新登录态。 - 主页作品只抓到 20 条现象:作品数量明显偏少。原因:翻页触发了风控。解法:隔一会儿重跑同一任务,增量模式会自动补齐;遇到验证提示时手动完成验证,别急着关窗。
- 个别作品下载失败现象:列表里少数几条标红。原因:多为作品被删除或设为私有;若是接口临时限流,自带的指数退避重试会自动顶上,网络不稳时可在配置里加代理。
- 磁盘空间吃紧现象:下载速度快但占地方。原因:封面、音乐、头像、JSON 默认全下。解法:把
path指到大容量盘,或把cover、music、avatar、json设为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),仅供参考