🔍 A revival project for NeteaseCloudMusicApi Node.js Services (Half Refactor & Enhanced)
100K+
本项目为网易云音乐第三方 Node.js API，基于停更的原版 API 持续维护，支持丰富的音乐相关接口，适合自建服务、二次开发和多平台部署(如果原版诈尸, 我会及时同步 or 归档)。
Important
注意
- 本项目是一个高度去中心化的第三方 API，其维护都由社区志愿者使用
Pull Request完成。- 使用本项目时请务必遵守相关法律法规，遵守
MIT协议, 尊重网易云音乐的服务条款。- 原作者项目 Binaryify/NeteaseCloudMusicApi 并非完全停止维护, 你可以在 NeteaseCloudMusicApi 的 NPMJS 页面 查看最新版本信息。
- 感谢尊重和理解!
git clone https://github.com/neteasecloudmusicapienhanced/api-enhanced.git
cd api
pnpm i
# 默认端口 3000
node app.js
# 指定端口（如 4000）
PORT=4000 node app.js # Mac/Linux
set PORT=4000 && node app.js # Windows
本项目支持通过 Docker 一键部署，无需手动安装 Node.js 或依赖。
注意: 在 docker 中运行的时候, 由于使用了 request 来发请求, 所以会检查几个 proxy 相关的环境变量(如下所列), 这些环境变量 会影响到 request 的代理, 详情请参考request 的文档, 如果这些环境变量 指向的代理不可用, 那么就会造成错误, 所以在使用 docker 的时候一定要注意这些环境变量. 不过, 要是你在 query 中加上了 proxy 参数, 那么环境变量会被覆盖, 就会用你通过 proxy 参数提供的代理了.
request 相关的环境变量
docker pull moefurina/ncm-api:latest
docker run -d -p 3000:3000 --name ncm-api moefurina/ncm-api:latest
// 或者
docker run -d -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
以下是自行 build docker 镜像方式
$ 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
| 变量名 | 默认值 | 说明 |
|---|---|---|
| CORS_ALLOW_ORIGIN | * | 允许跨域请求的域名。若需要限制，请指定具体域名（例如 https://example.com）。 |
| ENABLE_PROXY | false | 是否启用反向代理功能。 |
| PROXY_URL | https://your-proxy-url.com/?proxy= | 代理服务地址。仅当 ENABLE_PROXY=true 时生效。 |
| ENABLE_GENERAL_UNBLOCK | true | 是否启用全局解灰（推荐开启）。开启后所有歌曲都尝试自动解锁。 |
| ENABLE_FLAC | true | 是否启用无损音质（FLAC）。 |
| SELECT_MAX_BR | false | 启用无损音质时，是否选择最高码率音质。 |
| FOLLOW_SOURCE_ORDER | true | 是否严格按照音源列表顺序进行匹配。 |
更新到最新版本：
docker pull moefurina/ncm-api:latest
docker stop ncm-api && docker rm ncm-api
docker run -d -p 3000:3000 moefurina/ncm-api:latest
#!/bin/bash
export PORT=9000
/var/lang/node16/bin/node app.js
支持直接在 Node.js 项目中引入和调用，返回 Promise：
const {
login_cellphone,
user_cloud,
} = require('@neteasecloudmusicapienhanced/api')
async function main() {
const result = await login_cellphone({ phone: '手机号', password: '密码' })
console.log(result)
const result2 = await user_cloud({ cookie: result.body.cookie })
console.log(result2.body)
}
main()
import { banner } from '@neteasecloudmusicapienhanced/api'
banner({ type: 0 }).then((res) => console.log(res))
pnpm test
/musician/vip/tasks (#95)原作者 Binaryify/NeteaseCloudMusicApi 项目为本项目基础 (该项目在npmjs网站上仍持续维护, 但 github 仓库已不再更新)
感谢大佬们为逆向eapi, weapi等加密算法所做的贡献
项目参考:
listen1/listen1_chrome_extension
| 语言 | 作者 | 地址 | 类型 |
|---|---|---|---|
| Java | JackuXL | NeteaseCloudMusicApi-SDK | 第三方 |
| Java | 1015770492 | https://github.com/1015770492/yumbo-music-utils | 第三方 |
| Python | 盧瞳 | NeteaseCloudMusic_PythonSDK | 第三方 |
Content type
Image
Digest
sha256:7d0aa12f2…
Size
87 MB
Last updated
about 1 month ago
docker pull moefurina/ncm-api