ARTICLE DETAIL

资讯详情

深耕郑州网站建设与运营推广的一线实战洞察。

抖音音频提取实战:douyin-downloader 批量下载配置详解

抖音音频提取实战: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 是一个基于 Python 的开源抖音下载器支持无水印视频、图文、合集与原声音乐下载覆盖单条链接与创作者主页批量下载内置进度显示、失败重试与 SQLite 去重。本文以提取创作者作品的原声音频为目标带你完成环境安装、Cookie 登录、配置文件编写与进阶筛选并说明常见问题的处理方式。项目概览该工具面向已会命令行操作、想用配置文件批量整理抖音内容的用户入口是 run.py配置驱动主流程按读取配置 → 初始化 Cookie 与 API 客户端 → 解析链接类型 → 筛选作品 → 并发下载 → 写元数据与清单 → 记录数据库执行。需要预先说明2026 年 8 月起抖音风控拦截了 CLI 侧的大量单条接口目前命令行版最稳定的路径是主页发布作品批量下载个别能力合集、音乐链接、喜欢/收藏已受限下文避坑指南中有详细说明。 先看效果运行后你会得到什么以主页链接运行任务时终端会实时显示当前步骤初始化、解析链接、并发下载与每个作品的成功/失败计数。全部完成后文件按作者/作品两级目录落盘结构如下Downloaded/ ├── download_manifest.jsonl # 每行一条作品的下载清单 └── 作者名/ └── post/ └── 2024-02-07_作品标题_aweme_id/ ├── 2024-02-07_作品标题_aweme_id_music.mp3 # 原声音频 └── 2024-02-07_作品标题_aweme_id_data.json # 元数据三个要点文件名的日期前缀取自作品发布时间create_time便于按时间归档清单文件download_manifest.jsonl记录标题、标签与保存路径可直接用脚本二次加工开启数据库后作品明细与任务历史会写入dy_downloader.db实现跨次运行的去重。同一项目还提供 Douzy 桌面版共享同一套 Python 后端逻辑可粘贴链接、勾选下载项并查看任务进度 从零到首次运行四条命令跑通第一次环境要求 Python 3.9支持 Windows、macOS 与 Linux。git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader python -m pip install -r requirements.txt python -m pip install playwright python -m playwright install chromium前三条命令克隆仓库并安装依赖最后一条安装 Chromium 浏览器供 Cookie 抓取与主页浏览器兜底使用。cp config.example.yml config.yml python -m tools.cookie_fetcher --config config.yml第一条复制示例配置Windows PowerShell 用Copy-Item config.example.yml config.yml第二条会打开浏览器登录抖音登录成功后回到终端按 EnterCookie 即保存进配置文件。python run.py -c config.yml把config.yml里的link换成目标创作者的主页链接后即可运行加-v查看详细日志python run.py --help查看全部参数。⚙️ 配置速览与音频提取相关的关键项完整字段说明见 config.example.yml下表列出最常修改的几项配置项含义建议值link目标链接主页链接可用性最好一个创作者主页链接mode下载模式post为主页发布作品[post]video是否保存视频本体false只留音频music是否保存作品原声mp3truejson是否保存作品元数据 JSONtruenumber.post下载数量0表示不限0increase.post跳过已下载作品增量truethread并发下载数3rate_limit每秒最大请求数默认 22start_time/end_time日期范围筛选YYYY-MM-DD按需填写browser_fallback.enabled主页翻页受限时启用浏览器兜底true只提取音频的最小配置示例link: - https://www.douyin.com/user/SEC_UID # 换成目标创作者主页 path: ./Downloaded/ # 下载目录 mode: - post # 主页发布作品模式 video: false # 不保存视频本体 music: true # 保存原声为 mp3 json: true # 保存元数据 JSON number: post: 0 # 0 表示不限数量 increase: post: true # 跳过已下载作品 thread: 3 # 并发下载数 进阶用法三个常见批量任务如何只提取音频而不保存视频video: false与music: true组合即可任务仍走作品下载流程但只落盘xxx_music.mp3与元数据不产生视频文件。原声的获取逻辑在 music_downloader.py 中实现。如果希望文件名带上作者字段可修改filename_template如{date}_{title}_{id}但模板必须保留{id}否则会因重名互相覆盖。如何批量收集某创作者的全部作品主页链接配合number.post: 0可下载全部发布作品thread控制并发任务队列由 queue_manager.py 管理。长期收集时保持increase.post: true每次运行只拉取新增作品已下载的自动跳过。桌面版的任务列表可用于核对每次运行的进度与结果如何按日期范围与数量限制筛选start_time/end_time按作品发布时间过滤包含结束日期当天number.post限制条数两者可叠加例如只收集近三个月、每个创作者前 50 条。video_quality还控制视频码率档位original尝试原片、highest为默认最高转码档在只取音频时无需关心此项。⚠️ 避坑指南六个高频问题与处理1. 任务开始不久提示登录态失效现象任务中途报登录失效或请求被拒。原因Cookie 过期。处理重新运行python -m tools.cookie_fetcher --config config.yml交互环境下 CLI 检测到失效会自动拉起一次重新登录非交互环境需手动更新config.yml中的cookies字段。2. 单条作品、合集、音乐链接下载不了现象单条作品/合集/音乐链接任务失败。原因2026 年 8 月起抖音风控拦截了 CLI 侧的单条、合集、音乐、喜欢与收藏接口。处理改用主页链接加mode: [post]路线刷新 Cookie 或反复重试不能绕过这类风控官方 README 建议日常下载使用桌面版。3. 主页只获取到少量作品现象仅拿到第一页或几条。原因主页接口翻页受限。处理保持browser_fallback.enabled: true、headless: false在弹出的浏览器中自行完成人机验证兜底不保证成功受限于当前风控状况。4. 重复下载或删除文件后第二次运行反而跳过现象行为与预期不符。原因增量判断同时依赖数据库记录与磁盘主文件increase与redownload_missing_files两个开关相互独立。处理常规使用保持两者均为true需要强制重下时把increase.post改为false无需清空数据库。5. 下载频繁中断、重试次数多现象任务间歇性失败。原因并发或请求频率过高触发风控。处理thread降到 3、rate_limit保持 2、retry_times设为 3仍频繁失败则拆小number.post分批执行。6. 查不到某条作品的具体失败原因现象终端只显示失败计数。原因默认日志不逐条打印原因。处理加-v运行并查看download_manifest.jsonl与dy_downloader.db中记录的条目原因失败原因的文案集中在 item_reasons.py 中定义。 适合谁用内容创作者与剪辑者批量收集多个主页的原声音频作为背景音乐素材文件按日期_标题_ID自动归档。自媒体运营定期归档多个账号的发布作品增量模式每次只抓新增内容。开发者与自动化用户YAML 加 CLI 的组合便于脚本集成--serve模式还可启动 REST API 服务接收下载任务。个人数据管理SQLite 去重与下载历史download_history表方便审计已下载过哪些作品。同一后端的 Douzy 桌面版还覆盖 TikTok、YouTube 等平台适合需要跨平台收集素材的用户收尾使用建议建议先用number.post: 1到10的小任务验证登录态、目录结构与音频文件是否正常生成再放开数量长期运行保持浏览器兜底开启Cookie 定期刷新并发与请求频率保持在 3 与 2 的保守值避免触发风控。该工具定位为学习与个人数据管理下载内容请遵守版权、隐私与平台规则使用责任自担。【免费下载链接】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),仅供参考
返回列表