ncmdump 使用教程：一文搞定网易云音乐NCM文件转换，把加密音乐还给你

【免费下载链接】ncmdumpncmdump - 网易云音乐NCM转换项目地址: https://gitcode.com/gh_mirrors/ncmdu/ncmdump

先说说那个让无数人卡住的 .ncm

周末想拷贝几首歌到车上听，打开下载文件夹，发现网易云音乐下载的歌全部是.ncm结尾。双击打不开，拖进任何播放器都报错，改后缀名变成.mp3依然无法播放——这个格式就像一把锁，把你自己花钱买来的音乐锁在了网易云客户端里。

如果你也遇到这个情况，别急着找什么"格式转换网站"（那些要么收费、要么上传隐私），今天要介绍的 ncmdump 就是专门解决这个痛点的开源工具：它用一条命令，就能完成网易云音乐NCM转换，把.ncm还原成最普通的 MP3 或 FLAC 文件，音质不变、标签还在，拷到哪里都能播。

大多数人第一步就错了：改后缀名没用

先泼一盆冷水：把xx.ncm改名成xx.mp3，播放器依然不认。原因很简单——NCM 不是"换了个壳的 MP3"，而是真正的加密文件。它的结构大致是：

• 文件头是一段 8 字节的魔数（MAGIC），用来标识这是 NCM 格式
• 中间是加密过的密钥数据、元数据（歌名、歌手、专辑）
• 最后才是用 RC4 流密码加密过的音频本体

也就是说，不改名、不装解码器，普通播放器永远读不懂里面的数据。网上那些"万能转换器"其实也是偷偷在做解密，只是你既不知道原理，还要把文件传给别人，实在不放心。

正解：一条 Java 命令，本地完成 NCM 转 FLAC

ncmdump 的思路非常朴素：在你自己电脑上、本地完成全部解密，文件不离开你的硬盘。它不需要网络、不需要登录账号，装好 Java 就能跑。

第一步：确认 Java 环境

ncmdump 基于 Java 8 开发，先检查你的电脑有没有 Java：

java -version

如果提示找不到命令，先去装一个 JDK（8 或更高版本都行），装完重新打开终端再试一次。

第二步：获取源码并打包

把项目克隆到本地：

git clone https://gitcode.com/gh_mirrors/ncmdu/ncmdump cd ncmdump mvn clean package

打包完成后，target目录下会生成一个ncmdump-2.0.jar文件。整个过程只需要 Maven 自动拉取两个依赖（fastjson2 用于解析 JSON 元数据、jaudiotagger 用于写音频标签），其余都是标准 Java 库，非常轻。

小提示：如果你本地没有 Maven，也可以直接用 IDE（IDEA 等）打开项目，等依赖下载完成后执行mvn package或直接运行 Main 类，效果一样。

第三步：转换你的第一个 NCM 文件

java -jar target/ncmdump-2.0.jar 你的音乐.ncm

等待几秒，终端会像这样输出处理过程：

- Start dumping .ncm - Verify .ncm MAGIC => Correct Read KEY data => Success AES-ECB decrypt => Success RC4-KSA build Key Box => Success Read META data => Success => Music Name: 晴天 => Artists: [周杰伦] => Album: 叶惠美 => Bitrate: 320000 => Format: mp3 Read CRC32 => Success Read album image => Success Read MUSIC data => Success Write MUSIC file => Success Fix ID3 Tag => Success - Finish dumping .ncm - => Output file path: /xxx/周杰伦 - 晴天.mp3

看到了吗？它不但把音频解出来了，还顺手把歌名、歌手、专辑、码率全部识别出来，输出文件名也自动改成了歌手 - 歌名.mp3，跟原文件放在同一个目录。整个过程一目了然，每一行都告诉你现在进行到哪一步。

单文件、批量、整理音乐库：三种用法一张表

很多人第一次用命令行工具会紧张，其实 ncmdump 的用法就一句话：把文件路径跟在 jar 后面，多少个都行。三种常见场景看这张表：

看到 Main.java 的实现你就会明白它为什么这么干脆——程序拿到参数后逐个创建NcmDump对象并执行，天然支持任意多个文件，不需要任何额外配置。

如果你想把转换整理成脚本，比如在 Linux/macOS 下定时整理下载目录：

#!/bin/bash for file in ~/Music/网易云/*.ncm; do java -jar ~/ncmdump/target/ncmdump-2.0.jar "$file" done echo "全部转换完成！"

转换后为什么连专辑封面都回来了

这是 ncmdump 最贴心的地方：它不是"只把音频流解出来"就完事，而是做了一次完整的标签修复。看核心代码NcmDump.fixId3Tags()（源码在src/main/java/io/qaralotte/ncmdump/dump/NcmDump.java），它会把元数据里的信息写回音频文件的标签里：

• 标题（TITLE）：恢复歌曲名
• 艺术家（ARTIST）：支持多位歌手逐个写入
• 专辑（ALBUM）：恢复专辑名
• 封面：把 NCM 内嵌的封面图片作为专辑封面写回去
• 备注（COMMENT）：写入原始的网易云密钥信息，方便溯源

这意味着转换完成的文件，在你的手机、车载系统、Foobar、iTunes 里显示的标签和封面都是齐全的，不需要你再手动补信息。至于格式，程序会根据元数据里的format字段自动选择 MP3 或 FLAC 的读取器，你完全不用管。

踩坑清单：这 4 个问题最常见

我帮你把新手最容易遇到的情况提前列出来，遇到了直接对照处理：

1. 提示No input .ncm File—— 你忘了传文件路径，或者路径里有空格没加引号。把路径用双引号包起来即可。
2. 提示Incorrect MAGIC—— 文件可能损坏，或者根本不是 NCM 文件（比如从网上随便下的假文件）。
3. 转换后播放正常但没有封面—— 说明原始 NCM 文件本身就不含封面数据，这是文件的问题，不是工具的锅，可以用标签编辑器手动补一张。
4. 批量转换时内存不足—— 一次拖入几百个大文件时建议分批处理，比如每次 50 个，避免程序一次性读完所有数据。

还有一句要提前说的：转换前建议确认这些文件确实是你自己通过正规渠道购买的，转换仅用于个人设备间的播放与备份。

现在就可以动手

回看整个流程，ncmdump 解决的核心问题其实只有一句话：把网易云音乐的文件格式限制还给你，让音乐回到它该在的地方。它不需要图形界面、不联网、不传文件，一条命令、几秒钟，你的音乐就能在任意设备上播放了。

你现在就可以做这三件事：

1. 先确认本机java -version可用
2. 克隆项目并执行mvn clean package打好 jar
3. 拿一首.ncm试转换，看输出路径里是不是多了一个歌手 - 歌名.mp3

转完第一首，你大概率会想把整张专辑、整个下载目录都过一遍——那就直接执行java -jar target/ncmdump-2.0.jar *.ncm，然后把转换脚本存好。从此以后，新下载的歌随手转，再也不用看格式的脸色了。

【免费下载链接】ncmdumpncmdump - 网易云音乐NCM转换项目地址: https://gitcode.com/gh_mirrors/ncmdu/ncmdump