3 步跑通抖音无水印下载:抖音批量下载工具实用指南
【免费下载链接】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 是一个开源的抖音无水印下载工具,支持单条视频、图集、合集与主页批量下载,自带去重、重试和进度展示。读完这篇,你会自己跑通它。
💡 它替你解决什么
| 能力 | 你能得到的收益 |
|---|---|
| 无水印源自动挑选 | 不用自己找源,文件拿来就能二次剪辑 |
| 主页批量下载(post/like/mix/music 模式) | 一条链接成批保存某位博主的作品 |
| 最高画质自动选择与原片探测 | 按码率阶梯取最高清晰度或原片,不用手动挑档 |
| SQLite 加本地文件双重去重 | 重复运行不重复下载,中断的任务接着跑 |
| 浏览器兜底与退避重试 | 翻页被限流时可人工过验证,临时失败自动重试 |
| 时间过滤、评论采集、完成通知 | 只存时间窗内的作品,评论数据留档,结果推送到手机 |
这些能力都落在仓库代码里,命令行入口是 run.py。
⏱️ 5 分钟跑通
第 1 步:装好依赖并准备配置文件
需要 Python 3.8 以上。克隆仓库、装依赖、复制示例配置:
git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt cp config.example.yml config.yml第 2 步:一行命令自动获取抖音登录 Cookie
python -m tools.cookie_fetcher --config config.yml运行后会打开浏览器,扫码登录,回到终端按 Enter,Cookie 就写进配置文件了。实现见 tools/cookie_fetcher.py。想同时启用浏览器兜底,再执行pip install playwright和python -m playwright install chromium。
第 3 步:写一份最小批量下载配置
参考 config.example.yml,在config.yml里只改必须项:
link: - https://www.douyin.com/user/xxxx mode: - post number: post: 20 path: ./Downloaded/number.post: 0表示不设上限;link可以写多条,短链也支持自动解析。
第 4 步:执行任务并盯住进度条
python run.py -c config.yml也可以不落配置文件、直接在命令行覆盖参数:-t 8调并发、-p ./Downloaded指定输出目录。运行中 Rich 进度条会展示每个任务的状态。
Douzy 桌面版(与 CLI 同一后端)的任务中心:查看每批下载任务的结果、重试失败项、直接打开输出目录。
📥 典型用法
场景一:成批保存一位博主的主页作品。做法:link指向主页链接,mode用post。由于平台风控在 2026 年起限制了部分接口,主页作品翻页主要走浏览器兜底链路,请保持browser_fallback.enabled: true且headless: false,弹窗出现时人工完成验证、不要提前关窗口。技巧:如果只拿到二十条左右,多半是验证没做完,重跑一次即可,已下的会被去重跳过。
场景二:只保存某段时间的作品。做法:加上start_time: "2026-01-01"和end_time: "2026-06-30"。技巧:配合increase.post: true,再次运行只补新作品,素材库可以持续扩建而不覆盖旧文件。
场景三:只采集数据、不下载视频本体。做法:直接在终端执行python run.py --search "关键词" --search-max 100 -p ./Downloaded,或者python run.py --hot-board 30 -p ./Downloaded,结果落成 JSONL 文件,供后续分析,不必为选题先下几百个视频。
⚙️ 进阶选项速查
最常调的五项:
thread: 3 # 并发数,弱网时调小 start_time: "2026-01-01" # 时间过滤,YYYY-MM-DD video_quality: original # 探测原片;highest 为最高转码档 comments: enabled: true # 每个作品附带一份评论 JSONthread默认 5,机器吃紧时调到 3。video_quality: original会为每条作品多一次探测请求,真正需要原片时再开。comments开启后,视频旁多一个*_comments.json,方便做话题或舆情分析。
全部配置项与注释以 config.example.yml 为准。
🛟 遇到问题先看这里
主页作品为什么只拉下来二十条左右?这是常见的翻页风控表现。保持browser_fallback.enabled: true、headless: false,在弹出的浏览器窗口里人工过验证,且别提前关闭。接口受限的详细说明见 README.zh-CN.md 的限制说明章节。
删了文件却不再重新下载(或反过来),为什么?程序用“数据库记录加本地文件”双层判断跳过。要重下某条,需要同时删掉它的本地目录(文件夹名含 aweme_id)和dy_downloader.db里的记录;只删数据库或只删文件,行为不一样。
提示 Cookie 失效怎么办?重跑一遍 cookie_fetcher 命令覆盖即可。
⚖️ 使用边界
- 内容仅限个人学习、研究与数据管理用途,尊重原创者版权。
- 未获授权时,不要将下载内容用于商业发布或二次传播。
- 平台风控与接口变动属于正常技术风险,当前受限项以仓库 README 为准。
✅ 现在就行动
- 克隆仓库并装完依赖
- 跑一遍 cookie_fetcher 拿到登录态
- 在配置里写好
link与mode,先下 1 到 2 条试跑 - 确认浏览器兜底开启,再扩大到二十条的小批量
- 跑顺之后,加上时间过滤与并发数
流程跑通之后,剩下的只是按你的素材库调参数。
【免费下载链接】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),仅供参考