Overview

Full name
docker.io/binaryify/netease_cloud_music_api
Registry
docker.io
Namespace
binaryify
Repository
netease_cloud_music_api
Cached tags
83
Last synced
07/06/2026, 07:51 PM

Introduction

Binaryify NeteaseCloudMusicApi 非官方网易云音乐 API 镜像,提供歌曲搜索、播放链接与歌单接口,供自建播放器或 Bot 调用。

Details

该项目将网易云 Web API 封装为 Node.js HTTP 服务,支持登录 cookie 解锁 VIP 音质与私人 FM。Docker 部署简单,默认监听 3000 端口;注意非官方接口存在账号风控与版权合规风险,仅供学习与私有实验。Cookie 与登录态应通过 env 或 volume 注入,切勿提交到公开仓库;公网暴露需加鉴权层。

快速启动

docker run -d --name netease-api \
  -p 3000:3000 \
  docker.io/binaryify/netease_cloud_music_api:latest

推荐实践

docker run -d --name netease-api \
  --restart unless-stopped \
  -p 127.0.0.1:3000:3000 \
  -v /data/netease/cookie:/app/cookie \
  -e TZ=Asia/Shanghai \
  docker.io/binaryify/netease_cloud_music_api:4.22.0

核心参数说明

  • -p 127.0.0.1:3000:3000 — API 端口,建议内网或反代
  • -v .../cookie:/app/cookie — 登录 cookie 持久化
  • --restart unless-stopped — API 服务持续运行
  • 固定 tag — 与接口路由变更同步
  • 合规提示 — 商业使用需评估版权与服务条款

Kubernetes

apiVersion: apps/v1
kind: Deployment
metadata:
  name: netease-api
spec:
  replicas: 1
  selector:
    matchLabels:
      app: netease-api
  template:
    metadata:
      labels:
        app: netease-api
    spec:
      containers:
        - name: api
          image: docker.io/binaryify/netease_cloud_music_api:4.22.0
          ports:
            - containerPort: 3000
          volumeMounts:
            - name: cookie
              mountPath: /app/cookie
      volumes:
        - name: cookie
          secret:
            secretName: netease-cookie
---
apiVersion: v1
kind: Service
metadata:
  name: netease-api
spec:
  selector:
    app: netease-api
  ports:
    - port: 3000
      targetPort: 3000

Cookie 经 Secret 挂载;Ingress 限制内网访问并配置 API Key 中间件,避免未授权爬取。

Latest tags (20)

View all 83 tags →
TagArchPushed AtSizeDigestSyncWishAction
docker.io/binaryify/netease_cloud_music_api
:v4.27.0
linux/arm64linux/amd64
2025/04/13 22:55126.0 MBsha256:29def59c3800
docker.io/binaryify/netease_cloud_music_api
:latest
linux/arm64linux/amd64
2025/04/13 22:55126.0 MBsha256:29def59c3800
docker.io/binaryify/netease_cloud_music_api
:v4.26.0
linux/arm64linux/amd64
2025/04/12 17:55126.0 MBsha256:cd73215d6aee
docker.io/binaryify/netease_cloud_music_api
:v4.25.0
linux/arm64linux/amd64
2024/11/16 11:11124.5 MBsha256:7c865ec20aa2
docker.io/binaryify/netease_cloud_music_api
:v4.24.0
linux/arm64linux/amd64
2024/10/20 22:30118.4 MBsha256:67790412c34d
docker.io/binaryify/netease_cloud_music_api
:v4.23.3
linux/arm64linux/amd64
2024/10/15 09:50118.4 MBsha256:9d7a21abc3a8
docker.io/binaryify/netease_cloud_music_api
:v4.23.1
linux/arm64linux/amd64
2024/10/06 16:37118.4 MBsha256:64b09fc5e3a0
docker.io/binaryify/netease_cloud_music_api
:v4.23.0
linux/arm64linux/amd64
2024/10/03 17:15118.4 MBsha256:d4c8557e147b
docker.io/binaryify/netease_cloud_music_api
:v4.22.0
linux/arm64linux/amd64
2024/07/23 11:19118.0 MBsha256:f408fa4366de
docker.io/binaryify/netease_cloud_music_api
:v4.21.2
linux/arm64linux/amd64
2024/07/09 11:24117.9 MBsha256:867d0d425df0
docker.io/binaryify/netease_cloud_music_api
:v4.21.1
linux/arm64linux/amd64
2024/06/27 09:38117.9 MBsha256:9f77fa74fe0c
docker.io/binaryify/netease_cloud_music_api
:v4.21.0
linux/arm64linux/amd64
2024/06/26 14:59117.9 MBsha256:a879d1d8d5e7
docker.io/binaryify/netease_cloud_music_api
:v4.20.0
linux/arm64linux/amd64
2024/06/12 15:32117.9 MBsha256:4b1e51491f3f
docker.io/binaryify/netease_cloud_music_api
:v4.19.9
linux/arm64linux/amd64
2024/05/31 17:43117.9 MBsha256:f7349d3958aa
docker.io/binaryify/netease_cloud_music_api
:v4.19.7
linux/arm64linux/amd64
2024/05/15 10:40117.0 MBsha256:61ed50f634bf
docker.io/binaryify/netease_cloud_music_api
:v4.19.6
linux/arm64linux/amd64
2024/05/11 14:25117.0 MBsha256:e33ee79534bf
docker.io/binaryify/netease_cloud_music_api
:v4.19.5
linux/arm64linux/amd64
2024/05/08 15:39112.7 MBsha256:601006f18a1f
docker.io/binaryify/netease_cloud_music_api
:v4.19.4
linux/arm64linux/amd64
2024/05/07 22:52112.8 MBsha256:cb4683ddab0d
docker.io/binaryify/netease_cloud_music_api
:v4.19.3
linux/arm64linux/amd64
2024/05/07 16:36112.8 MBsha256:3f7d59f32f1e
docker.io/binaryify/netease_cloud_music_api
:v4.19.2
linux/arm64linux/amd64
2024/05/07 15:46112.8 MBsha256:9139eb4fd9ed