
抖音去水印批量下载作品主页全量备份的开源工具【免费下载链接】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-downloaderdouyin-downloader 是一款 Python 编写的开源抖音下载器核心能力是去水印批量下载单条视频、图集、合集、音乐、作者主页作品乃至直播流都能落到本地适合想归档作品、建素材库但不想写代码的用户。 先跑起来安装配置与首条下载三步就能跑通第一个下载任务不需要任何编程经验。第一步克隆项目git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader第二步进入仓库内的 douyin-downloader 子目录项目主体安装依赖并生成配置文件cd douyin-downloader/douyin-downloader pip install -r requirements.txt cp config.example.yml config.yml第三步获取 Cookie 并运行首次下载。Cookie 工具会打开浏览器登录一次抖音后回到终端按回车程序自动写入配置随后执行下载命令。如果希望翻页受限时启用浏览器兜底另装 playwright 这一个可选依赖即可python -m tools.cookie_fetcher --config config.yml python run.py -c config.yml跑完后打开Downloaded/目录作品按「作者 / 作品类型 / 日期」分层存放视频、封面、原声、JSON 元数据各归其位。 能力全景支持的内容类型一览链接识别比较宽不用记各种格式。程序会自动识别链接类型并派发到对应的下载器多个链接可以一次性写进配置逐个处理、自动去重。链接类型处理方式单条视频/video无水印最高清直出图文/note图集全部图片下载合集/collection合集内作品全量拉取音乐/music优先保存原声文件短链v.douyin.com自动解析成原始地址作者主页/user批量下载发布/点赞/合集收藏夹当前登录账号收藏归档直播间live.douyin.com自动检测清晰度并录制评论按作品导出 JSON热搜榜/关键词导出 JSONL 做分析传入直播间链接后程序会列出可选清晰度FULL_HD、SD1、SD2并输出 FLV 流地址录制文件可直接播放。⚙️ 配置详解config.yml 核心字段核心配置文件是 配置文件示例YAML 格式复制为config.yml后按需修改。关键字段含义如下link下载链接列表支持一次写多条短链、视频、图文、主页均自动识别跨链接自动去重。path保存目录默认./Downloaded/。mode主页下载模式post发布作品、like点赞、mix合集、music原声collect/collectmix仅对当前登录账号收藏夹生效且必须单独使用。number各模式数量上限0 表示全量抓取。thread并发线程数默认 5retry_times控制失败重试次数。database/database_path启用 SQLite 去重与历史记录是断点续传和增量下载的基础。cookies登录态支持自动获取、整串粘贴、键值对三种方式。start_time/end_time时间过滤格式YYYY-MM-DD留空不过滤。browser_fallback翻页受限时启用浏览器兜底含max_scrolls、headless等参数。最小可用配置link: - https://www.douyin.com/video/7604129988555574538 path: ./Downloaded/ mode: - post thread: 5 database: true # 其余字段省略 稳定性设计断网、重复与风控兜底一次跑几百个作品最怕断网和重复下载。下载引擎内置四层保护双重去重用 SQLite 数据库记录加本地文件扫描双重判断同一作品相同aweme_id无论出现在哪个模式、哪条链接里都只下载一次。完整性校验下载完成后比对文件大小与 Content-Length不完整的文件自动清理并重试不会留下损坏文件。断点续传中断后重跑已完成的作品直接跳过单个任务失败按 1s、2s、5s 指数退避重试次数由retry_times控制。速率限制与风控兜底请求默认按 2 次/秒限流降低触发平台风控的概率post模式翻页受限时browser_fallback自动打开浏览器人工过一次验证码即可继续。并发数可调进度条实时展示每个任务的完成状态大任务跑下来不会乱。 进阶与扩展增量、API 与推送三个进阶场景都可以独立使用。增量下载只拉新作品把increase.post设为true并保持database: true程序对比数据库记录只下载新增内容适合长期追踪某个博主再配合start_time/end_time还能只取指定时间段的作品。把下载器变成 REST 服务装好fastapi和uvicorn后起服务pip install fastapi uvicorn python run.py --serve --serve-port 8000启动后向POST /api/v1/download提交{url: ...}派发任务GET /api/v1/jobs/{job_id}查询状态完成任务按 TTL 和容量自动剪裁方便接进自己的自动化流程。完成推送与数据导出notifications配置支持 Bark、Telegram、Webhook 三类通道下载完成手机即收到通知单通道失败不阻塞主流程--hot-board与--search参数可以一条命令拉取热搜榜和关键词搜索结果落盘 JSONL 便于选题与热点分析。❓ 常见问题Cookie、去重与翻页排查日常使用中最容易卡住的五类问题处理方式如下。只能抓到 20 条作品后面抓不到 → 这是抖音翻页风控的常见现象。把browser_fallback.enabled设为true、headless设为false翻页受限时会自动弹出浏览器手动完成验证码不要立刻关窗即可继续。提示 Cookie 失效或需要登录 → 抖音会定期轮换登录态。重新执行python -m tools.cookie_fetcher --config config.yml登录一次即可恢复建议定期刷新别等报错才动手。想重新下载某个作品但一直被跳过 → 去重靠「数据库记录 本地文件」双重判断。删掉对应作品目录文件名含aweme_id再用 sqlite3 从dy_downloader.db删除该aweme_id的记录重跑就会重新下载。进度条刷屏太吵 → 确认配置中progress.quiet_logs: true默认开启它会在进度阶段静默日志确需排查细节时临时加--show-warnings或-v参数运行。直播录制中途中断 → 已录制的字节会保留.tmp临时文件自动提升为正式文件中断不等于丢失重新运行即可继续管理录制产物。 写在最后douyin-downloader 把重心放在「实用」上没有花哨功能但每一项都落在具体场景里改配置就能从单条视频扩展到整页归档、直播录制和数据导出双重去重与断点续传设计让大任务跑得放心。平台接口策略变化较快功能失效属于正常技术风险更新 Cookie 并查看项目内的 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创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考