抖音批量下载:一条命令带走任意账号的去水印视频
【免费下载链接】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(GitHub_Trending/do/douyin-downloader)是一个抖音批量下载工具:单条视频、图集、合集、音乐和账号主页都支持,去水印源、并发控制、失败重试与 SQLite 去重开箱即用。
跑起来:克隆、改配置、下载第一个视频
三步就能看到第一个视频落盘:
git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt cp config.example.yml config.yml环境依赖 Python 3.8+ 和 aiohttp 等几个网络库。把目标链接填进 config.yml 的link字段,运行python run.py -c config.yml,文件会落在./Downloaded/下。遇到要求登录时,另开终端跑python -m tools.cookie_fetcher --config config.yml自动抓 Cookie,登录后按回车即写入配置。
核心功能拆解:批量下载的三个关键能力
单条链接去水印下载
粘贴一条链接,工具自动解析短链、挑去水印源,默认只保存视频文件本身。
link: - https://www.douyin.com/video/7604129988555574538视频、图集、合集、音乐链接都走这个入口;封面、音乐、头像、JSON 元数据默认全关,需要哪个就在配置里单独打开。
用户主页批量下载
给一个主页链接、选好模式,就能按模式批量拉取该账号的作品。
link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx mode: - post number: post: 50mode支持 post(作品)、like(点赞)、mix(合集)、music,可一次多开且同一作品跨模式去重;注意 only post 验证过浏览器兜底,like/mix 靠 API 翻页,更容易触发风控。
增量下载与 SQLite 去重
重复运行时,程序扫描本地文件名里的 aweme_id,主文件已存在的作品直接跳过。
把increase.post设为true即启用增量;设为false会强制重下并原子覆盖当前筛选范围。SQLite(默认dy_downloader.db)记录下载历史供查询,但跳过与否只看磁盘上文件在不在,不看历史。
进阶玩法:原画质量与定时增量更新
如果你需要定期追更固定账号的新视频、又要原画画质,可以这样配置:
video_quality: original increase: post: true start_time: "2026-09-01" thread: 10original会探测上传原片(可比最高转码档大数倍,探测失败退回最高档,代价是每条作品多一次探测请求);start_time/end_time圈定时间窗;thread调到 10 时建议配合rate_limit(默认 2 req/s)和retry_times(指数退避)一起压着点,效率与稳定取平衡。
踩坑速查
- 只抓到 20 条左右的作品→ 翻页风控,开
browser_fallback.enabled: true且headless: false,在弹出的浏览器里手动完成验证 - 登录态失效、Cookie 过期→ 跑
python -m tools.cookie_fetcher --config config.yml重新抓取,自动写回配置 - 想强制重新下载→ 删本地作品文件(文件夹名含 aweme_id);只删数据库不触发重下
- collect / collectmix 不生效→ 收藏合集模式只对登录账号自己的数据生效,且必须单独使用,不能与 post/like/mix/music 组合
- 进度日志刷屏→
progress.quiet_logs: true默认已开,调试时临时用-v或--show-warnings
项目里看什么
- config.example.yml —— 配置项全集,调参数前先查这里
- cli/main.py —— 单条 URL 的完整流水线:解析短链、解析 URL、工厂建下载器、写历史
- core/user_modes/ —— post/like/mix 各下载模式的策略模式实现
- storage/database.py —— SQLite 历史表与增量跳过判断逻辑
- control/ —— 限速、重试退避、并发队列三件套
项目定位就是一个开箱即用的抖音批量下载工具,想二次开发可以从 core/ 的下载器工厂和模式注册表看起。🚀
【免费下载链接】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),仅供参考