抖音音乐批量下载实战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手上有200条视频要提取原声做BGM素材逐条下载视频再用第三方工具剪音轨至少要耗掉一整个下午。douyin-downloader 是一个免费开源的抖音批量下载工具它能直接从视频里导出原声音频也支持按作者主页批量抓取并自带并发调度、限速和 SQLite本地轻量数据库去重。它替代了什么逐条下载再剪音轨 → 配置开关直接产出原声旧流程是打开每条链接、下载完整视频再用 ffmpeg 或第三方软件抽音轨。douyin-downloader 只需在配置里打开music: true每个作品就会自动保存..._music.mp3原声文件如果只要音频把video: false关掉视频本体即可。手动复制 Cookie → 一条命令自动获取旧方式要打开浏览器开发者工具把 cookie 字符串逐个复制进脚本。项目提供 tools/cookie_fetcher.py自动拉起浏览器完成登录Cookie登录凭证即浏览器里的一段身份字符串写回配置文件全程不用手抄。手动去重和整理目录 → 目录规范加历史库几百个文件人工整理极易出错。工具按作者/模式/作品三级目录存放文件名内嵌 aweme_id作品唯一ID避免重名覆盖二次运行时由increase增量开关自动跳过本地已存在的作品。从 clone 到跑通第一条命令环境准备git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader # 克隆仓库 cd douyin-downloader # 进入项目目录 pip install -r requirements.txt # 安装运行时依赖 pip install playwright # 自动获取Cookie需要的浏览器库 python -m playwright install chromium # 下载配套无头浏览器要求 Python 3.8macOS、Linux、Windows 均可运行。Cookie 怎么配抖音接口要求登录态没有 Cookie 拿不到作品列表和视频源。推荐方式自动获取python -m tools.cookie_fetcher --config config.yml浏览器弹出后手动登录抖音回到终端按回车Cookie 自动写入config.yml。手动备选在抖音网页版开发者工具里复制ttwid、odin_tt等值粘贴到配置文件底部cookies字段。最小配置长什么样把config.example.yml复制为config.yml只保留必填项link: - https://www.douyin.com/user/MS4wLjABAAAA6O7EZyfDRYXxJrUTpf91K3tmB4rBROkAw-nYMfld8ss path: ./Downloaded/ video: false music: true mode: - post number: post: 0 thread: 3number.post: 0表示不限量thread: 3是并发任务数。执行与预期输出python run.py -c config.yml跑完后Downloaded/{作者名}/post/下每个作品一个独立目录命名形如2024-02-07_标题_aweme_id内含..._music.mp3和..._data.json元数据根目录还有download_manifest.jsonl和 SQLite 历史库dy_downloader.db。同一后端构建的任务工作区粘贴链接并查看下载状态核心机制速览并发怎么控制thread决定同时跑几个下载任务实现是一个信号量限制同时执行数量的闸门包住异步任务池单个任务失败会记录为异常但不拖垮整批。这样百条作品的耗时取决于最慢的一条而不是串行累加。见 control/queue_manager.py。限速和重试怎么配合每次 API 请求前都要过RateLimiter令牌桶按固定速率放行请求的机制默认 2 请求/秒并叠加随机抖动避免请求集中在同一时刻触发风控。失败任务按 1s、2s、5s 指数退避重试次数由retry_times控制默认 3 次。限速保稳定、重试保成功率两层都在 control/rate_limiter.py 附近可以看到。去重和增量靠什么判断跳过判定是磁盘文件 数据库记录双重检查磁盘上主文件存在且非空就跳过文件缺失时默认重下redownload_missing_files: true。这避免了数据库里显示已下载、本地却没有文件的尴尬状态。历史库封装在 storage/database.py。同后端任务中心可核对成功数并对失败项单独重试按场景选配置单条作品抽原声偶尔下载一两条 BGM复制作品链接、关视频开音频即可link: - https://www.douyin.com/video/7604129988555574538 path: ./Downloaded/ video: false music: true json: true关键差异是video: false只落盘音频和元数据不保存几百 MB 的视频本体。作者原声批量采集需要完整收集某位创作者作品原声时开全量爬取并压低并发link: - https://www.douyin.com/user/MS4wLjABAAAA6O7EZyfDRYXxJrUTpf91K3tmB4rBROkAw-nYMfld8ss path: ./Downloaded/ video: false music: true mode: - post number: post: 0 thread: 3 rate_limit: 2关键点number.post: 0全量抓取thread: 3配合rate_limit: 2控制在 2 请求/秒以内速度和风控风险折中。定时增量跑放在 crontab 或计划任务里周期执行时靠增量模式只取新作品link: - https://www.douyin.com/user/MS4wLjABAAAA6O7EZyfDRYXxJrUTpf91K3tmB4rBROkAw-nYMfld8ss path: ./Downloaded/ video: false music: true mode: - post increase: post: true start_time: 2026-09-01关键差异increase.post: true跳过磁盘上已有的作品重复运行只追加新内容start_time进一步圈定时间窗口。排错速查问题现象可能原因处理动作只拉到约20条分页被风控browser_fallback置 true手动过验证下载大量失败Cookie 过期重跑tools.cookie_fetcher缺少音频文件未开音乐开关配置改为music: true超时多、进度慢速率或并发过高调低thread与rate_limit结语200条原声的提取从一下午压缩到一次批量运行。下一步clone 仓库 → 跑通第一条命令 → 按场景改music和thread。【免费下载链接】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），仅供参考