抖音无水印下载完整指南：从单条作品到主页批量保存高清视频的 4 个动手任务

抖音无水印下载完整指南：从单条作品到主页批量保存高清视频的 4 个动手任务

【免费下载链接】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 去重和浏览器兜底，新手约 5 分钟就能跑通第一次保存。

🎯 适合谁用：什么人、什么场景下最划算

• 想存下个别喜欢的作品，但不想忍受录屏的水印和压缩；
• 内容创作者，需要把某个领域博主的主页作品定期收进素材库；
• 直播观众与数据研究者，要存整场直播、抓作品评论做分析。

🚀 第一次抖音无水印下载：完整流程

第一步：铺好跑道（拿代码 + 装依赖，约 3 分钟）

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

两行命令：把项目放到你的电脑上，再进入项目目录，后面所有命令都在这里执行。

pip install -r requirements.txt python -m pip install playwright python -m playwright install chromium

第一行装全部 Python 依赖；后两行装浏览器引擎，它负责扫码登录和风控兜底，chromium 首次下载需要几分钟，耐心等待即可。

第二步：拿到入场券（扫码登录写 Cookie，约 2 分钟）

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

先把示例配置复制成实际使用的config.yml，再运行登录命令：它会弹出一个浏览器窗口，你用手机扫码登录抖音后回到终端按回车，Cookie 就自动写进配置文件，全程不用打开浏览器开发者工具手动复制。实现细节可以看 tools/cookie_fetcher.py。

第三步：跑起来第一次（约 1 分钟）

python run.py -c config.yml

启动后终端出现进度条，实时显示已完成数量和跳过重复数；想临时下一条作品，不用改配置，直接追加-u "https://www.douyin.com/video/xxxxxxxx"即可，文件默认落在./Downloaded/。

🏃 三个任务练手：由浅入深的真实用法

任务一：单条抖音作品存成无水印高清

目标：把一条喜欢的作品（视频或图文）存到本地，画质不缩水。

关键开关：

• video: true只保留视频本体
• cover: true需要封面时再打开，默认关着不产生多余文件
• 短链https://v.douyin.com/xxx可直接使用，会自动解析成完整地址

操作动作：把作品链接写进config.yml的link字段后运行python run.py -c config.yml，或者直接用-u参数临时传链接。

落盘结果：Downloaded/{作者名}/post/{日期}_{标题}_{作品ID}.mp4；开了封面则同目录多一张_cover.jpg。

任务二：抖音作者主页批量下载入库

目标：把某个博主的发布作品一次性收进素材库，后续定期增量补新。

关键开关：

• mode: [post]只抓发布作品，like/mix/music可叠加
• number.post: 50限量前 50 条，写0表示全量
• increase.post: true增量模式，已下载的作品自动跳过
• start_time: "2025-01-01"/end_time圈定时间段，只收特定时期的内容

操作动作：link里贴作者主页链接（含/user/的那条），运行后进度条会显示抓取进度；给link列表多贴几个博主，可以一次性建多条素材流。

落盘结果：Downloaded/{作者名}/post/下按日期_标题_作品ID一批文件夹；翻页被风控拦时会弹浏览器，你手动过完验证码它自己接着跑。

任务三：录抖音直播 + 采集作品评论

目标：存下重要直播回放，并收集作品评论用于分析。

关键开关：

• live.max_duration_seconds: 0录到主播下播为止，写具体秒数则限时
• comments.enabled: true按作品生成评论 JSON
• comments.include_replies: true连二级回复一起抓，注意请求量会增加
• notifications.providers配 Bark / Telegram / Webhook，下完手机提醒

操作动作：link里放live.douyin.com/...直播链接即可开录；评论采集跟着普通作品下载一起触发，不用单独跑命令。

落盘结果：直播流存在Downloaded/{作者名}/live/下并附带直播间元数据，中断也不丢已录字节；每个作品旁多一个*_comments.json。

📁 看懂下载目录：文件到底存在哪

目录是三层结构：作者名 → 模式（post / like / mix / music）→日期_标题_aweme_id，自动归类，不用手动整理。

一个作品目录下可能出现的文件：

• 视频本体.mp4，开对应开关后还有_cover.jpg、_music.mp3、_avatar.jpg
• _data.json作品元数据（开json: true）
• *_comments.json评论（开评论采集时）
• 根目录还有download_manifest.jsonl下载清单和dy_downloader.db去重数据库

最小可用配置（每项都带注释，照抄就能跑）：

link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx # 要下载的作者主页 path: ./Downloaded/ # 保存目录 video: true # 下载视频本体 cover: false # 封面，默认关 mode: - post # 只下发布作品 number: post: 50 # 限量 50 条，0 表示不限 thread: 5 # 并发数，3-5 比较稳 start_time: "2025-01-01" # 时间过滤起点 end_time: "" # 时间过滤终点，留空不限

保存后这份配置就够覆盖"主页批量、限量、限时间"三种诉求；想看全部默认项和每项的完整取值说明，翻 config/default_config.py 或 config.example.yml，下载核心逻辑在 core/ 目录。

🛠 踩坑排查：6 个真实问题怎么修

1. 主页只能抓到 20 条左右

• 现象：进度条很快走完，作品数远少于预期
• 原因：翻页接口被风控拦了，浏览器兜底没生效
• 解法：确认browser_fallback.enabled: true且headless: false，浏览器窗口弹出后手动完成验证码，别急着关窗口

2. 出现 403 或风控报错

• 现象：日志刷 403、提示登录态失效
• 原因：Cookie 过期了
• 解法：重跑python -m tools.cookie_fetcher --config config.yml扫码刷新

3. 单条作品 / 合集 / 点赞接口直接下载被拦

• 现象：主页作品能下，单条链接却下不动
• 原因：抖音 Argus 风控对 CLI 直连的这类接口做了拦截
• 解法：主页作品走浏览器兜底，或改用同后端的桌面版 Douzy，关注项目更新

4. 下载速度很慢

• 现象：进度条挪得比预期慢
• 原因：并发开太高触发限流，或网络本身不稳定
• 解法：thread回落到 3-5，网络差时在proxy配 HTTP/HTTPS 代理

5. 下完了却找不到文件

• 现象：终端显示完成，桌面却翻不到
• 原因：文件不在当前目录，而在配置的保存目录
• 解法：看config.yml的path，默认./Downloaded/，再按"作者名 → 模式"两层子目录找

6. 想重新下载已下过的作品

• 现象：删了文件夹重跑，却显示全部跳过
• 原因：去重是"数据库记录 + 本地文件名"双保险，只删一项仍会被跳过
• 解法：本地文件夹和dy_downloader.db里该作品的记录都删掉，再重新运行

动手前自检清单

• Python 依赖装完，playwright 的 chromium 已下载
• 扫码登录成功，config.yml里的 Cookie 已写入
• config.yml的第一个link换成了你的目标作品或主页
• python run.py -c config.yml跑通一次，进度条正常走完
• 打开Downloaded/目录，认熟了"作者 → 模式 → 日期_标题_ID"三层结构

最后提醒：下载内容请仅用于个人观看与合理使用，不要商用或二次传播，尊重原创作者的权益；平台接口策略会随时变化，遇到功能失效属于正常技术风险，留意项目更新即可。

打开终端，把第一个链接填进去，你的第一条无水印高清作品马上就会出现在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