douyin-downloader 抖音去水印下载指南:从单条视频到批量搬空创作者主页
2026/9/16 12:00:58 网站建设 项目流程

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 是一个免费开源的抖音去水印下载工具,它直接从服务器取回无水印的原始文件,并自动挑出最高画质。单条作品、图文、合集、作者主页、直播,都能批量收进本地。读完这篇,你会装好工具、配好登录凭证,并把单条、主页、直播三个典型场景各跑通一遍。

能力总览:为什么它能拿到无水印的高清原片

区别在于一个顺序:录屏和解析站都是"先拿到画面,再想办法处理",而抖音批量下载工具 douyin-downloader 是"先找到源,再下载"。它自行解析抖音的视频源,优先挑无水印的那一份;多条转码档并存时,按码率表自动选最高档,也可以把video_quality设为original去探测上传原片,探测失败再回退到最高转码档。

它替你省掉的麻烦和能带走的内容大致如下:

  • 视频:无水印 mp4,默认自动选最高清
  • 图文 / 图集:整组图片一次收齐
  • 合集:按mix模式整串保存,不用逐集点
  • 原声音乐:优先原声文件,缺失时回退到该音乐下的首条作品
  • 封面、头像:作为附带产物可选下载
  • 元数据:每个作品一份*_data.json,标题、作者、ID 都在里面
  • 评论:开启后每个作品旁生成*_comments.json
  • 直播:录制直播间流,下播也保留已录部分

🧰 一次性准备:环境安装与抖音 Cookie 自动获取命令

准备工作一共四步,做完一次以后都不用再动。

把代码拿到本地(需要 Python 3.8+,Windows、macOS、Linux 均可):

git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader

克隆仓库并进入项目目录。

装依赖,一条命令:

pip install -r requirements.txt

装好后所有 Python 依赖就齐了。

然后复制一份配置模板:

cp config.example.yml config.yml

之后所有改动都发生在config.yml里,原模板不动。

最后是拿 Cookie 这一步——也是整个流程里最容易被卡住的地方。抖音的内容需要登录态才能访问,手动从浏览器里翻 Cookie 很容易漏项,项目内置了一个自动获取的小工具:

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

运行后会自动弹出浏览器,扫码登录你的抖音账号,回到终端按回车,Cookie 就自动写进配置文件了。顺带一提:后面要开浏览器兜底翻页的话,需要先装一次pip install playwright再执行python -m playwright install chromium

🎬 三个典型场景:单条作品、作者主页、直播录制

工具给了两个并列入口:命令行(python run.py -c config.yml跑配置)和桌面版(内测中,粘贴链接点按钮即可,左侧集成了账号管理、多链接队列、任务中心)。两个入口共享同一套后端,下面每个场景都以配置文件为主、顺带说桌面版。

单条作品:抖音视频无水印下载

只想要一条作品时,最省事。把链接填进link,配个落盘目录:

link: - https://www.douyin.com/video/7604129988555574538 # 换成要保存的作品链接 path: ./Downloaded/

v.douyin.com开头的分享短链也能直接填,工具会自动解析成长链接,不用手动去网页里找。不想碰配置文件的话,也可以命令行追加:python run.py -c config.yml -u "作品链接"。跑起来后你会看到 Rich 进度条,失败的请求按指数退避自动重试;文件传了一半断网,它会比对长度、清理残缺文件再重下,不会留下一堆半截文件。

批量下载:抖音主页批量下载配置

想把某位创作者的内容一次搬回家,把链接换成主页地址,再声明要哪些类型:

link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx # 换成作者主页链接 mode: - post # 发布的作品 - mix # 合集 number: post: 50 # 每类各拉多少条 mix: 0 # 0 表示不限量

mode就是内容清单:post作品、like点赞、mix合集、music原声;number填 0 即全量。同一个作品在多个模式里出现只下一次,跨模式自动去重。长期追更的博主可以打开increase.post: true,下次运行只拉新增;只整理某段时间的内容,则用start_time/end_time(格式YYYY-MM-DD)圈定范围。跑完后所有记录进数据库,重复运行自动跳过已下过的。

直播:抖音直播录制配置

想把直播留着回看,把直播间链接丢进配置即可:

link: - https://live.douyin.com/123456789 # 换成直播间链接 live: max_duration_seconds: 3600 # 0 表示一直录到主播下播

主播下播、断网甚至你按了 Ctrl+C,已经录到的字节都会保留下来,不会白录。产物存在Downloaded/作者名/live/下,附带一份*_room.json直播间元数据。直播接口官方标注为 experimental,个别场景可能不覆盖,遇到怪事别怀疑自己。

📁 下载完的文件:归档结构与下载历史查询

下载完不用手动整理。默认开启folderstyle,每个作品单独一个文件夹,挂在作者名下:

Downloaded/ └── 作者名/ ├── post/ │ └── 2024-02-07_作品标题_作品ID/ │ ├── ...mp4 # 无水印视频 │ ├── ..._cover.jpg # 封面 │ ├── ..._music.mp3 # 原声 │ └── ..._data.json # 作品元数据 ├── like/ ├── mix/ ├── music/ └── live/ # 录制直播时生成

命名不喜欢可以改:filename_template默认是{date}_{title}_{id},支持{author}{mode}{timestamp}等变量,换成自己习惯的格式即可。

历史这边也不用翻文件夹。开启database: true后,所有下载记录落在dy_downloader.db,想翻查存过什么,一条查询看最近 20 条:

sqlite3 dy_downloader.db "SELECT aweme_id, title, author_name FROM aweme ORDER BY download_time DESC LIMIT 20;"

桌面版还有一份可视化的创作者列表,能看到每位博主的作品数和上次下载时间,追更时一眼看清进度。

🩹 卡住了?先查这四处

主页几百条作品,为什么只拉到 20 条?这是抖音翻页风控,不是工具坏了。打开浏览器兜底,弹窗出现后手动完成一次验证即可:

browser_fallback: enabled: true headless: false

Cookie 失效了?重跑一遍python -m tools.cookie_fetcher --config config.yml,扫码后自动刷新,不用手动改配置。

某个作品想重新下载,为什么不动?去重是"数据库记录 + 本地文件"双重判断,只删一处不够,文件目录和数据库里的记录要一起删掉再重跑,具体清理命令见 README.zh-CN.md。

画质不够高?video_quality从默认的highest改成original,它会多探测一次上传原片,原片比最高转码档大就直接下原片,探测失败自动回退。

🚀 现在就开始你的第一次下载

挑一条你最想留存的视频,把链接填进link跑一次python run.py -c config.yml,几分钟内它就在你的硬盘里了。跑通单条之后,主页批量和直播录制只是换两行配置的事。最后提醒一句:这个工具适合个人学习、研究和合理收藏使用,请尊重原创作者的权利,也遵守平台规则。

【免费下载链接】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),仅供参考

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

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

立即咨询