🎵 netease-cloud-music

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

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

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

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

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

• 一键完成每日任务（音乐合伙人、云贝签到、黑胶乐签、刷歌 300 首）
• 每日推歌挑战赛, 支持自动发布动态、参与报名、抽奖(可配是否自动删除动态以及抽奖)
• 云贝签到（支持自动领取签到奖励）
• "音乐合伙人"自动测评
  • 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 日常任务完成（待考虑）
• "音乐人"任务自动完成（待考虑）

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

# 直接安装
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 Hub
docker pull chaunsin/ncmctl:latest

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

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

自行编译镜像：

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

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

详见 👉 青龙脚本安装指南

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

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

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

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

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

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

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

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

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

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

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

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

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