- 多音源支持 - 内置多个音源模块,并发请求(最多 7 个),命中即取消其余;单模块超时默认 5s,最坏延迟 ≈ 超时预算
- RESTful API - 标准 HTTP 接口,易于集成
- 模块化设计 - 可作为独立服务或 npm 包使用
- 简单部署 - 支持 Vercel 一键部署
git clone https://github.com/NeteaseCloudMusicApiEnhanced/UnblockNeteaseMusic-utils.git
cd UnblockNeteaseMusic-utils
# 安装依赖
pnpm install # 推荐
# 或
npm installnpx @neteasecloudmusicapienhanced/unblockmusic-utils# 使用默认端口 3000
npm run start
pnpm start
# 指定端口
npx . --port 8080
PORT=8080 npm run start
# 显示帮助信息
npx . --helpnpm run dev # 使用 nodemon 自动重启项目已配置 vercel.json,可以直接推送到 Vercel 部署:
vercel deploycurl "http://localhost:3000/match?id=123456"
curl "http://localhost:3000/match?id=123456&source=unm"curl -X POST http://localhost:3000/match \
-H "Content-Type: application/json" \
-d '{"id": "123456", "source": "unm"}'请求参数:
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
id |
string | ✅ | 网易云音乐歌曲 ID |
source |
string | ❌ | 指定音源模块(不指定则自动选择) |
响应示例:
{
"code": 200,
"data": {
"url": "https://example.com/music.mp3"
}
}GET /inner/modules响应:
{
"code": 200,
"data": {
"modules": ["baka", "gdmusic", "msls", "qijieya", "unm"]
}
}GET /inner/version响应:
{
"code": 200,
"data": {
"version": "0.2.0"
}
}const { matchID } = require('@neteasecloudmusicapienhanced/unblockmusic-utils');
// 匹配歌曲(自动选择音源)
const result = await matchID('123456');
// 指定音源
const result = await matchID('123456', 'unm');
console.log(result);
// { code: 200, data: { url: "..." } }| 变量 | 默认值 | 说明 |
|---|---|---|
PORT |
3000 | 服务监听端口 |
NODE_ENV |
- | 运行环境(production/development) |
UNBLOCK_MODULE_TIMEOUT_MS |
5000 | 单个音源模块的超时(毫秒,范围 100~30000,可用 .env 覆盖)。所有模块同时发起请求(最多并发 7 个),命中即取消其余请求;最坏延迟 ≈ 该超时预算(高优先级源挂起时会占满预算),而不是各模块耗时之和 |
--port, -p <端口号> 指定服务器端口
--help, -h 显示帮助信息MIT License - 详见 LICENSE 文件
欢迎提交 Issue 和 Pull Request!
- NeteaseCloudMusicApiEnhanced - 增强版网易云音乐 API
- UnblockNeteaseMusic - 网易云音乐解锁核心库
Made with ❤️ by NeteaseCloudMusicApiEnhanced