@neteasecloudmusicapienhanced/api 4.29.19 → 4.29.20

package/README.MD

@@ -4,7 +4,7 @@
 
 ## 项目简介
 
-本项目为网易云音乐第三方 Node.js API，基于社区停更的原版 API 持续维护和升级，支持丰富的音乐相关接口，适合自建服务、二次开发和多平台部署(如果原版诈尸, 我会及时同步 or 归档)。
+本项目为网易云音乐第三方 Node.js API，基于停更的原版 API 持续维护，支持丰富的音乐相关接口，适合自建服务、二次开发和多平台部署(如果原版诈尸, 我会及时同步 or 归档)。
 
 ## 快速开始
 
@@ -77,7 +77,7 @@ docker run -d \
 
 运行后访问 http://localhost:3000 即可使用 API。
 
-### 3. 环境变量
+## 3. 环境变量
 
 | 变量名                     | 默认值                               | 说明                                                                           |
 | -------------------------- | ------------------------------------ | ------------------------------------------------------------------------------ |
@@ -87,7 +87,6 @@ docker run -d \
 | **ENABLE_GENERAL_UNBLOCK** | `true`                               | 是否启用全局解灰（推荐开启）。开启后所有歌曲都尝试自动解锁。                   |
 | **ENABLE_FLAC**            | `true`                               | 是否启用无损音质（FLAC）。                                                     |
 | **SELECT_MAX_BR**          | `false`                              | 启用无损音质时，是否选择最高码率音质。                                         |
-| **UNBLOCK_SOURCE**         | `pyncmd,qq,bodian,migu,kugou,kuwo`   | 音源优先级列表（多个音源以逗号分隔）。                                         |
 | **FOLLOW_SOURCE_ORDER**    | `true`                               | 是否严格按照音源列表顺序进行匹配。                                             |
 
 ---
@@ -157,15 +156,27 @@ pnpm test
 - 用户信息、歌单、动态、播放记录
 - 歌曲、专辑、歌手、MV、歌词、评论、排行榜
 - 搜索、推荐、私人 FM、签到、云盘
-- 歌曲解锁（解灰）、多音源支持（qq/bodian/kuwo/kugou/migu/pyncmd）
-  > 注意: 如果解灰出现问题, 本项目只是集成[UnblockNeteaseMusic](https://github.com/UnblockNeteaseMusic/server)的接口, 请在对应的仓库开启议题
-- 详细接口请见[在线文档](https://neteasecloudmusicapienhanced.js.org/)
+- 歌曲解锁（解灰）
 
 ## 贡献与社区
 
 - 欢迎提交 PR、Issue 参与维护
 
-## SDK 生态
+### 致谢
+
+原作者 [Binaryify/NeteaseCloudMusicApi](https://github.com/binaryify/NeteaseCloudMusicApi) 项目为本项目基础 (该项目在`npmjs`网站上仍持续维护, 但 github 仓库已不再更新)
+
+感谢大佬们为逆向eapi, weapi等加密算法所做的贡献
+
+项目参考:
+
+[trazyn/ieaseMusic](https://github.com/trazyn/ieaseMusic)
+
+[listen1/listen1_chrome_extension](https://github.com/listen1/listen1_chrome_extension)
+
+[chaunsin/netease-cloud-music](https://github.com/chaunsin/netease-cloud-music)
+
+### SDK 生态
 
 | 语言   | 作者                                        | 地址                                                                                     | 类型   |
 | ------ | ------------------------------------------- | ---------------------------------------------------------------------------------------- | ------ |
@@ -173,6 +184,13 @@ pnpm test
 | Java   | [1015770492](https://github.com/1015770492) | https://github.com/1015770492/yumbo-music-utils                                          | 第三方 |
 | Python | [盧瞳](https://github.com/2061360308)       | [NeteaseCloudMusic_PythonSDK](https://github.com/2061360308/NeteaseCloudMusic_PythonSDK) | 第三方 |
 
+
+### 依赖此项目的优秀开源项目
+
+- [imsyy/splayer](https://github.com/imsyy/splayer)
+
+- [qier2222/YesPlayMusic](https://github.com/qier222/YesPlayMusic)
+
 ## License
 
 [MIT License](https://github.com/MoeFurina/NeteaseCloudMusicApiEnhanced/blob/main/LICENSE)

package/module/song_url_match.js

@@ -6,23 +6,23 @@ const logger = require('../util/logger.js')
 
 module.exports = async (query, request) => {
   try {
-    const match = require('@unblockneteasemusic/server')
-    const source = query.source
-      ? query.source.split(',')
-      : ['pyncmd', 'bodian', 'kuwo', 'qq', 'migu', 'kugou']
-    const server = query.server ? query.server.split(',') : query.server
-    const result = await match(query.id, !server ? source : server)
+    const {
+      matchID,
+    } = require('@neteasecloudmusicapienhanced/unblockmusic-utils')
+    const result = await matchID(query.id, query.source)
     const proxy = process.env.PROXY_URL
     logger.info('开始解灰', query.id, result)
     const useProxy = process.env.ENABLE_PROXY || 'false'
-    if (result.url.includes('kuwo')) {
-      result.proxyUrl = useProxy === 'true' ? proxy + result.url : result.url
+    if (result.data.url && result.data.url.includes('kuwo')) {
+      result.proxyUrl =
+        useProxy === 'true' ? proxy + result.data.url : result.data.url
     }
     return {
       status: 200,
       body: {
         code: 200,
-        data: result,
+        data: result.data.url,
+        proxyUrl: result.proxyUrl || '',
       },
     }
   } catch (e) {

package/module/song_url_v1.js

@@ -1,13 +1,14 @@
 // 歌曲链接 - v1
 // 此版本不再采用 br 作为音质区分的标准
 // 而是采用 standard, exhigh, lossless, hires, jyeffect(高清环绕声), sky(沉浸环绕声), jymaster(超清母带) 进行音质判断
-// 当unblock为true时, 会尝试使用unblockneteasemusic进行解锁, 同时音质设置不会生效, 但仍然为必须传入参数
+// 当unblock为true时, 会尝试使用unblockmusic-utils进行解锁, 同时音质设置不会生效, 但仍然为必须传入参数
 
 const logger = require('../util/logger.js')
 const createOption = require('../util/option.js')
 module.exports = async (query, request) => {
-  const match = require('@unblockneteasemusic/server')
-  const source = ['pyncmd', 'bodian', 'kuwo', 'qq', 'migu', 'kugou']
+  const {
+    matchID,
+  } = require('@neteasecloudmusicapienhanced/unblockmusic-utils')
   require('dotenv').config()
   const data = {
     ids: '[' + query.id + ']',
@@ -16,48 +17,37 @@ module.exports = async (query, request) => {
   }
   if (query.unblock === 'true') {
     try {
-      const result = await match(query.id, source)
+      const result = await matchID(query.id, query.source)
       logger.info('Starting unblock(uses modules unblock):', query.id, result)
-      // avoid optional chaining for compatibility
-      let url
-      if (Array.isArray(result)) {
-        url = result[0] && result[0].url ? result[0].url : result[0]
-      } else {
-        url = result && result.url ? result.url : result
-      }
-      // decide proxyUrl after we resolved the actual url value
+      const useProxy = process.env.ENABLE_PROXY || 'false'
       let proxyUrl = ''
-      if (url) {
-        if (url.includes('kuwo')) {
-          const useProxy = process.env.ENABLE_PROXY || 'false'
-          if (useProxy === 'true' && process.env.PROXY_URL) {
-            proxyUrl = process.env.PROXY_URL + url
-          } else {
-            proxyUrl = url
-          }
-        }
-        return {
-          status: 200,
-          body: {
-            code: 200,
-            msg: 'Warning: you can only adjust unblock source in dotenv config, use /song/url/match instead.',
-            data: [
-              {
-                id: Number(query.id),
-                url,
-                type: 'flac',
-                level: query.level,
-                freeTrialInfo: 'null',
-                fee: 0,
-                proxyUrl: proxyUrl || '',
-              },
-            ],
-          },
-          cookie: [],
-        }
+      if (result.data.url && result.data.url.includes('kuwo')) {
+        proxyUrl =
+          useProxy === 'true' && process.env.PROXY_URL
+            ? process.env.PROXY_URL + result.data.url
+            : result.data.url
+      }
+      return {
+        status: 200,
+        body: {
+          code: 200,
+          msg: 'Warning: Customizing unblock sources is not supported on this endpoint. Please use `/song/url/match` instead.',
+          data: [
+            {
+              id: Number(query.id),
+              url: result.data.url,
+              type: 'flac',
+              level: query.level,
+              freeTrialInfo: 'null',
+              fee: 0,
+              proxyUrl: proxyUrl || '',
+            },
+          ],
+        },
+        cookie: [],
       }
     } catch (e) {
-      console.error('Error in unblockneteasemusic:', e)
+      console.error('Error in unblocking music:', e)
     }
   }
   if (data.level == 'sky') {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@neteasecloudmusicapienhanced/api",
-  "version": "4.29.19",
+  "version": "4.29.20",
   "description": "A revival project for NeteaseCloudMusicApi Node.js Services (Half Refactor & Enhanced)|| 网易云音乐 API 备份 + 增强 || 本项目自原版v4.28.0版本后开始自行维护",
   "scripts": {
     "dev": "nodemon app.js",
@@ -66,7 +66,7 @@
     "data"
   ],
   "dependencies": {
-    "@unblockneteasemusic/server": "^0.28.0",
+    "@neteasecloudmusicapienhanced/unblockmusic-utils": "^0.1.3",
     "axios": "^1.13.2",
     "crypto-js": "^4.2.0",
     "dotenv": "^17.2.3",

package/public/docs/home.md

@@ -1244,7 +1244,7 @@ tags: 歌单标签
 **必选参数 :** `id` : 音乐 id
 `level`: 播放音质等级, 分为 `standard` => `标准`,`higher` => `较高`, `exhigh`=>`极高`,
 `lossless`=>`无损`, `hires`=>`Hi-Res`, `jyeffect` => `高清环绕声`, `sky` => `沉浸环绕声`, `dolby` => `杜比全景声`, `jymaster` => `超清母带`
-`unblock`: 是否使用`UnblockNeteaseMusic`, 分为`true`和`false`
+`unblock`: 是否使用使用歌曲解锁, 分为`true`和`false`
 
 **接口地址 :** `/song/url/v1`
 
@@ -1252,8 +1252,6 @@ tags: 歌单标签
 
 说明：`杜比全景声`音质需要设备支持，不同的设备可能会返回不同码率的 url。cookie 需要传入`os=pc`保证返回正常码率的 url。
 
-注意: 如果解灰出现问题, 本项目只是集成[UnblockNeteaseMusic](https://github.com/UnblockNeteaseMusic/server)的接口, 请在对应的仓库开启议题
-
 ### 音乐是否可用
 
 说明: 调用此接口,传入歌曲 id, 可获取音乐是否可用,返回 `{ success: true, message: 'ok' }` 或者 `{ success: false, message: '亲爱的,暂无版权' }`
@@ -1268,17 +1266,15 @@ tags: 歌单标签
 
 ### 直接获取灰色歌曲链接
 
-说明 : 技术来自于 [UnblockNeteaseMusic](https://github.com/unblockneteasemusic/server) 的支持, 聚合多个音源匹配(有几率匹配不成功)
+说明 : 技术部分来自于 [UnblockNeteaseMusic](https://github.com/unblockneteasemusic/server) 的支持
 
 **必选参数 :** `id` : 音乐 id
 
-**可选参数 :** `source`: 选择要解灰的音源, 目前支持`pyncmd`, `bodian`, `kuwo`, `kugou`, `qq`, `migu`, 选择多个音源中间用`,`分隔
+**可选参数 :** `source`: 选择要解灰的音源, 不支持多音源
 
 **接口地址 :** `/song/url/match`
 
-**调用例子 :** `/song/url/match?id=1969519579` `/song/url/match?id=1969519579&source=pyncmd,bodian`
-
-注意: 如果解灰出现问题, 本项目只是集成[UnblockNeteaseMusic](https://github.com/UnblockNeteaseMusic/server)的接口, 请在对应的仓库开启议题
+**调用例子 :** `/song/url/match?id=1969519579` `/song/url/match?id=1969519579`
 
 ### 搜索
 

package/public/unblock_test.html

@@ -58,33 +58,8 @@
             <input type="number" id="songId" placeholder="请输入音乐ID" required>
         </div>
         <div class="form-group">
-            <p>选择音源：</p>
-            <div class="source-options">
-                <div class="source-option">
-                    <input type="checkbox" id="pyncmd" value="pyncmd">
-                    <label for="pyncmd">pyncmd</label>
-                </div>
-                <div class="source-option">
-                    <input type="checkbox" id="kuwo" value="kuwo">
-                    <label for="kuwo">kuwo</label>
-                </div>
-                <div class="source-option">
-                    <input type="checkbox" id="bodian" value="bodian">
-                    <label for="bodian">bodian</label>
-                </div>
-                <div class="source-option">
-                    <input type="checkbox" id="qq" value="qq">
-                    <label for="qq">qq</label>
-                </div>
-                <div class="source-option">
-                    <input type="checkbox" id="kugou" value="kugou">
-                    <label for="kugou">kugou</label>
-                </div>
-                <div class="source-option">
-                    <input type="checkbox" id="migu" value="migu">
-                    <label for="migu">migu</label>
-                </div>
-            </div>
+            <label for="sources">音源列表：</label>
+            <input type="text" id="sources" placeholder="请输入音源(非必填)">
         </div>
         <button onclick="testSong()">开始测试</button>
         <div id="result"></div>
@@ -98,14 +73,9 @@
                 return;
             }
 
-            const sources = ['pyncmd', 'kuwo', 'bodian', 'qq', 'kugou', 'migu']
-                .filter(source => document.getElementById(source).checked)
-                .join(',');
+            const sources = document.getElementById('sources').value;
+
 
-            if (!sources) {
-                alert('请至少选择一个音源');
-                return;
-            }
 
             const resultDiv = document.getElementById('result');
             resultDiv.textContent = '正在请求...';

package/server.js

@@ -254,13 +254,12 @@ async function consturctServer(moduleDefs) {
             !song.url ||
             [1, 4].includes(song.fee)
           ) {
-            const match = require('@unblockneteasemusic/server')
-            const source = process.env.UNBLOCK_SOURCE
-              ? process.env.UNBLOCK_SOURCE.split(',')
-              : ['pyncmd', 'bodian', 'kuwo', 'qq', 'migu', 'kugou']
-            logger.info('Starting unblock(uses general unblock):', source)
-            const { url } = await match(req.query.id, source)
-            song.url = url
+            const {
+              matchID,
+            } = require('@neteasecloudmusicapienhanced/unblockmusic-utils')
+            logger.info('Starting unblock(uses general unblock):', req.query.id)
+            const result = await matchID(req.query.id)
+            song.url = result.data.url
             song.freeTrialInfo = 'null'
             logger.info('Unblock success! url:', song.url)
           }