一份教程讲清 Cobalt 的 YouTube 多音轨下载从安装、选音轨到常见坑【免费下载链接】cobaltbest way to save what you love项目地址: https://gitcode.com/GitHub_Trending/cob/cobaltCobalt 是一款开源的在线媒体下载工具除了下载视频和音频它还能在解析 YouTube 视频时列出全部音轨、按语言挑出你指定的那一轨单独下载——电影原声和配音、多语言纪录片这类内容用它就能拿到非默认语言的音轨。快速上手先跑起来再谈原理自部署比直接调用接口更可控Cobalt 的公开实例随时可能限流或变更自己跑一个实例最省心。官方给了两条路Docker Compose推荐配置即开即用还能自动更新和原生 Node.js适合本地开发要求 Node 18 以上。用 Docker 完成第一次下载按 docs/run-an-instance.md 的步骤把 官方示例配置 复制进项目目录替换成你自己的域名然后启动docker compose up -d启动后访问 web 端默认 9001 端口粘贴视频链接在下载选项里启用音轨语言dubLang选项并填入语言代码就能拿到指定语言的音轨。只想留声音不要画面把仅音频打开即可。音轨是怎么被找到、挑出来的先拿全量流信息再做筛选Cobalt 用 youtubei.js 这个库对接 YouTube 的播放器接口拿到视频的全部流数据后每条流都带有语言、是否原始音轨is_original等字段。实现集中在 src/modules/processing/services/youtube.js逻辑大致是默认选is_original标记的原始音轨一旦请求里带了dubLang就按语言代码精确匹配language相同且带audio_track标记的流匹配不到就回退到原始音轨保证下载不会中断。音视频分离再用 ffmpeg 合成YouTube 的自适应流里高清晰度通常是纯视频流音频单独一条。Cobalt 挑好视频流和音轨后交给内置的 ffmpeg依赖 ffmpeg-static封装合成h264 格式下会优先找音视频同流的格式省一次封装合成过程走的是它的流式渲染端点/api/stream细节见 src/modules/stream/manage.js。与多音轨相关的参数一张表看懂以下取自 docs/api.md 的接口文档POST /api/json参数默认值作用dubLangfalse传入语言代码如de、ja按该语言挑音轨aFormatmp3音频容器格式best / mp3 / ogg / wav / opusisAudioOnlyfalse只下音轨不要视频画面vCodech264视频编码h264 / av1 / vp9h264 手机兼容性最好vQuality720分辨率手机 720p 足够filenamePatternclassic命名规则classic / pretty / basic / nerdy服务端环境变量同样在 docs/run-an-instance.md 有全表RATELIMIT_MAX/RATELIMIT_WINDOW控制限流强度DURATION_LIMIT是单条视频时长上限默认 10800 秒即 3 小时。三个进阶用法批量下载循环调一次接口Cobalt 没有独立的任务队列概念它的批量能力就是接口本身对每个链接发一次 POST /api/json 即可。自己写个简单脚本或表格脚本循环请求就是最直接的批量方案。音轨质量的取舍aFormat决定最终容器的编码mp3 是压过的兼容性最好wav、opus、ogg 更接近原始音质。如果目标只是放进手机听mp3 足够要存档就选无损档。需要登录才能看的内容挂 Cookie会员片、年龄受限的内容会解析失败。解决办法是在实例目录放一个cookies.json样例见 docs/examples/cookies.example.json并在环境变量里启用COOKIE_PATH。代码侧的处理逻辑在 src/modules/processing/cookie/manager.jsYouTube 还支持 OAuth 会话token 会自动续期。下不到想要的音轨先查这四处Q指定了 dubLang 却拿到默认音轨先确认这条视频本身有没有该语言的配音轨——不是所有视频都有audio_track标记的流再核对语言代码拼写两字母 ISO 代码。Cobalt 找不到时不会报错而是静默回退到原始音轨。Q提示需要登录ErrorYTLogin或年龄限制ErrorYTAgeRestrict按上一条挂上 Cookie 再试Cookie 过期后重新导出即可。Q长视频直接被拒ErrorLengthLimit默认时长上限 3 小时把DURATION_LIMIT调大后重启容器。Q直播流ErrorLiveVideo下不了这是设计如此Cobalt 不支持直播。另外 vp9 编码找不到对应流时会自动回落 h264遇到ErrorYTTryOtherCodec换个 vCodec 重试通常就好。写在最后多音轨场景下 Cobalt 的价值就在于把选哪条音轨的权力交还给你且整个过程对你透明——默认原始音轨、指定语言精确匹配、找不到就降级这套策略读一遍源码半小时就能吃透。项目地址https://gitcode.com/GitHub_Trending/cob/cobalt AGPL-3.0 协议自部署免费。【免费下载链接】cobaltbest way to save what you love项目地址: https://gitcode.com/GitHub_Trending/cob/cobalt创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考