🎵 netease-cloud-music

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

---

⚠️ 重要声明

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

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

---

✨ 功能特性

🖥️ 命令行工具 (ncmctl)

🔐 登录方式

• [X] 📷 扫码登录
• [X] 🍪 Cookie 方式登录
• [X] ☁️ CookieCloud 方式登录
• [X] 📱 短信登录 (存在风控问题)
• [X] 🔑 手机号密码登录 (存在风控问题)

📋 每日任务

• [X] 🎯 一键完成每日任务（音乐合伙人、云贝签到、VIP 签到、刷歌 300 首）
• [X] 💰 云贝签到（支持自动领取签到奖励）
• [X] 🎤 "音乐合伙人"自动测评
  • 5 首基础歌曲 + 2~7 首随机额外歌曲测评（不包含"歌曲推荐"测评）
  • 📢 2025 年 3 月 公告 | 规则
• [X] 🎧 每日刷歌 300 首（支持去重功能）
• [X] 💎 VIP 每日签到

☁️ 云盘功能

• [X] ☁️ 云盘上传（支持并行批量上传）

🎶 音乐处理

• [X] 🔓 解密 .ncm 文件为 .mp3/.flac 可播放格式（支持并行批量解析）
• [X] 📥 音乐下载，支持多种品质

🛠️ 调试工具

• [X] 🔐 crypto 子命令 - 接口参数加解密，便于调试
• [X] 🌐 curl 子命令 - 调用网易云音乐 API，无需关心参数加解密
  • [ ] 支持动态链接请求

🔜 计划中

• [ ] VIP 日常任务完成（待考虑）
• [ ] "音乐人"任务自动完成（待考虑）
• [ ] 🌐 Proxy 代理支持

📦 API 接口

💡 提示： 目前主要实现了 weapi ，接口相对较全，推荐使用。如需其他接口可提 Issue。

---

💻 环境要求

---

🔨 安装指南

方式一：下载预编译版本

直接从 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 安装

# 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 环境，国内网络建议使用代理。

方式四：青龙面板

详见 👉 青龙脚本安装指南

---

🤖 AI 助手技能 (ncmctl Skill)

本项目在 skills/ncmctl/ 目录下提供了 ncmctl 的 AI 助手技能，支持 Claude Code、Codex、cursor 等 AI 助手通过技能系统快速了解和使用 ncmctl。

技能内容

安装技能

使用skills命令进行交互安装

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

或 skills/ncmctl/ 目录复制到 AI 助手的技能目录即可使用。例如对于 Claude Code：

cp -r skills/ncmctl ~/.claude/skills/

安装后，向 AI 助手询问 ncmctl 相关问题时会自动触发该技能，获得准确的命令参考和使用指导。

---

🚀 使用指南

📱 一、登录

支持 5 种登录方式，详情如下：

---

📋 二、每日任务

一键执行所有每日任务：

ncmctl task

默认包含的任务：

选择性执行任务：

# 仅执行签到
ncmctl task --sign

# 执行签到和刷歌（无音乐合伙人资格时）
ncmctl task --sign --scrobble

自定义执行时间：

# 设置刷歌任务在每天 20:00 执行
ncmctl task --scrobble.cron "0 20 * * *"

💡 提示：

• 需要先登录
• 本命令以服务方式持续运行，退出请按 Ctrl+C
• 采用标准 crontab 表达式，在线编写工具

⚠️ 警告： 签到任务默认关闭自动领取奖励功能（存在封号风险），如需开启请添加 --sign.automatic 参数。

---

📥 三、音乐下载

下载单曲

# 通过分享链接下载 Hi-Res 品质
ncmctl download -l hires 'https://music.163.com/song?id=1820944399'

# 通过歌曲 ID 下载
ncmctl download -l hires '1820944399'

# 下载无损品质到指定目录
ncmctl download -l SQ 'https://music.163.com/song?id=1820944399' -o ./download/

批量下载

# 下载整张专辑（并发数 5，最大 20）
ncmctl download -p 5 'https://music.163.com/#/album?id=34608111'

# 下载歌手所有歌曲（严格模式：无对应品质则跳过）
ncmctl download --strict 'https://music.163.com/#/artist?id=33400892'

# 下载歌单
ncmctl download 'https://music.163.com/playlist?id=593617579'

💡 提示：

• 默认下载到 ./download 目录，音质为无损 (SQ)
• --strict 严格模式下，无指定品质则跳过；否则会降级下载

---

☁️ 四、云盘上传

# 上传单个文件
ncmctl cloud '/path/to/music.mp3'

# 批量上传目录
ncmctl cloud '/path/to/music/'

参数说明：

⚠️ 目录深度不能超过 3 层。更多过滤条件请查看 ncmctl cloud -h。

---

🔓 五、NCM 文件解密

将加密的 .ncm 文件转换为可播放的 .mp3/.flac 格式。

# 批量解析目录
ncmctl ncm '/path/to/ncm/files' -o ./output

# 设置并发数
ncmctl ncm '/path/to/ncm/files' -o ./output -p 10

⚠️ 目录深度不能超过 3 层。

---

🛠️ 六、其他命令

# 查看帮助
ncmctl -h

---

📚 API 使用示例

---

❓ 常见问题

Q1: 下载无损音乐品质不准确？

当指定 -l lossless 时，可能会下载到 Hi-Res 品质。若歌曲不支持 Hi-Res，则会正常下载无损。此问题仍在排查中。

Q2: 每日刷歌为什么达不到 300 首？

scrobble 支持去重功能，会在 $HOME/.ncmctl/database/ 记录已听歌曲。

可能原因：

1. 使用本程序前已听过的歌曲未记录，导致重复播放不计数
2. Top 榜单歌曲数量有限，新歌更新不及时

⚠️ 建议：不要清理 $HOME/.ncmctl/database/ 目录下的数据！

Q3: task 和 scrobble、sign、partner 子命令有什么区别？

---

❤️ 致谢

👥 贡献者

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

📦 参考项目

• NeteaseCloudMusicApi
• pyncm
• musicdump
• crontab.guru

感谢所有依赖的开源项目！