百科.dev
全部条目在线工具AI 编程趋势榜开源项目技术资讯提交条目
登录
< 返回工具列表
N

netease-cloud-music

> 编程语言
开源

✨ 网易云音乐 Golang

386 stars0 点赞2 次浏览
访问官网GitHub

工具介绍

✨ 网易云音乐 Golang

netease-cloud-music

网易云音乐 Golang API 接口 + 命令行工具套件 + 一键完成每日任务


⚠️ 重要声明

** 2025-06-03 更新:** 目前风控极为严格,刷歌功能存在较高封号风险,不建议使用。如执意使用并收到 非法挂机行为警告 ,请立即终止,否则后果自负!

  • 本项目仅供个人学习使用,切勿用于商业用途或非法用途!
  • 使用本项目遇到封号等问题概不负责,使用前请谨慎考虑!
  • 如有侵权请联系删除!
  • 理性star,切勿盲目跟风!

✨ 功能特性

命令行工具 (ncmctl) 提供以下功能

登录方式

  • 扫码登录
  • Cookie 方式登录
  • CookieCloud 方式登录
  • 短信登录 (存在风控问题)
  • 手机号密码登录 (存在风控问题)

每日任务

  • 统一调度每日任务(音乐合伙人、云贝签到、黑胶乐签、刷歌、每日推歌和乐迷团)
  • 每日推歌挑战赛, 支持自动发布动态、参与报名、抽奖(可配是否自动删除动态以及抽奖)
  • 乐迷团每日任务,支持只读状态查询、一次性执行和定时调度;执行模式可能点赞并发布公开动态,动态默认保留
  • 云贝签到(支持自动领取签到奖励)
  • "音乐合伙人"自动测评
    • 5 首基础歌曲 + 2~7 首随机额外歌曲测评(不包含"歌曲推荐"测评)
    • 2025 年 3 月 公告 | 规则
  • 每日刷歌 300 首(支持去重功能)
  • 黑胶乐签(无需有效 VIP 权益)

☁️ 云盘功能

  • 云盘上传(支持并行批量上传)

音乐处理

  • 解密 .ncm 文件为 .mp3/.flac 可播放格式(支持并行批量解析)
  • 音乐下载,支持多种品质(标准、较高、极高、无损、Hi-Res)

️ 调试工具

  • crypto 子命令 - 本地加密 WEAPI/EAPI/Linux API 参数;解密 EAPI 请求及 XEAPI 请求/响应
  • curl 子命令 - 按导出的 Go 方法名调用 API wrapper;是否需要登录及是否修改账号取决于具体接口
    • 支持动态链接请求
  • proxy 子命令 - 监控网易云音乐 HTTP(S) 接口请求与响应

计划中

  • VIP 日常任务完成(待考虑)
  • "音乐人"任务自动完成(待考虑)

环境要求

依赖 版本要求 必需
Golang = 1.25.0 是
Makefile - 可选
Git - 可选
Docker - 可选

安装

方式一:下载预编译版本

直接从 Releases 页面下载对应平台的二进制文件。

方式二:源码安装

bash
# 直接安装
go install github.com/chaunsin/netease-cloud-music/cmd/ncmctl@latest

# 或者克隆后安装
git clone https://github.com/chaunsin/netease-cloud-music.git
cd netease-cloud-music && make install

默认安装路径:$GOPATH/bin

方式三:Docker 安装

bash
# Docker Hub
docker pull chaunsin/ncmctl:latest

# GitHub Container Registry
docker pull ghcr.io/chaunsin/ncmctl:latest

Docker 使用文档:https://hub.docker.com/r/chaunsin/ncmctl

自行编译镜像:

bash
git clone https://github.com/chaunsin/netease-cloud-music.git
cd netease-cloud-music && make build-image

⚠️ 自行编译需安装 Docker 环境,国内网络建议使用代理。

方式四:青龙面板

详见 青龙脚本安装指南


使用指南

相关登录、任务执行、歌曲下载等参考: usage


API 接口

本仓库提供了一些API接口,可引用此仓库作为sdk进行二次开发,覆盖以下接口内容

接口包 当前覆盖
api/weapi/ 接口最完整,优先使用
api/eapi/ 包含 PC/移动端接口,覆盖范围小于 WEAPI
api/api/ 仅有少量试验性 wrapper;通用 CryptoModeAPI 请求层尚不会序列化 req
api/linux/ 目前只有构造器,没有具体 endpoint wrapper

注意: 接口后续可能出现重大变更,需斟酌风险。

接口示例

功能 示例文件 说明
登录 example_login_test.go -
云盘上传 example_cloud_upload_test.go 需登录
音乐下载 example_download_test.go 需登录

这些示例都带有 integration build tag,会访问真实网易服务,并可能登录、上传、下载或写入本地文件。确认相应副作用后再运行,例如:

bash
go test -tags=integration -v -run TestWeapiLoginByQrcode ./example/

AI 助手技能

本仓库提供也提供了两类职责不同的 skill:

  • skills/ncmctl/ 是可分发的 ncmctl 命令行使用指南,面向安装、登录、任务执行、命令参数等。
  • .claude/skills/ncmctl-dev/ 是代码开发指南,面向 Go 源码、测试、API/加密和代理实现。

安装技能

使用 skills 命令安装可分发的用户 skill:

bash
npx skills add chaunsin/netease-cloud-music --skill ncmctl -g

安装后,向 AI 助手询问 ncmctl 的安装和使用问题时会触发用户 skill。


❤️ 致谢

贡献者

  • sjpqxuzdly03646 - "音乐合伙人"功能支持
  • stkevintan - CookieCloud 登录方式

参考项目

  • NeteaseCloudMusicApi
  • api-enhanced
  • pyncm
  • musicdump
  • crontab.guru

感谢所有依赖的开源项目以及贡献者!

Issues· 0 开放

查看全部 Issues在 GitHub 打开

暂无开放 Issues,或尚未同步最近议题。

> 标签

Goapicmdcommand-line-toolgo

暂无评论,来聊聊你的看法吧

> 工具信息

发布日期2026年8月1日
最后更新2026年9月17日
分类编程语言
定价开源

> 相关工具

T
TypeScript
JavaScript 的超集,为前端与全栈提供静态类型
P
Python
通用编程语言,广泛用于 Web、数据与 AI
G
Go
Google 推出的简洁高效系统语言