ARTICLE DETAIL

建站实战干货

来自一线的建站与推广经验沉淀,每一条都经过真实交付验证。

如何用 douyin-downloader 无水印批量下载抖音视频:从单条链接到整个主页

2026/9/15 15:40:00 拓冰建站 浏览量
如何用 douyin-downloader 无水印批量下载抖音视频:从单条链接到整个主页 如何用 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-downloaderdouyin-downloader 是一个开源的抖音批量下载工具粘贴主页链接即可自动挑选无水印视频源、多线程并发下载并跳过已下载内容覆盖单个视频、图文、合集、音乐与直播间下载结果按作者和日期自动归档。 项目速览douyin-downloader 是一个面向实用场景的抖音下载工具从单条链接到整站主页任务都能处理默认带进度展示、失败重试、数据库去重与浏览器兜底能力。链接即任务视频、图文、合集、音乐、用户主页、收藏夹、短链均能自动识别无需手动指定类型识别逻辑见 core/url_parser.py。流程默认稳定并发下载、指数退避重试、速率限制、Content-Length 完整性校验配合 SQLite 去重与增量下载长时间批量任务不容易跑飞。能力可叠加评论采集、直播录制、热搜榜与关键词搜索、REST API 服务、完成通知推送、Docker 部署按需开启。上图是同一套后端打造的桌面客户端 Douzy内测中粘贴抖音链接即可开始下载任务状态可视化管理。命令行用户不受影响二者共享下载内核。 核心能力拆解批量下载从一条链接到整个创作者主页解决的是逐个复制粘贴的问题。把链接放进配置文件的link字段或用-u参数临时追加工具会按链接内容分发到对应的下载策略策略实现在 core/user_modes/。单条视频、图集、合集、音乐链接直接下载主页链接则先拉取作品列表再并发下载支持post发布、like点赞、mix合集、music音乐等模式组合跨模式自动按aweme_id去重。无水印下载与高清源挑选解决下载下来的视频带水印或画质差的问题。程序在多个候选源中自动优先选择无水印地址并基于video.bit_rate数组挑选最高码率的版本无需手工比对画质档位。去重与增量下载定时任务只跑新作品解决定期同步关注博主时重复下载的问题。启用database: true后程序用数据库记录 本地文件双重检查判断作品是否已下载再叠加increase.post: true每次运行只会抓取新发布的作品。这是把工具接入 crontab 或定时任务的前提。浏览器兜底只抓到 20 条时怎么办解决翻页被风控截断的问题。主页批量下载经常遇到 API 翻页限制最多只能拿到 20 条。开启browser_fallback后工具会在受限时启动 Chromium 浏览器模拟滚动翻页窗口保留人工过验证码的机会翻页完成后回到正常下载流程。直播录制、评论采集与搜索直播录制实验性live.douyin.com/{room_id}链接会被识别为直播任务输出 FLV/HLS主播下播或中断时已录制的字节会保留并附带直播间元数据快照。评论采集开启comments.enabled后按作品抓取评论可选二级回复输出*_comments.json。热搜与搜索--hot-board [N]导出热搜榜 JSONL--search 关键词按关键词批量导出作品数据适合做数据快照。 快速上手四步完成首次下载克隆仓库并安装依赖一条命令完成基础环境git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt复制示例配置生成自己的config.ymlcp config.example.yml config.yml自动获取 Cookie脚本会打开浏览器登录抖音后回到终端按 EnterCookie 自动写入配置python -m tools.cookie_fetcher --config config.yml下载一条视频验证环境是否可用python run.py -c config.yml -u https://www.douyin.com/video/xxxx如需浏览器兜底或自动取 Cookie额外安装 Playwrightpip install playwright python -m playwright install chromium。⚙️ 关键配置详解mode、number、increase配置项不少但日常使用真正需要理解的集中在下面几项完整说明见 config/config_loader.py配置项作用用法示例link下载目标可填多条粘贴视频/图文/合集/主页链接mode任务类型post发布、like点赞、mix合集、music音乐number.*各模式数量上限0 为不限number: {post: 50}只下 50 条thread/retry_times并发数 / 重试次数默认 5 并发、3 次指数退避重试start_time/end_time时间过滤格式YYYY-MM-DD只下指定区间作品increase.*增量开关只拉新作品increase: {post: true}依赖数据库记录browser_fallback翻页受限时启动浏览器enabled: trueheadless: falsefolderstyle按作品维度建子目录默认true利于按作品归档一个典型的最小批量下载配置link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx mode: [post] number: post: 50 thread: 5 database: true 三类用户的典型用法个人收藏定时同步关注博主用increasedatabase组合把命令写进 crontab 每天凌晨跑一次只会有新作品被下载旧的自动跳过。下载目录默认按作者名/模式/日期_标题_aweme_id/组织每个作品旁附带_data.json元数据发布时间、点赞数等。创作者研究打包主页作品 评论 元数据主页链接搭配mode: [post]、number.post: 100、start_time限定时间范围再开启comments.enabled与元数据输出一次任务即可拿到作品文件、评论 JSON 和统计字段直接用于结构分析。桌面版的关注管理页做了同样的事同步博主、筛选有新作品的账号、直接触发下载。数据收集热搜快照与关键词搜索不下载媒体、只取数据时--hot-board 30和--search 关键词 --search-max 100会输出带时间戳的 JSONL 文件方便按天存档、做趋势比对。批量任务跑完后桌面版任务中心会汇总成功/失败计数失败项可直接重试命令行用户则依赖内置的重试与完整性校验兜底。 常见问题与排错现象只能抓到 20 条作品原因API 翻页被风控截断。 处理确认browser_fallback.enabled: true且headless: false浏览器弹出后手动完成验证验证完成前不要关闭窗口。现象下载失败提示 Cookie 无效原因Cookie 过期有有效期限制。 处理重新执行python -m tools.cookie_fetcher --config config.yml刷新。现象进度日志刷屏原因调试日志混入了进度阶段。 处理保持progress.quiet_logs: true默认开启仅在排查时临时加-v。现象想让某个作品重新下载原因去重依赖数据库 本地文件双重记录只删一处不生效。 处理删除本地对应作品目录同时从dy_downloader.db的aweme表中删除该aweme_id记录。现象找不到下载的内容处理默认输出在Downloaded/作者名/模式/下每个作品目录内含视频、封面、音乐与_data.json整份清单见download_manifest.jsonl。 进阶与扩展REST API 服务pip install fastapi uvicorn后加--serve --serve-port 8000启动可用POST /api/v1/download提交任务、GET /api/v1/jobs/{id}查询状态适合接入自己的后台实现在 server/app.py。完成通知notifications支持 Bark / Telegram / Webhook 并发推送单路失败不阻塞下载。视频转写transcript.enabled: true时调用 OpenAI Transcriptions 接口输出txt/json两种格式文本。Docker 部署仓库自带 Dockerfile映射config.yml与Downloaded目录即可运行。定制方向下载策略集中在 core/user_modes/按模式扩展策略类下载器选择逻辑在 core/downloader_factory.py命名与校验逻辑在 utils/naming.py 和 utils/validators.py改文件组织方式或新增内容类型时从这里入手。 资源索引完整文档与配置项列表README.zh-CN.md配置加载与默认值config/default_config.py链接识别core/url_parser.py下载策略core/user_modes/去重数据库storage/database.pyCookie 自动获取tools/cookie_fetcher.py浏览器兜底登录cli/login_flow.py【免费下载链接】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),仅供参考