全网最全的网易云音乐API接口 || A revival project for NeteaseCloudMusicApi Node.js Services (Half Refactor & Enhanced) || 网易云音乐 API 备份 + 增强 || 本项目自原版v4.28.0版本后开始自行维护
npm install @neteasecloudmusicapienhanced/api---
本项目为网易云音乐第三方 Node.js API，基于停更的原版 API 持续维护，支持丰富的音乐相关接口，适合自建服务、二次开发和多平台部署(如果原版诈尸, 我会及时同步 or 归档)。
> [!IMPORTANT]
>
> ## 注意
>
> - 本项目是一个高度去中心化的第三方 API，其维护都由社区志愿者使用Pull Request完成。
> - 使用本项目时请务必遵守相关法律法规，遵守MIT协议, 尊重网易云音乐的服务条款。
> - 原作者项目 Binaryify/NeteaseCloudMusicApi 并非完全停止维护, 你可以在 NeteaseCloudMusicApi 的 NPMJS 页面 查看最新版本信息。
> - 感谢尊重和理解!
- Node.js 18 及以上
- 推荐使用 pnpm 进行依赖管理
``bash`
git clone https://github.com/neteasecloudmusicapienhanced/api-enhanced.git
cd api
pnpm i
`bash默认端口 3000
node app.js
$3
- 调用前请务必阅读文档的 调用前须知 部分。
- 推荐将敏感信息（如 cookie）通过部署平台的环境变量进行配置。
在线体验与文档
- 在线文档
- NPM 包地址
- Dockerhub 主页
常见部署方式
- 推荐参考在线文档
Docker 部署说明
本项目支持通过 Docker 一键部署，无需手动安装 Node.js 或依赖。
> 注意: 在 docker 中运行的时候, 由于使用了 request 来发请求, 所以会检查几个 proxy 相关的环境变量(如下所列), 这些环境变量 会影响到 request 的代理, 详情请参考request 的文档, 如果这些环境变量 指向的代理不可用, 那么就会造成错误, 所以在使用 docker 的时候一定要注意这些环境变量. 不过, 要是你在 query 中加上了 proxy 参数, 那么环境变量会被覆盖, 就会用你通过 proxy 参数提供的代理了.
request 相关的环境变量
1. http_proxy
2. https_proxy
3. HTTP_PROXY
4. HTTPS_PROXY
5. no_proxy
6. NO_PROXY
shell
docker pull moefurina/ncm-api:latestdocker 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 镜像方式
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. 环境变量
| 变量名 | 默认值 | 说明 |
| -------------------------- | ------------------------------------ | ------------------------------------------------------------------------------ |
| 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 | 是否严格按照音源列表顺序进行匹配。 |---
$3
更新到最新版本：
`bash
docker pull moefurina/ncm-api:latest
docker stop ncm-api && docker rm ncm-api
docker run -d -p 3000:3000 moefurina/ncm-api:latest
`Vercel 一键部署
1. fork 本项目
2. 在 Vercel 官网新建项目，导入 fork 的仓库
3. 直接 Deploy
腾讯云 Serverless 部署
1. fork 本项目
2. 在腾讯云 serverless 控制台新建 Web 应用，选择 Express 框架
3. 代码仓库选择 fork 的项目，启动文件填写：
bash
#!/bin/bash
export PORT=9000
/var/lang/node16/bin/node app.js
`
4. 完成部署后，访问 API 网关的 URL 即可Node.js 方式调用
支持直接在 Node.js 项目中引入和调用，返回 Promise：
js
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()
`TypeScript 支持
ts
import { banner } from '@neteasecloudmusicapienhanced/api'
banner({ type: 0 }).then((res) => console.log(res))
`单元测试
bash
pnpm test
`主要功能特性
- 登录/注册/验证码
- 用户信息、歌单、动态、播放记录
- 歌曲、专辑、歌手、MV、歌词、评论、排行榜
- 搜索、推荐、私人 FM、签到、云盘
- 歌曲解锁（解灰）
贡献与社区
- 欢迎提交 PR、Issue 参与维护
最近更新日志
$3
- feat: 新增音乐人黑胶会员任务接口 (#95)
- feat: 自动构建: 添加Windows、Linux、macOS预编译二进制文件 (#88)
- fix: 修复模块未定义问题
- chore: 更新依赖项 (music-metadata: ^11.11.1 -> ^11.11.2, ansi-escapes: ^7.2.0 -> ^7.3.0, commander: ^14.0.2 -> ^14.0.3)
- chore: 更新GitHub Actions (checkout: v4 -> v6, setup-node: v4 -> v6, upload-artifact: v4 -> v6, download-artifact: v4 -> v7, github-script: v7 -> v8)
- refactor: 注释掉IP地址日志输出以提升隐私保护$3
原作者 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 | 第三方 |