@neteasecloudmusicapienhanced/api 4.29.20 → 4.29.21

package/README.MD

@@ -6,11 +6,20 @@
 
 本项目为网易云音乐第三方 Node.js API，基于停更的原版 API 持续维护，支持丰富的音乐相关接口，适合自建服务、二次开发和多平台部署(如果原版诈尸, 我会及时同步 or 归档)。
 
+> [!IMPORTANT]
+>
+> ## 注意
+>
+> - 本项目是一个高度去中心化的第三方 API，其维护都由社区志愿者使用`Pull Request`完成。   
+> - 使用本项目时请务必遵守相关法律法规，遵守`MIT`协议, 尊重网易云音乐的服务条款。   
+> - 原作者项目 [Binaryify/NeteaseCloudMusicApi](https://github.com/binaryify/NeteaseCloudMusicApi) 并非完全停止维护, 你可以在 [NeteaseCloudMusicApi 的 NPMJS 页面](https://www.npmjs.com/package/NeteaseCloudMusicApi) 查看最新版本信息。   
+> - 感谢尊重和理解!
+
 ## 快速开始
 
 ### 环境要求
 
-- Node.js 14 及以上
+- Node.js 18 及以上
 - 推荐使用 pnpm 进行依赖管理
 
 ### 安装
@@ -51,31 +60,43 @@ set PORT=4000 && node app.js  # Windows
 
 本项目支持通过 Docker 一键部署，无需手动安装 Node.js 或依赖。
 
-### 1. 拉取镜像
+> 注意: 在 docker 中运行的时候, 由于使用了 request 来发请求, 所以会检查几个 proxy 相关的环境变量(如下所列), 这些环境变量 会影响到 request 的代理, 详情请参考[request 的文档](https://github.com/request/request#proxies), 如果这些环境变量 指向的代理不可用, 那么就会造成错误, 所以在使用 docker 的时候一定要注意这些环境变量. 不过, 要是你在 query 中加上了 proxy 参数, 那么环境变量会被覆盖, 就会用你通过 proxy 参数提供的代理了.
 
-从 Docker Hub 拉取最新版本镜像：
+request 相关的环境变量
 
-```bash
+1. http_proxy
+2. https_proxy
+3. HTTP_PROXY
+4. HTTPS_PROXY
+5. no_proxy
+6. NO_PROXY
+
+```shell
 docker pull moefurina/ncm-api:latest
-```
 
-或指定版本（与 package.json 中版本号一致）：
+docker run -d -p 3000:3000 --name ncm-api moefurina/ncm-api:latest
 
-```bash
-docker pull moefurina/ncm-api:4.29.0
 
-```
+// 或者
+docker run -d -p 3000:3000 moefurina/ncm-api:latest
 
-### 2. 运行容器
+// 去掉或者设置相关的环境变量
 
-```bash
-docker run -d \
-  --name ncm-api \
-  -p 3000:3000 \
-  moefurina/ncm-api:latest
+docker run -d -p 3000:3000 --name ncm-api -e http_proxy= -e https_proxy= -e no_proxy= -e HTTP_PROXY= -e HTTPS_PROXY= -e NO_PROXY= moefurina/ncm-api:latest
+
+// 或者
+docker run -d -p 3000:3000 -e http_proxy= -e https_proxy= -e no_proxy= -e HTTP_PROXY= -e HTTPS_PROXY= -e NO_PROXY= moefurina/ncm-api:latest
 ```
 
-运行后访问 http://localhost:3000 即可使用 API。
+> 以下是自行 build docker 镜像方式
+
+```shell
+$ git clone https://github.com/NeteaseCloudMusicApiEnhanced/api-enhanced && cd api-enhanced
+
+$ sudo docker build . -t ncm-api
+
+$ sudo docker run -d -p 3000:3000 ncm-api
+```
 
 ## 3. 环境变量
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@neteasecloudmusicapienhanced/api",
-  "version": "4.29.20",
-  "description": "A revival project for NeteaseCloudMusicApi Node.js Services (Half Refactor & Enhanced)|| 网易云音乐 API 备份 + 增强 || 本项目自原版v4.28.0版本后开始自行维护",
+  "version": "4.29.21",
+  "description": "全网最全的网易云音乐API接口 || A revival project for NeteaseCloudMusicApi Node.js Services (Half Refactor & Enhanced) || 网易云音乐 API 备份 + 增强 || 本项目自原版v4.28.0版本后开始自行维护",
   "scripts": {
     "dev": "nodemon app.js",
     "start": "node app.js",
@@ -67,13 +67,13 @@
   ],
   "dependencies": {
     "@neteasecloudmusicapienhanced/unblockmusic-utils": "^0.1.3",
-    "axios": "^1.13.2",
+    "axios": "^1.13.4",
     "crypto-js": "^4.2.0",
     "dotenv": "^17.2.3",
     "express": "^5.2.1",
     "express-fileupload": "^1.5.2",
     "md5": "^2.3.0",
-    "music-metadata": "^11.10.3",
+    "music-metadata": "^11.11.1",
     "node-forge": "^1.3.3",
     "pac-proxy-agent": "^7.2.0",
     "qrcode": "^1.5.4",
@@ -88,22 +88,22 @@
     "@types/express": "^5.0.6",
     "@types/express-fileupload": "^1.5.1",
     "@types/mocha": "^10.0.10",
-    "@types/node": "24.10.0",
-    "@typescript-eslint/eslint-plugin": "8.46.2",
-    "@typescript-eslint/parser": "8.46.3",
+    "@types/node": "25.0.9",
+    "@typescript-eslint/eslint-plugin": "8.46.3",
+    "@typescript-eslint/parser": "8.53.0",
     "eslint": "9.39.0",
     "eslint-config-prettier": "10.1.8",
     "eslint-plugin-html": "8.1.3",
-    "eslint-plugin-prettier": "5.5.4",
+    "eslint-plugin-prettier": "5.5.5",
     "globals": "^16.5.0",
     "husky": "9.1.7",
     "intelli-espower-loader": "1.1.0",
-    "lint-staged": "16.2.6",
+    "lint-staged": "16.2.7",
     "mocha": "11.7.5",
     "nodemon": "^3.1.11",
     "pkg": "^5.8.1",
     "power-assert": "1.6.1",
-    "prettier": "3.6.2",
+    "prettier": "3.7.4",
     "typescript": "5.9.3"
   }
 }

package/public/cloud.html

@@ -20,7 +20,6 @@
     <script src="https://fastly.jsdelivr.net/npm/axios@0.26.1/dist/axios.min.js"></script>
     <script src="https://fastly.jsdelivr.net/npm/vue"></script>
     <script>
-      const logger = require('../util/logger.js')
       const app = Vue.createApp({
         data() {
           return {
@@ -32,14 +31,14 @@
         },
         methods: {
           getData() {
-            logger.info('getdata')
+            console.info('getdata')
             const _this = this
             axios({
               url: `/user/cloud?time=${Date.now()}&cookie=${localStorage.getItem(
                 'cookie',
               )}`,
             }).then((res) => {
-              logger.info(res.data)
+              console.info(res.data)
               _this.songs = res.data.data
             })
           },
@@ -52,7 +51,7 @@
         document
           .querySelector('input[type="file"]')
           .addEventListener('change', function (e) {
-            logger.info(this.files)
+            console.info(this.files)
             let currentIndx = 0
             fileLength = this.files.length
             for (const item of this.files) {
@@ -77,15 +76,15 @@
           data: formData,
         })
           .then((res) => {
-            logger.info(`${file.name} 上传成功`)
+            console.info(`${file.name} 上传成功`)
             if (currentIndx >= fileLength) {
-              logger.info('上传完毕')
+              console.info('上传完毕')
             }
             app.getData()
           })
           .catch(async (err) => {
-            logger.info(err)
-            logger.info(fileUpdateTime)
+            console.info(err)
+            console.info(fileUpdateTime)
             fileUpdateTime[file.name]
               ? (fileUpdateTime[file.name] += 1)
               : (fileUpdateTime[file.name] = 1)

package/public/eapi_decrypt.html

@@ -8,6 +8,19 @@
   <link href="https://unpkg.com/tailwindcss@^2/dist/tailwind.min.css" rel="stylesheet">
 </head>
 
+<style>
+  .decode-result {
+    white-space: pre-wrap;
+    word-break: break-all;
+    background-color: #f0f0f0;
+    padding: 10px;
+    border-radius: 5px;
+    margin-top: 10px;
+    height: 300px;
+    overflow: auto;
+  }
+</style>
+
 <body>
   <div id="app" class="p-5 flex flex-col">
     <h1 class="text-2xl font-bold mb-5">eapi 参数和返回内容解析</h1>
@@ -23,7 +36,7 @@
     </div>
     <div>
       <p>解密结果:
-      <pre>{{ JSON.stringify(JSON.parse(result), null, 2) }}</pre>
+      <pre class="decode-result">{{ JSON.stringify(JSON.parse(result), null, 2) }}</pre>
       </p>
     </div>
 
@@ -39,7 +52,6 @@
   <script src="https://fastly.jsdelivr.net/npm/vue@3"></script>
 
   <script>
-    const logger = require('../util/logger.js')
     const app = Vue.createApp({
       data() {
         return {
@@ -62,7 +74,7 @@
               }
             })
             this.result = JSON.stringify(res.data.data)
-            logger.info(res.data);
+            console.log(res.data);
           } catch (error) {
             console.error(error)
             alert(error?.response?.data?.message || '解密失败,数据格式错误')
@@ -74,4 +86,4 @@
   </script>
 </body>
 
-</html>
+</html>

package/public/home.html

@@ -12,7 +12,6 @@
     </div>
     <script src="https://fastly.jsdelivr.net/npm/axios@0.26.1/dist/axios.min.js"></script>
     <script>
-      const logger = require('../util/logger.js')
       async function main() {
         const res = await axios({
           url: `/homepage/block/page`,
@@ -22,7 +21,7 @@
           method: 'post',
         })
         let cursor = ''
-        logger.info(res.data.data)
+        console.info(res.data.data)
         if (res.data.data.hasMore) {
           cursor = res.data.data.cursor
           const res2 = await axios({

package/public/listen_together_host.html

@@ -88,7 +88,6 @@
     </details>
   </body>
   <script>
-    const logger = require('../util/logger.js')
     PetiteVue.createApp({
       message: '请点击获取登录状态',
       account: {
@@ -140,7 +139,7 @@
             cookie: localStorage.getItem('cookie'),
           },
         })
-        logger.info(res)
+        console.info(res)
         if (res.data.code != 200) {
           this.message = '加入房间出现问题: ' + res.data.message
         } else {
@@ -153,7 +152,7 @@
               cookie: localStorage.getItem('cookie'),
             },
           })
-          logger.info(res2)
+          console.info(res2)
           const res3 = await axios({
             url: 'listentogether/sync/playlist/get',
             method: 'post',
@@ -174,7 +173,7 @@
               cookie: localStorage.getItem('cookie'),
             },
           })
-          logger.info(resa)
+          console.info(resa)
           this.playlistInfo.playlistTracks = resa.data.songs
         }
       },
@@ -186,7 +185,7 @@
             cookie: localStorage.getItem('cookie'),
           },
         })
-        logger.info(res)
+        console.info(res)
         if (res.data.code != 200) {
           this.message = '创建房间出现问题: ' + res.data.message
         } else {
@@ -201,7 +200,7 @@
               cookie: localStorage.getItem('cookie'),
             },
           })
-          logger.info(res2)
+          console.info(res2)
         }
       },
       refreshRoom: async function () {
@@ -211,7 +210,7 @@
             cookie: localStorage.getItem('cookie'),
           },
         })
-        logger.info(res)
+        console.info(res)
         if (res.data.code != 200 || !res.data.data.inRoom) {
           this.message = '房间状态获取失败, 可能退出了房间'
         } else {
@@ -227,7 +226,7 @@
             cookie: localStorage.getItem('cookie'),
           },
         })
-        logger.info(res)
+        console.info(res)
         if (res.data.code != 200 || !res.data.data.success) {
           this.message = '房间关闭失败'
         } else {
@@ -244,7 +243,7 @@
             cookie: localStorage.getItem('cookie'),
           },
         })
-        logger.info(res)
+        console.info(res)
         this.playlistInfo.playlistName = res.data.playlist.name
         this.playlistInfo.playlistTrackIds = res.data.playlist.trackIds
           .map((track) => track.id)
@@ -257,7 +256,7 @@
             cookie: localStorage.getItem('cookie'),
           },
         })
-        logger.info(resa)
+        console.info(resa)
         this.playlistInfo.playlistTracks = resa.data.songs
         if (this.roomInfo.roomId) {
           const resb = await axios({
@@ -274,7 +273,7 @@
               cookie: localStorage.getItem('cookie'),
             },
           })
-          logger.info(resb)
+          console.info(resb)
         }
       },
       gotoTrack: async function (trackId) {
@@ -317,7 +316,7 @@
             cookie: localStorage.getItem('cookie'),
           },
         })
-        logger.info(res)
+        console.info(res)
       },
     }).mount()
   </script>

package/public/qrlogin-nocookie.html

@@ -24,7 +24,7 @@
       })
       const key = res.data.data.unikey
       const res2 = await axios({
-        url: `/login/qr/create?key=${key}&qrimg=true&timestamp=${Date.now()}`,
+        url: `/login/qr/create?key=${key}&platform=web&qrimg=true&timestamp=${Date.now()}`,
       })
       document.querySelector('#qrImg').src = res2.data.data.qrimg
 

package/public/qrlogin.html

@@ -23,7 +23,7 @@
       })
       const key = res.data.data.unikey
       const res2 = await axios({
-        url: `/login/qr/create?key=${key}&qrimg=true&timestamp=${Date.now()}&ua=pc`,
+        url: `/login/qr/create?key=${key}&platform=web&qrimg=true&timestamp=${Date.now()}&ua=pc`,
       })
       document.querySelector('#qrImg').src = res2.data.data.qrimg
 

package/public/voice_upload.html

@@ -35,7 +35,6 @@
     <script src="https://fastly.jsdelivr.net/npm/axios@0.26.1/dist/axios.min.js"></script>
     <script src="https://fastly.jsdelivr.net/npm/vue"></script>
     <script>
-      const logger = require('../util/logger.js')
       Vue.createApp({
         data() {
           return {
@@ -62,7 +61,7 @@
         },
         methods: {
           submit() {
-            logger.info('submit')
+            console.info('submit')
             const file = document.querySelector('input[type=file]').files[0]
             this.upload(file)
           },
@@ -72,14 +71,14 @@
               url: `/voicelist/search?cookie=${localStorage.getItem('cookie')}`,
             })
 
-            logger.info(res.data.data)
+            console.info(res.data.data)
             this.voicelist = res.data.data.list
             this.voicelist.map(async (i) => {
               const res2 = await axios({
                 url: `/voicelist/list?voiceListId=${i.voiceListId}&limit=5`,
               })
               i.voiceListData = res2.data.data.list
-              logger.info(res2)
+              console.info(res2)
             })
           },
           upload(file) {
@@ -104,11 +103,11 @@
               .then((res) => {
                 alert(`${file.name} 上传成功`)
                 if (currentIndx >= fileLength) {
-                  logger.info('上传完毕')
+                  console.info('上传完毕')
                 }
               })
               .catch(async (err) => {
-                logger.info(err)
+                console.info(err)
               })
           },
         },

package/util/client-sign.js

@@ -9,9 +9,9 @@ class AdvancedClientSignGenerator {
     try {
       const interfaces = os.networkInterfaces()
       for (let interfaceName in interfaces) {
-        const networkInterface = interfaces[interfaceName]
-        for (let i = 0; i < networkInterface.length; i++) {
-          const alias = networkInterface[i]
+        const interfaceItem = interfaces[interfaceName]
+        for (let i = 0; i < interfaceItem.length; i++) {
+          const alias = interfaceItem[i]
           // 排除内部地址和无效地址
           if (
             alias.mac &&
@@ -166,4 +166,4 @@ class AdvancedClientSignGenerator {
   }
 }
 
-module.exports = AdvancedClientSignGenerator
+module.exports = AdvancedClientSignGenerator