三步上手 douyin-downloader:抖音无水印下载与主页批量抓取完整指南
【免费下载链接】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 是一个免费的抖音无水印下载工具,覆盖单条视频、图文、合集与原声,也支持创作者主页批量抓取,自带去重、断点续传和直播录制。跑通第一次下载,只需要一个终端和 5 分钟。
能力地图:它能搬走什么,不碰什么
| 类别 | 支持 | 需要注意的限制 |
|---|---|---|
| 内容类型 | 视频、图文、合集、原声,自动挑无水印最高清源 | — |
| 链接形式 | 直链与v.douyin.com短链自动解析 | — |
| 主页批量 | post / like / mix / music 四种模式,可按数量、时间范围截取 | 浏览器兜底仅对 post 模式完整验证 |
| 个人账号 | 登录后可搬自己的点赞与收藏夹 | collect 模式不可与其他模式混用,不支持增量 |
| 进阶功能 | 直播录制(FLV/HLS)、评论采集、热搜榜与关键词搜索 | HLS 直播源只保存 playlist,需 ffmpeg 后处理 |
| 可靠性 | SQLite 去重、断点续传、完整性校验、失败重试(默认 3 次、并发 5) | — |
五分钟跑通:安装、取凭证、拿到第一个文件
前提是 Python 3.8 以上,按顺序执行四步即可。
git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader/douyin-downloader && pip install -r requirements.txt获取登录凭证,命令会弹出浏览器,扫码登录抖音后回终端按回车,Cookie 自动写入配置:
python -m tools.cookie_fetcher --config config.yml复制一份最小配置,把link改成你想下载的视频链接,其余保持默认:
cp config.example.yml config.yml python run.py -c config.yml几秒后Downloaded/目录里就会多出第一个无水印文件,Cookie 有效期一般 1~2 周,过期重跑上面的取凭证命令即可。
命令行运行效果:链接解析、下载进度与统计信息实时可见
场景工具箱:三类读者各取一个核心操作
个人收藏党:把一位创作者的主页完整搬回家
把配置里的link换成主页地址并指定模式,多线程并行下载、失败自动重试:
link: [https://www.douyin.com/user/MS4wLjABAAAAxxxx] mode: [post] number: {post: 50}再配start_time: "2024-06-01"和end_time: "2024-06-30",就只搬这个时间段的作品。文件会按作者目录 + 命名模板(默认{date}_{title}_{id})自动归档,每个作品一个文件夹,视频、封面、BGM、元数据 JSON 齐全。
批量下载时每个任务一条独立进度条,失败任务自动重试
内容研究者:给每条作品挂上评论
comments: enabled: true include_replies: true每个作品额外产出一份*_comments.json,二级回复一并抓出,可直接进分析流程。
自动化玩家:把下载器变成服务
pip install fastapi uvicorn && python run.py --serve --serve-port 8000通过 REST 接口提交任务、查询状态,方便接入脚本;配置 OpenAI Key 后还能给每个视频生成文字转写,下载完成时推送到 Bark / Telegram / Webhook。
问题速查表:现象 → 原因 → 解法
| 现象 | 原因 | 解法 |
|---|---|---|
| 报 403 Forbidden 或"未登录" | Cookie 过期(有效期约 1~2 周) | 重跑python -m tools.cookie_fetcher --config config.yml扫码 |
| 批量只抓到 20 条作品 | 翻页被风控 | browser_fallback.enabled: true、headless: false,手动完成验证 |
| 下载到一半断了 | 不需要重来 | 断点续传 + Content-Length 校验,重跑自动补缺 |
| 内存偏高、速度偏慢 | 并发开得太激进 | thread从默认 5 调到 3,每批控制在 50~100 条 |
| 文件名乱、不好找 | 默认命名不合习惯 | 自定义filename_template: "{date}_{title}_{id}" |
收尾:从零到个人内容库的三步路径
- 先用一条链接跑通流程,确认环境和凭证没问题;
- 选一位创作者完成一次整页批量下载,体验去重与增量(
increase.post: true); - 按需叠加时间过滤、直播录制和完成通知,把任务挂成长期作业。
douyin-downloader 完全开源免费,模块划分清晰(core/负责下载、auth/负责凭证、storage/负责数据库与文件管理),有 Python 基础的开发者可以按需求扩展;不习惯终端的读者也可以用基于同一套后端的桌面版客户端 Douzy。
【免费下载链接】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),仅供参考