抖音视频下载入门教程:去水印保存与主页批量抓取
【免费下载链接】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 是一款开源的抖音视频下载工具,直接从接口取回无水印的原始文件,也支持主页批量抓取、并发下载和去重。读完本文,你可以搭好运行环境、配置登录态,并完成第一次单条下载。
📌 能力一览:能帮你做什么
- 无水印原片获取:自动挑选无水印源,并按接口返回的码率表选最高清档位。适合想存干净素材的用户。
- 主页批量下载:给一个博主主页链接,可批量抓取作品、点赞、合集与音乐。适合想沉淀特定作者内容的用户。
- 附属资源:视频可连同封面、音乐、头像、JSON 元数据一起保存。适合素材整理和数据分析。
- 并发与重试:默认 5 路并发,失败按指数退避自动重试。适合长时间跑的任务。
- 去重与增量:SQLite 数据库加本地文件双重核对,重复运行不重复下载。适合定期追更。
- 浏览器兜底:接口翻页受限时自动打开浏览器读取页面内容,可人工过验证码。适合被平台限流的账号。
🔧 上手三步:从环境到第一次下载
准备运行环境
git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt需要 Python 3.8 以上。若要用浏览器兜底,再执行pip install playwright和python -m playwright install chromium安装浏览器内核。
配置登录态(获取 Cookie)
cp config.example.yml config.yml python -m tools.cookie_fetcher --config config.yml先把配置模板复制为正式配置,再运行 Cookie 脚本:会弹出浏览器,扫码登录你的抖音账号,回到终端按回车,登录态就写进配置文件了。
开始第一次下载
python run.py -c config.yml -u "https://v.douyin.com/你的短链/"-u用于追加一条链接快速试跑;也可以把链接写进config.yml的link列表,直接执行python run.py -c config.yml。-t指定并发数,-p指定保存目录,完成后文件默认按作者和作品归档在Downloaded/下。
⚙️ 常用配置说明
- link:下载目标,列表形式,每条可以是视频、图文、合集或主页链接。
- mode:决定主页链接抓取什么,
post作品、like点赞、mix合集、music音乐;新手从post开始即可。 - number:各模式的数量上限,0 表示不限;建议首次先设
post: 5试跑,稳定后再调大。 - thread:并发下载数,默认 5;网络一般时降到 3 更稳。
- video_quality:画质档位,默认
highest取最高转码档;original尝试原片,lowest省流量。 - start_time / end_time:时间过滤,格式
YYYY-MM-DD,只抓区间内的作品。
database和increase两项默认开启,负责去重与增量,保持默认即可。
🛠️ 踩坑与排查:下载失败怎么办
| 现象 | 原因与解决办法 |
|---|---|
| 所有链接突然失败 | Cookie 失效,重跑 Cookie 脚本重新登录 |
| 翻页停在 20 条左右 | 开启浏览器兜底,弹窗中手动过验证 |
| 单条视频接口被拒 | 平台风控升级,改用桌面版 Douzy |
| 第二次运行无新文件 | 去重生效,将increase改为false重试 |
适合谁用
- 个人收藏:想留存几位博主的作品或离线观看,贴一个主页链接、设好数量就能跑。
- 内容创作:需要无水印素材做剪辑参考,配合时间过滤只取近段内容,控制存储占用。
- 数据研究:要同时收集作品与结构化信息,打开
json和comments开关,可生成元数据与评论文件。
桌面版 Douzy 与 CLI 共用同一套后端,提供可视化的任务管理界面,功能受限时的备选入口。
提醒一下:
- 下载内容仅限个人学习、研究与存档,不要二次传播或用于商业用途。
- 尊重原创作者的版权,引用时注明来源,并遵守平台规则。
- 平台接口策略会调整,部分功能可能因风控临时失效,属正常现象。
最小起步路径:先用-u试跑一条链接,确认文件和命名符合预期,再调大number.post做主页批量下载。长时间任务把thread设在 3~5,保持去重与增量开启,定期重跑只补新作品。完整参数与接口限制见 README.zh-CN.md 与 config.example.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),仅供参考