@neteasecloudmusicapienhanced/api 4.30.1 → 4.30.2

package/public/docs/logo.svg

@@ -0,0 +1,6 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24">
+    <g>
+        <path fill="none" d="M0 0h24v24H0z"/>
+        <path d="M10.421 11.375c-.294 1.028.012 2.064.784 2.653 1.061.81 2.565.3 2.874-.995.08-.337.103-.722.027-1.056-.23-1.001-.52-1.988-.792-2.996-1.33.154-2.543 1.172-2.893 2.394zm5.548-.287c.273 1.012.285 2.017-.127 3-1.128 2.69-4.721 3.14-6.573.826-1.302-1.627-1.28-3.961.06-5.734.78-1.032 1.804-1.707 3.048-2.054l.379-.104c-.084-.415-.188-.816-.243-1.224-.176-1.317.512-2.503 1.744-3.04 1.226-.535 2.708-.216 3.53.76.406.479.395 1.08-.025 1.464-.412.377-.996.346-1.435-.09-.247-.246-.51-.44-.877-.436-.525.006-.987.418-.945.937.037.468.173.93.3 1.386.022.078.216.135.338.153 1.334.197 2.504.731 3.472 1.676 2.558 2.493 2.861 6.531.672 9.44-1.529 2.032-3.61 3.168-6.127 3.409-4.621.44-8.664-2.53-9.7-7.058C2.515 10.255 4.84 5.831 8.795 4.25c.586-.234 1.143-.031 1.371.498.232.537-.019 1.086-.61 1.35-2.368 1.06-3.817 2.855-4.215 5.424-.533 3.433 1.656 6.776 5 7.72 2.723.77 5.658-.166 7.308-2.33 1.586-2.08 1.4-5.099-.427-6.873a3.979 3.979 0 0 0-1.823-1.013c.198.716.389 1.388.57 2.062z"/>
+    </g>
+</svg>

package/public/index.html

@@ -4,6 +4,7 @@
   <meta charset="UTF-8">
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
   <meta http-equiv="X-UA-Compatible" content="IE=edge">
+  <link rel="icon" href="docs/netease.png">
   <title>网易云音乐 API Enhanced</title>
   <style>
     :root {
@@ -18,20 +19,33 @@
     html, body { height: 100%; }
     body { margin: 0; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif; color: var(--fg); background: var(--bg); line-height: 1.6; }
     .container { max-width: 960px; margin: 40px auto; padding: 0 20px; }
+    @media (max-width: 480px) {
+      .container { margin: 20px auto; padding: 0 16px; }
+      header.site-header h1 { font-size: 22px; }
+      .block { padding: 16px; }
+    }
     header.site-header { margin-bottom: 24px; }
     header.site-header h1 { font-size: 28px; font-weight: 600; margin: 0; }
     .badge { display: inline-block; margin-left: 8px; padding: 4px 10px; border: 1px solid var(--border); border-radius: 12px; font-size: 12px; color: var(--muted); }
     .sub { margin-top: 8px; color: var(--muted); font-size: 14px; }
     .block { background: var(--panel); border: 1px solid var(--border); border-radius: 12px; padding: 20px; margin-bottom: 16px; box-shadow: 0 2px 8px rgba(0, 0, 0, 0.05); }
     .block h2 { margin: 0 0 12px; font-size: 18px; font-weight: 600; }
-    .kvs { display: grid; grid-template-columns: 140px 1fr; gap: 8px 16px; align-items: center; }
-    .kvs div:first-child { color: var(--muted); }
+    .kvs { display: grid; grid-template-columns: 100px 1fr; gap: 8px 12px; align-items: start; }
+    .kvs div:first-child { color: var(--muted); flex-shrink: 0; }
+    .kvs div:last-child { word-break: break-all; overflow-wrap: anywhere; min-width: 0; overflow: hidden; }
+    @media (max-width: 480px) {
+      .kvs { grid-template-columns: 1fr; gap: 4px 12px; }
+      .kvs div:first-child { font-weight: 500; }
+    }
     ul.links { list-style: none; padding: 0; margin: 0; }
     ul.links li { margin: 8px 0; }
     ul.links a { color: var(--fg); text-decoration: none; border-bottom: 1px dotted var(--border); transition: all 0.2s ease; }
     ul.links a:hover { color: var(--accent); border-bottom-color: var(--accent); }
-    pre { margin: 0; background: #f9f9f9; border: 1px solid var(--border); border-radius: 6px; padding: 12px; overflow: auto; }
+    pre { margin: 0; background: #f9f9f9; border: 1px solid var(--border); border-radius: 6px; padding: 12px; overflow-x: auto; white-space: pre-wrap; word-break: break-all; }
     code { font-family: 'Courier New', monospace; font-size: 13px; }
+    @media (max-width: 480px) {
+      code { font-size: 12px; }
+    }
     footer.site-footer { margin-top: 24px; padding-top: 12px; border-top: 1px solid var(--border); color: var(--muted); text-align: center; }
     footer.site-footer a { color: var(--fg); text-decoration: none; transition: color 0.2s ease; }
     footer.site-footer a:hover { color: var(--accent); }
@@ -71,7 +85,18 @@
       <h2>调试部分</h2>
       <pre><code>curl -s {origin}/inner/version
 curl -s {origin}/search?keywords=网易云</code></pre>
-      <p style="margin-top:10px"> · <a href="/api.html">交互式调试</a> · <a href="/qrlogin.html">二维码登录示例</a> · <a href="/unblock_test.html">解灰测试</a></p> · <a href="/audio_match_demo/index.html">听歌识曲 Demo</a></p> · <a href="/cloud.html">云盘上传</a></p> · <a href="/playlist_import.html">歌单导入</a></p> · <a href="/eapi_decrypt.html">EAPI 解密</p> · <a href="/listen_together_host.html">一起听示例</p> · <a href="/playlist_cover_update.html">更新歌单封面示例</p> · <a href="/avatar_update.html">头像更新示例</p>
+      <div style="margin-top:10px; line-height:2;">
+        <a href="/api.html">交互式调试</a> ·
+        <a href="/qrlogin.html">二维码登录示例</a> ·
+        <a href="/unblock_test.html">解灰测试</a> ·
+        <a href="/audio_match_demo/index.html">听歌识曲 Demo</a> ·
+        <a href="/cloud.html">云盘上传</a> ·
+        <a href="/playlist_import.html">歌单导入</a> ·
+        <a href="/eapi_decrypt.html">EAPI 解密</a> ·
+        <a href="/listen_together_host.html">一起听示例</a> ·
+        <a href="/playlist_cover_update.html">更新歌单封面示例</a> ·
+        <a href="/avatar_update.html">头像更新示例</a>
+      </div>
     </section>
 
     <footer class="site-footer">

package/server.js

@@ -178,10 +178,25 @@ async function consturctServer(moduleDefs) {
   /**
    * Body Parser and File Upload
    */
-  app.use(express.json({ limit: '50mb' }))
-  app.use(express.urlencoded({ extended: false, limit: '50mb' }))
-
-  app.use(fileUpload())
+  const MAX_UPLOAD_SIZE_MB = 500
+  const MAX_UPLOAD_SIZE_BYTES = MAX_UPLOAD_SIZE_MB * 1024 * 1024
+
+  app.use(express.json({ limit: `${MAX_UPLOAD_SIZE_MB}mb` }))
+  app.use(
+    express.urlencoded({ extended: false, limit: `${MAX_UPLOAD_SIZE_MB}mb` }),
+  )
+
+  app.use(
+    fileUpload({
+      limits: {
+        fileSize: MAX_UPLOAD_SIZE_BYTES,
+      },
+      useTempFiles: true,
+      tempFileDir: require('os').tmpdir(),
+      abortOnLimit: true,
+      parseNested: true,
+    }),
+  )
 
   /**
    * Cache
@@ -227,25 +242,30 @@ async function consturctServer(moduleDefs) {
         const moduleResponse = await moduleDef.module(query, (...params) => {
           // 参数注入客户端IP
           const obj = [...params]
-          let ip = req.ip
+          const options = obj[2] || {}
+          if (!options.randomCNIP) {
+            let ip = req.ip
 
-          if (ip.substring(0, 7) == '::ffff:') {
-            ip = ip.substring(7)
-          }
-          if (ip == '::1') {
-            ip = global.cnIp
-          }
-          // logger.info('Requested from ip:', ip)
-          obj[3] = {
-            ...obj[3],
-            ip,
+            if (ip.substring(0, 7) == '::ffff:') {
+              ip = ip.substring(7)
+            }
+            if (ip == '::1') {
+              ip = global.cnIp
+            }
+            // logger.info('Requested from ip:', ip)
+            obj[2] = {
+              ...options,
+              ip,
+            }
           }
+
           return request(...obj)
         })
         logger.info(`Request Success: ${decode(req.originalUrl)}`)
 
+        // 夹带私货部分：如果开启了通用解锁，并且是获取歌曲URL的接口，则尝试解锁（如果需要的话）ヾ(≧▽≦*)o
         if (
-          (req.baseUrl === '/song/url/v1' || req.baseUrl === '/song/url') &&
+          req.baseUrl === '/song/url/v1' &&
           process.env.ENABLE_GENERAL_UNBLOCK === 'true'
         ) {
           const song = moduleResponse.body.data[0]
@@ -260,7 +280,7 @@ async function consturctServer(moduleDefs) {
             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'
+            song.freeTrialInfo = null
             logger.info('Unblock success! url:', song.url)
           }
           if (song.url && song.url.includes('kuwo')) {

package/util/fileHelper.js

@@ -0,0 +1,88 @@
+const fs = require('fs')
+const crypto = require('crypto')
+const logger = require('./logger')
+
+function isTempFile(file) {
+  return !!(file && file.tempFilePath)
+}
+
+async function getFileSize(file) {
+  if (isTempFile(file)) {
+    const stats = await fs.promises.stat(file.tempFilePath)
+    return stats.size
+  }
+  return file.data ? file.data.byteLength : file.size || 0
+}
+
+async function getFileMd5(file) {
+  if (file.md5) {
+    return file.md5
+  }
+
+  if (isTempFile(file)) {
+    return new Promise((resolve, reject) => {
+      const hash = crypto.createHash('md5')
+      const stream = fs.createReadStream(file.tempFilePath)
+      stream.on('data', (chunk) => hash.update(chunk))
+      stream.on('end', () => resolve(hash.digest('hex')))
+      stream.on('error', reject)
+    })
+  }
+
+  if (file.data) {
+    return crypto.createHash('md5').update(file.data).digest('hex')
+  }
+
+  throw new Error('无法计算文件MD5: 缺少文件数据')
+}
+
+function getUploadData(file) {
+  if (isTempFile(file)) {
+    return fs.createReadStream(file.tempFilePath)
+  }
+  return file.data
+}
+
+async function cleanupTempFile(filePath) {
+  if (!filePath) return
+  try {
+    await fs.promises.unlink(filePath)
+  } catch (e) {
+    logger.info('临时文件清理失败:', e.message)
+  }
+}
+
+async function readFileChunk(filePath, offset, length) {
+  const fd = await fs.promises.open(filePath, 'r')
+  const buffer = Buffer.alloc(length)
+  await fd.read(buffer, 0, length, offset)
+  await fd.close()
+  return buffer
+}
+
+function getFileExtension(filename) {
+  if (!filename) return 'mp3'
+  if (filename.includes('.')) {
+    return filename.split('.').pop().toLowerCase()
+  }
+  return 'mp3'
+}
+
+function sanitizeFilename(filename) {
+  if (!filename) return 'unknown'
+  return filename
+    .replace(/\.[^.]+$/, '')
+    .replace(/\s/g, '')
+    .replace(/\./g, '_')
+}
+
+module.exports = {
+  isTempFile,
+  getFileSize,
+  getFileMd5,
+  getUploadData,
+  cleanupTempFile,
+  readFileChunk,
+  getFileExtension,
+  sanitizeFilename,
+}

package/util/index.js

@@ -1,36 +1,8 @@
 const logger = require('./logger')
-// 预先定义常量和函数引用
-// 中国 IP 段（来源：data/ChineseIPGenerate.csv）
-const chinaIPRangesRaw = [
-  // 开始IP, 结束IP, IP个数, 位置
-  ['1.0.1.0', '1.0.3.255', 768, '福州'],
-  ['1.0.8.0', '1.0.15.255', 2048, '广州'],
-  ['1.0.32.0', '1.0.63.255', 8192, '广州'],
-  ['1.1.0.0', '1.1.0.255', 256, '福州'],
-  ['1.1.2.0', '1.1.63.255', 15872, '广州'],
-  ['1.2.0.0', '1.2.2.255', 768, '北京'],
-  ['1.2.4.0', '1.2.127.255', 31744, '广州'],
-  ['1.3.0.0', '1.3.255.255', 65536, '广州'],
-  ['1.4.1.0', '1.4.127.255', 32512, '广州'],
-  ['1.8.0.0', '1.8.255.255', 65536, '北京'],
-  ['1.10.0.0', '1.10.9.255', 2560, '福州'],
-  ['1.10.11.0', '1.10.127.255', 29952, '广州'],
-  ['1.12.0.0', '1.15.255.255', 262144, '上海'],
-  ['1.18.128.0', '1.18.128.255', 256, '北京'],
-  ['1.24.0.0', '1.31.255.255', 524288, '赤峰'],
-  ['1.45.0.0', '1.45.255.255', 65536, '北京'],
-  ['1.48.0.0', '1.51.255.255', 262144, '济南'],
-  ['1.56.0.0', '1.63.255.255', 524288, '伊春'],
-  ['1.68.0.0', '1.71.255.255', 262144, '忻州'],
-  ['1.80.0.0', '1.95.255.255', 1048576, '北京'],
-  ['1.116.0.0', '1.117.255.255', 131072, '上海'],
-  ['1.119.0.0', '1.119.255.255', 65536, '北京'],
-  ['1.180.0.0', '1.185.255.255', 393216, '桂林'],
-  ['1.188.0.0', '1.199.255.255', 786432, '洛阳'],
-  ['1.202.0.0', '1.207.255.255', 393216, '铜仁'],
-]
-
-// 将原始字符串段转换为数值段并计算总数（在模块初始化时完成一次）
+const fs = require('fs')
+const path = require('path')
+
+// IP地址转换函数
 function ipToInt(ip) {
   const parts = ip.split('.').map(Number)
   const a = (parts[0] << 24) >>> 0
@@ -49,20 +21,56 @@ function intToIp(int) {
   ].join('.')
 }
 
-const chinaIPRanges = (function buildRanges() {
-  const arr = []
-  let total = 0
-  for (let i = 0; i < chinaIPRangesRaw.length; i++) {
-    const r = chinaIPRangesRaw[i]
-    const start = ipToInt(r[0])
-    const end = ipToInt(r[1])
-    const count = r[2] || end - start + 1
-    arr.push({ start, end, count, location: r[3] || '' })
-    total += count
+// 解析CIDR格式的IP段
+function parseCIDR(cidr) {
+  const [ipStr, prefixLengthStr] = cidr.split('/')
+  const prefixLength = parseInt(prefixLengthStr, 10)
+
+  const ipInt = ipToInt(ipStr)
+  const mask = (0xffffffff << (32 - prefixLength)) >>> 0
+  const start = (ipInt & mask) >>> 0
+  const end = (start | (~mask >>> 0)) >>> 0
+  const count = end - start + 1
+
+  return { start, end, count, cidr }
+}
+
+// 从china_ip_ranges.txt加载中国IP段（CIDR格式）
+const chinaIPRanges = (function loadChinaIPRanges() {
+  try {
+    const filePath = path.join(__dirname, '../data/china_ip_ranges.txt')
+    const content = fs.readFileSync(filePath, 'utf-8')
+    const lines = content
+      .split('\n')
+      .filter((line) => line.trim() && !line.startsWith('#'))
+
+    const arr = []
+    let total = 0
+
+    for (let i = 0; i < lines.length; i++) {
+      const line = lines[i].trim()
+      if (!line) continue
+
+      const range = parseCIDR(line)
+      arr.push(range)
+      total += range.count
+    }
+
+    // 按IP段大小排序，提高随机选择效率
+    arr.sort((a, b) => b.count - a.count)
+
+    // attach total for convenience
+    arr.totalCount = total
+
+    logger.info(
+      `Loaded ${arr.length} Chinese IP ranges from china_ip_ranges.txt, total ${total} IPs`,
+    )
+    return arr
+  } catch (error) {
+    logger.error('Failed to load china_ip_ranges.txt:', error.message)
+    // 返回空数组，generateRandomChineseIP会使用兜底逻辑
+    return { totalCount: 0 }
   }
-  // attach total for convenience
-  arr.totalCount = total
-  return arr
 })()
 const floor = Math.floor
 const random = Math.random
@@ -144,16 +152,11 @@ module.exports = {
     // 如果没有选中（理论上不应该发生），回退到最后一个段
     if (!chosen) chosen = chinaIPRanges[chinaIPRanges.length - 1]
 
-    // 在段内随机生成一个 IP（使用段真实的数值范围，而非 csv 中的 count）
+    // 在段内随机生成一个 IP（使用段真实的数值范围）
     const segSize = chosen.end - chosen.start + 1
     const ipInt = chosen.start + Math.floor(random() * segSize)
     const ip = intToIp(ipInt)
-    logger.info(
-      'Generated Random Chinese IP:',
-      ip,
-      'location:',
-      chosen.location,
-    )
+    logger.info('Generated Random Chinese IP:', ip, 'from CIDR:', chosen.cidr)
     return ip
   },
   // 生成chainId的函数

package/data/ChineseIPGenerate.csv

@@ -1,26 +0,0 @@
-开始IP,结束IP,IP个数,位置
-1.0.1.0 ,1.0.3.255 ,768,福州
-1.0.8.0 ,1.0.15.255 ,2048,广州
-1.0.32.0 ,1.0.63.255 ,8192,广州
-1.1.0.0 ,1.1.0.255 ,256,福州
-1.1.2.0 ,1.1.63.255 ,15872,广州
-1.2.0.0 ,1.2.2.255 ,768,北京
-1.2.4.0 ,1.2.127.255 ,31744,广州
-1.3.0.0 ,1.3.255.255 ,65536,广州
-1.4.1.0 ,1.4.127.255 ,32512,广州
-1.8.0.0 ,1.8.255.255 ,65536,北京
-1.10.0.0 ,1.10.9.255 ,2560,福州
-1.10.11.0 ,1.10.127.255 ,29952,广州
-1.12.0.0 ,1.15.255.255 ,262144,上海
-1.18.128.0 ,1.18.128.255 ,256,北京
-1.24.0.0 ,1.31.255.255 ,524288,赤峰
-1.45.0.0 ,1.45.255.255 ,65536,北京
-1.48.0.0 ,1.51.255.255 ,262144,济南
-1.56.0.0 ,1.63.255.255 ,524288,伊春
-1.68.0.0 ,1.71.255.255 ,262144,忻州
-1.80.0.0 ,1.95.255.255 ,1048576,北京
-1.116.0.0 ,1.117.255.255 ,131072,上海
-1.119.0.0 ,1.119.255.255 ,65536,北京
-1.180.0.0 ,1.185.255.255 ,393216,桂林
-1.188.0.0 ,1.199.255.255 ,786432,洛阳
-1.202.0.0 ,1.207.255.255 ,393216,铜仁