抖音无水印下载工具上手指南：5行命令跑通批量下载

抖音无水印下载工具上手指南：5行命令跑通批量下载

【免费下载链接】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 编写，MIT 协议，Windows、macOS、Linux 都能跑。

🧩 能力清单：从获取到扩展

下面是这个抖音无水印下载工具的能力清单，按执行顺序排列。

• 抓取主页作品、图集与原声
• 无水印保存视频文件
• 失败自动重试，接口风控自动兜底
• 本地数据库去重，不重复下载
• 按日期与作者自动分目录归档
• 支持搜索、热搜与转写等扩展

🚀 两分钟跑通：5行命令完成第一次抖音无水印下载

前置条件只有一个：电脑装好 Python 3.9 或更高版本。下面是完整的最小命令序列，每行后我都解释了它在做什么。

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

这行把工具源码下载到本地一个文件夹里。

cd douyin-downloader && python -m pip install -r requirements.txt

这行进入项目目录，安装它需要的所有依赖。

cp config.example.yml config.yml

这行把示例配置复制成你的工作配置文件。后面所有改动都在这个文件里做。

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

这行会打开浏览器。你在浏览器里登录抖音，回到终端按回车，Cookie 就保存好了。

python run.py -c config.yml

这行启动下载。终端会显示进度条，每个作品的状态都看得到。

Windows 用户注意：第三行把cp换成Copy-Item config.example.yml config.yml，效果一样。

登录完成后，打开config.yml，把link改成你的目标博主主页。完整字段说明见 config.example.yml 里的注释。

link: - https://www.douyin.com/user/你的主页链接 # 必填：目标博主主页 path: ./Downloaded/ # 保存目录 mode: [post] # 下载作品；like/mix/music 按需加 number: post: 10 # 每次最多10条，0为不限 start_time: "2025-01-01" # 可选：只下该日期之后的作品

保存后重新运行python run.py -c config.yml。如果接口受限、抓不到作品，可以装一个浏览器兜底：

python -m pip install playwright python -m playwright install chromium

这两行安装本地浏览器。接口被风控时，它会打开页面滚动抓取作品。

第一次运行结束后，作品按「日期_标题_id」命名，保存在Downloaded/下，并按作者分成子目录。

抖音无水印下载支持四种下载模式：作品、喜欢、合集、音乐，各有独立数量上限。

🎯 按目标拆路径：批量、筛选、增量与采集

以下按你想达成的目标分四条路径，不重复前面的功能描述。

目标一：批量下载某个博主的主页作品

python run.py -u "https://www.douyin.com/user/MS4wLjABAAAAxxx"

-u追加一个主页链接，不用改配置文件。

python run.py -c config.yml -t 3

-t设置并发下载数。网络不稳时调低一点。

适用判断：你手里有博主主页链接，想把他的作品一次性批量存下来。

目标二：只下载某个时间段的作品

start_time: "2025-01-01" # 开始日期 end_time: "2025-06-30" # 结束日期，含当天

在config.yml里加这两行，其余字段不动。

适用判断：你只需要某个时期的内容，不想把整个主页拉完。

目标三：定期跟踪博主，只下新作品

python run.py -c config.yml

默认increase.post为 true，已下载的作品会跳过。磁盘上的文件丢了，会自动补下。

适用判断：你会反复下载同一个主页，不希望重复下载。

目标四：先收集作品清单，不下载视频文件

python run.py --search "猫咪" --search-max 50

按关键词搜索，最多拉 50 条，导出 JSONL 文件。

python run.py --hot-board 30

拉抖音热搜榜前 30 条，同样导出 JSONL。

适用判断：你要做数据分析或选片，只需要作品数据而不是文件本身。

如果你完全不想碰命令行，仓库配套提供桌面版 Douzy，图形界面操作同一套下载能力。

抖音无水印下载的桌面版入口：抖音默认置顶，另支持其他平台共用一个任务中心。

📁 完整实例：从主页链接到落盘归档

选一个最典型的用例，从头走一遍。目标：下载某美食博主最近的 10 条作品。

1. 克隆和登录已在前面完成。打开config.yml，改三处：link换成这位博主的主页链接，number.post设为 10，path保持默认./Downloaded/。
2. 运行python run.py -c config.yml -v。-v打开详细日志，出问题好定位。
3. 运行中，终端按阶段推进：解析链接，获取作品列表，逐条下载文件。进度条随每个作品更新。
4. 结束后终端给出汇总：成功、失败、跳过各多少条。
5. 打开Downloaded/，里面有一个以作者昵称命名的目录。文件按「日期_标题_id」命名，顺序整齐。
6. 同时生成了dy_downloader.db数据库，记录已下载的作品。两周后再跑一遍同样的命令，只有新增作品会被下载。

这就是抖音无水印下载的典型完整流程：一条主页链接进，一个自动归档的文件夹出。

⚠️ 踩坑速查：抖音无水印下载中断先对照这里

下面 4 个问题，覆盖大部分下载中断场景。

1. 现象：下载时提示登录态失效？ →原因：Cookie 过期了 →动作：重跑登录脚本
2. 现象：主页只抓到几条作品？ →原因：接口风控限制 →动作：等浏览器兜底完成验证
3. 现象：单条视频链接下不动？ →原因：当前风控不支持单条 →动作：改走主页批量下载
4. 现象：同一主页重复下载了？ →原因：增量开关被关掉 →动作：增量开关改回 true

更多排查方法见 README.zh-CN.md 的常见问题一节。

适用边界与下一步

它适合把博主公开作品做抖音无水印下载与本地归档的个人用户，不适合商用转分发，也不适合完全不接受命令行的人。下一步：现在克隆仓库，跑通你的第一次主页批量下载。

【免费下载链接】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