UnblockNeteaseMusic 原理解析与音源路由

技术栈

AlgerMusicPlayer 的灰色解析能力来自社区知名开源项目 @unblockneteasemusic/server。这是一个 Node.js 服务，AlgerMusicPlayer 本地化集成了它，不需要用户另外部署。

工作原理

用户点击灰色歌曲播放
    ↓
AlgerMusicPlayer 检测到网易云返回 403（禁止访问）
    ↓
转发请求到本地 UnblockNeteaseMusic 服务
    ↓
UnblockNeteaseMusic 用歌曲名/歌手名去第三方音源搜索
    ↓
从音源（酷我/QQ/酷狗/百度/YouTube/B站）获取可播放的音频流 URL
    ↓
返回音频流给 AlgerMusicPlayer 播放

接入的音源

UnblockNeteaseMusic 接入了多个公开音源服务：

• 酷我音乐（kw）
• QQ 音乐（qq）
• 酷狗音乐（kg）
• 百度音乐（bd）
• YouTube（yt）
• B 站（bili）

不同歌曲在不同音源上的覆盖度不同，有些歌只在 QQ 有、有些只在酷我有。

自动路由策略

AlgerMusicPlayer v5.1.0 优化了音源解析策略：

1. 默认自动尝试多个音源，按优先级匹配
2. 如果某个音源超时或无结果，自动换下一个
3. 找到第一个可用的音频流就播放
4. 记录成功的音源，下次同首歌直接用（缓存加速）

音质变化

灰色解析拿到的音频流不一定是网易云 VIP 的无损音质。取决于第三方音源的资源：

• 音源 A 可能提供 128kbps mp3
• 音源 B 可能提供 320kbps mp3 或 FLAC
• 这是音源本身的限制，AlgerMusicPlayer 无法改变

稳定性问题

灰色解析依赖第三方音源的可用性，以下情况可能失败：

• 音源网站自身宕机或限流
• 歌曲在所有音源上都搜不到（太冷门）
• 网络环境不稳定（公司/校园网络屏蔽）

合规提醒

UnblockNeteaseMusic 的开发者声明「本项目仅供学习交流使用，请勿用于商业用途」。AlgerMusicPlayer 同样遵循此声明。如果你在灰色解析方面有持续需求，最合规的方式还是在网易云买 VIP。