抖音下载器支持抖音视频、图集与音乐的开源批量下载工具完整指南【免费下载链接】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抖音下载器是一款开源的抖音下载工具覆盖单个作品与作者主页两种粒度可批量获取视频、图集、合集和音乐原声。它最突出的差异点是磁盘级增量去重加上翻页风控的浏览器自动兜底长周期采集任务随时可中断重启被截断的翻页也能自动恢复。 项目速览定位MIT 协议的开源抖音批量下载工具完全免费无隐藏费用技术栈Python 3.8asyncio 与 aiohttp 异步下载SQLite 记录历史Playwright 可选运行方式一份config.yml加一条python run.py -c config.yml即可仓库自带 Dockerfile形态命令行 CLI 为主桌面版 Douzy 复用同一套后端内测中覆盖视频、图文、合集、音乐、收藏夹、直播录制另含热搜榜与关键词搜索能力矩阵按内容类型看获取方式与常见的按下载模式讲法不同这里按内容类型组织把单个直取、批量来源、附加产出三条线并列内容类型单条获取直链 / 短链批量获取来源可选附加产物视频/video/{aweme_id}、v.douyin.com短链post抓作者发布、like抓作者点赞评论 JSON、语音转写、封面/音乐/头像图文图集/note/、/gallery/直链同上图文与作品混合翻页同视频转写不适用于图文合集/collection/、/mix/直链mix抓作者合集collectmix抓收藏的合集需登录—音乐原声/music/{id}直链优先直取音频music抓作者使用过的音乐—收藏夹不适用collect抓收藏夹作品仅限登录 Cookie 对应的账号且须单独运行—直播live.douyin.com/{room_id}不适用FLV/HLS 录制断流时保留已录数据 最简启动路径git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt python run.py -c config.yml首次运行前做两件事把仓库自带的 config.example.yml 复制为config.yml再用一行内联命令python -m tools.cookie_fetcher --config config.yml获取 Cookie浏览器弹出后登录抖音回到终端按回车即可写回配置。需要浏览器兜底功能时再补装playwright及其 chromium。⚙️ 配置字段详解与最小可用配置字段默认值作用link必填下载链接支持多条混排path./Downloaded/落地目录mode[post]运行模式登录态下可单独用collect/collectmixnumber.*0各模式数量上限0 表示不限thread5并发下载线程数retry_times3失败重试次数退避间隔 1s/2s/5sincrease.*true增量开关磁盘上已有主媒体则跳过start_time/end_time空时间过滤格式YYYY-MM-DDvideo_qualityhighest画质档位original/highest/指定分辨率缺档自动降级databasetrue启用 SQLite 历史与去重记录progress.quiet_logstrue进度阶段静默日志避免刷屏browser_fallback.enabledtrue翻页受限时启动浏览器兜底comments.enabled/transcript.enabledfalse按作品采集评论、语音转文字最小可用示例8 行内跑通link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx path: ./Downloaded/ mode: [post, mix] number: {post: 50, mix: 0} thread: 5 increase: {post: true} database: true 典型用法三个高频场景场景一按时间窗口归档某位作者目标只保留某创作者特定季度发布的内容而不是全量抓取。关键配置点设置start_time/end_time主页post翻页内置时间边界状态机一旦确认越过起始日期就提前停止翻页不再空跑剩余页。预期结果落盘的只有窗口内作品终端提示已到达起始日期提前结束翻页请求量显著下降。场景二关注列表的每日增量同步目标长期跟踪一批创作者每天只补新内容。关键配置点各模式increase保持truenotifications打开并配置 Bark 或 Telegram 渠道。预期结果磁盘已存在主媒体的作品直接跳过仅新作品参与下载任务结束即收到推送。桌面版 Douzy 的关注同步列表可以直接从列表页触发同类批量任务见上方第二张截图。场景三为素材库批量采集评论与转写目标建一个带文字层、可检索的素材库而不是只有媒体文件。关键配置点comments.enabled: true并设max_commentstranscript.enabled: trueAPI Key 建议走环境变量OPENAI_API_KEY。预期结果媒体旁自动生成*_comments.json与.transcript.txt/.transcript.json每行的日期、标签、文件路径会追加写入download_manifest.jsonl方便二次检索。️ 工程化设计与可靠性动机长任务常中断重跑代价高 → 实现跳过判断以磁盘主媒体是否存在为准见 core/downloader_base.pySQLite 只记录历史不参与跳过决策跨post/like/mix模式同一aweme_id也不会下载两次。动机网络抖动与接口限流 → 实现指数退避重试1s/2s/5s叠加默认 2 req/s 的限速队列约束全局并发见 control/rate_limiter.py单条失败不拖垮整批任务。动机翻页被风控截断 → 实现API 截断时自动拉起浏览器滚动续采headless: false下可人工完成滑块验证主页时间边界判断独立封装在 core/user_modes/post_time_boundary.py异常数据只降级回全量遍历不会误停。动机半成品文件污染归档 → 实现下载完成做 Content-Length 比对不完整文件自动清理后重试避免留下损坏的 mp4。动机模块边界清晰便于维护 → 实现core/承载下载主流程与 URL 解析storage/负责文件与数据库auth/管理 Cookie 与 tokencontrol/收口限速重试并发config/统一配置加载优先级命令行 环境变量 配置文件 默认值。常见问题Q翻页被风控截断只能抓到前几页怎么办确认browser_fallback.enabled: true且headless: false在弹出的浏览器中完成验证并保留窗口至翻页结束。浏览器兜底目前完整覆盖post模式like/mix/music仍依赖 API 翻页遇到截断可换时段重试或配置proxy。Q删了文件下次运行却不重下或反之增量判定是磁盘主媒体 数据库记录双重检查默认redownload_missing_files: true文件缺失会重下改为false时数据库有有效记录则继续跳过。强制重下需同时清理本地目录与对应的 SQLite 记录只删库不删文件不会触发重下。QCookie 过期提示请先登录如何处理重新执行python -m tools.cookie_fetcher --config config.yml即可CLI 检测到登录态失效状态码 2483时会自动打开浏览器重新登录并在完成后对原任务重试一次。项目现状仓库处于活跃维护状态测试与静态检查跑在 CI 中桌面版 Douzy 与 CLI 共享同一套后端。近期改动集中在按作品发布时间命名文件、独立的download_manifest.jsonl下载清单、标签提取以及主页翻页的时间边界提前停止后续方向包括把浏览器兜底扩展到更多模式以及为清单增加检索与归档能力。按上文的最小配置克隆仓库跑一次约十分钟可以完成第一批批量下载。若希望深入参与tests/下的用例是最好的阅读入口。请仅将下载内容用于个人学习或已取得授权的场景并尊重创作者的版权与平台规则。【免费下载链接】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），仅供参考