
抖音下载器实操5 分钟跑通无水印视频、图集与批量主页下载【免费下载链接】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 是一个实用的抖音下载器支持视频、图集、合集、音乐的无水印下载也支持作者主页批量下载。默认带进度展示、指数退避重试、SQLite 去重和浏览器兜底适合需要把抖音内容落到本地的开发者、数据分析师和内容运营。快速上手5 分钟跑通第一个例子环境要求不高Python 3.8macOS / Linux / Windows 均可。git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt仓库提供了现成的 config.example.yml复制一份即可用。部分能力浏览器兜底、收藏夹下载需要登录 Cookie首次用自动获取最省事cp config.example.yml config.yml python -m tools.cookie_fetcher --config config.yml浏览器弹出后登录抖音回终端按 EnterCookie 会自动写回 config.yml。最小示例下载单个视频。python run.py -c config.yml \ -u https://www.douyin.com/video/7604129988555574538 \ -t 5 -p ./Downloaded✅ 跑成功的标志终端出现 Rich 进度条Downloaded/作者名/post/下生成以作品日期、标题、aweme_id 命名的子目录里面有.mp4和可选的_data.jsonDownloaded/根目录多出一个download_manifest.jsonl清单文件。看到这三样说明整条链路都通了。核心能力拆解单链接无水印下载一句话把一条链接粘进来自动识别类型并取无水印源。 怎么触发-u参数或配置文件link列表支持/video/、/note/图文、/collection/合集、/music/音乐优先原声文件v.douyin.com短链会先解析再下载。 什么时候用只想存单条内容时这是最轻的用法。画质由video_quality控制默认在 API 返回的多档码率里挑最高转码档。桌面版 Douzy 工作台内测中粘贴链接识别类型后一键下载。作者主页批量下载一句话给定一个/user/{sec_uid}链接按模式拉取该作者的内容。 怎么触发配置mode列表可选post发布、like点赞、mix合集、music音乐多个模式可叠加link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx mode: - post - like number: post: 50 # 0 表示全量 increase: post: true什么时候用做账号内容归档、竞品账号跟踪时。同一个 aweme_id 跨模式自动去重increase为 true 时跳过已下载作品配合database: true生效重跑任务只会补新内容。登录账号收藏夹下载一句话下载我的收藏里的视频和收藏合集。 怎么触发链接填https://www.douyin.com/user/self?showTabfavorite_collection模式用collect或collectmix。 什么时候用整理自己账号里攒的素材。注意它只认当前 Cookie 对应的账号且必须单独使用不能和 post/like 混用。浏览器兜底一句话API 翻页被风控卡住时启动真实浏览器继续翻页验证码由你手动过。 怎么触发browser_fallback.enabled: true建议headless: false。 什么时候用批量下载只抓到约 20 条、明显是分页受限时。它会采集缺失的 aweme_id 再补全详情max_scrolls和wait_timeout_seconds控制滚动轮数与等待上限。直播录制实验性一句话录live.douyin.com/{room_id}的直播流主播下播时已录数据不丢。 怎么触发link填直播间地址配live.max_duration_seconds0 录到下播。 什么时候用需要留存直播回放时。FLV 可直接播放HLS 源只保存 playlist要用 ffmpeg 后处理。评论采集与热搜、搜索导出一句话把内容之外的数据也落到本地。 怎么触发comments.enabled: true会为每个作品生成*_comments.jsonpython run.py --hot-board 30导出热搜榜快照python run.py --search 关键词导出搜索结果均为 JSONL 文件。 什么时候用做评论分析或关键词选题调研时不用下载媒体本身。关键配置说明以下条目来自 config.example.yml 注释与 README按对结果的影响排序配置项作用推荐值mode决定下载作者主页的哪类内容按任务选collect/collectmix单独用number.post等各模式数量上限0 为不限先设小值试跑稳定后改 0thread并发下载数默认 5网络好可调到 8video_quality码率档位original/highest/1080p 等highest要原片用originalincrease.post等增量开关跳过已下载作品定期跟更的账号设truebrowser_fallback.enabled翻页受限时启用浏览器trueheadless: falseprogress.quiet_logs进度阶段静默日志true避免刷屏proxyAPI 与媒体下载共用代理如http://127.0.0.1:7890database/database_pathSQLite 去重与下载历史true/dy_downloader.db进阶玩法与调优⚙️限速与并发据仓库文档默认速率限制为 2 请求/秒重试走指数退避1s、2s、5s。批量任务失败多时先降thread、别急着加代理retry_times默认 3 次通常够用。批量 增量跟更把number.post设 0、increase.post设 true配start_time/end_time划出时间窗YYYY-MM-DD格式。定时任务里反复跑同一份 config就是只下新作品的追更流水线。目录组织folderstyle: true时按作品建子目录作者重名可把author_dir改成nickname_uid直观且不会合并。download_manifest.jsonl每行一条 JSON含日期、aweme_id、标签、文件路径是后续检索的现成索引。完成通知notifications.providers支持 Bark、Telegram、Webhook企业微信/飞书/钉钉 bot 同理长任务跑完推手机不必盯着终端。也可以--serve起 REST API 服务用POST /api/v1/download提交任务、轮询 job 状态。桌面版任务中心按作者/合集列出任务的成功、失败计数与重试入口演示数据。常见问题FAQ只抓到约 20 条作品这是翻页风控的典型表现。确认browser_fallback.enabled: true且headless: false浏览器弹窗后手动完成验证不要立刻关窗。Cookie 失效重跑python -m tools.cookie_fetcher --config config.yml即可无需手动复制浏览器字段。为什么没有 transcript 文件转写只对视频生效图文不转写且要transcript.enabled: true、OPENAI_API_KEY有效、response_formats包含txt或json逐项排查。想让某个作品重新下载要同时删本地文件和数据库记录删掉Downloaded/作者名/post/*_aweme_id/再sqlite3 dy_downloader.db DELETE FROM aweme WHERE aweme_id aweme_id;。只删库不删文件不会触发重下。进度条刷屏确认progress.quiet_logs: true调试时再临时加--show-warnings或-v。怎么查下载历史sqlite3 dy_downloader.db SELECT aweme_id, title, author_name FROM aweme ORDER BY download_time DESC LIMIT 20;。边界与注意事项❗浏览器兜底目前只对post模式完整验证like/mix/music主要依赖 API 正常分页深度抓取时受风控影响更大。收藏夹模式限制多仅当前登录 Cookie 账号可用、不能与其他模式混用、不支持增量截断。直播录制是 experimentalwebcast 接口未覆盖所有场景HLS 源需 ffmpeg 后处理。依赖平台接口与签名工具通过内置的 xbogus/abogus 签名实现见 utils/xbogus.py访问抖音接口。平台更新风控或签名算法时功能可能失效据仓库文档这属于正常技术风险。合规底线内容仅用于技术研究、学习与个人数据管理尊重版权与平台规则避免高频批量请求。写在最后如果你的诉求是把抖音内容稳定、可追溯地落到本地这个下载器的功能覆盖面已经够用单链接、批量主页、增量跟更、直播留存都有对应开关。下一步建议先通读 README.zh-CN.md 的典型场景一节再对照 config.example.yml 里每个字段的注释跑通一次单视频下载然后按自己的任务类型打开对应能力。参考资料完整文档README.zh-CN.md示例配置config.example.yml架构与落盘策略PROJECT_SUMMARY.mdCLI 入口与参数cli/main.py下载器与策略实现core/Cookie 自动获取工具tools/cookie_fetcher.py测试用例验证各能力行为tests/文档设计稿docs/superpowers/specs/【免费下载链接】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),仅供参考