ncmdump-go

基于 ncmdump 的 Golang 移植版，支持网易云音乐 .ncm 文件解密为 MP3 / FLAC。

提供两种使用方式：Web 图形界面 和 命令行工具。

Web 界面（WASM，推荐）

所有加解密在浏览器本地完成，不会上传你的文件到任何服务器。解密引擎使用 Go 编译为 WebAssembly，性能接近原生。

使用

1. 打开网页
2. 选择包含 .ncm 文件的输入文件夹
3. 选择输出文件夹
4. 点击「开始转换」

歌曲名、歌手、专辑信息以及封面图片会自动写入转换后的文件中。

要求：Chrome / Edge 浏览器，通过 localhost 或 HTTPS 访问。

直接运行

从 Releases 下载对应平台的 ncmdump-web 二进制，或自行编译：

./build-wasm.sh

# 单机使用
./ncmdump-web --port 8080
# 浏览器访问 http://localhost:8080

局域网使用

非 localhost 下浏览器要求 HTTPS 才能启用文件夹选择功能。用 mkcert 生成自签名证书：

# 在运行服务器的机器上，替换为实际 IP
mkcert -install
mkcert 192.168.1.100 localhost

# 启动
./ncmdump-web --port 8080 --cert 192.168.1.100+1.pem --key 192.168.1.100+1-key.pem

然后局域网内其他设备访问 https://192.168.1.100:8080 即可正常使用。

交叉编译

纯 Go，无 CGO 依赖，可交叉编译到任意平台：

# Windows
CGO_ENABLED=0 GOOS=windows GOARCH=amd64 go build -ldflags="-w -s" -o ncmdump-web.exe ./cmd/server

# macOS (Intel)
CGO_ENABLED=0 GOOS=darwin GOARCH=amd64 go build -ldflags="-w -s" -o ncmdump-web ./cmd/server

# macOS (Apple Silicon)
CGO_ENABLED=0 GOOS=darwin GOARCH=arm64 go build -ldflags="-w -s" -o ncmdump-web ./cmd/server

# Linux (arm64)
CGO_ENABLED=0 GOOS=linux GOARCH=arm64 go build -ldflags="-w -s" -o ncmdump-web ./cmd/server

编译出的二进制约 15MB，前端和 WASM 运行时全部内嵌，拷贝到目标机器直接运行。

Docker 部署

docker compose up -d --build
# 访问 http://localhost:8080

如需提取二进制单独部署：

docker cp $(docker create ncmdump-web):/usr/local/bin/ncmdump-server ./ncmdump-web

命令行

安装

go install git.taurusxin.com/taurusxin/ncmdump-go@latest

使用

# 单文件
ncmdump-go song.ncm

# 批量处理目录（不递归子目录）
ncmdump-go -d source_dir

# 递归处理 + 指定输出目录
ncmdump-go -d source_dir -r -o output_dir

作为库使用

go get -u git.taurusxin.com/taurusxin/ncmdump-go

import "git.taurusxin.com/taurusxin/ncmdump-go/ncmcrypt"

ncm, _ := ncmcrypt.NewNeteaseCloudMusic("song.ncm")
ncm.Dump("/path/to/output")
ncm.FixMetadata(true)
fmt.Println(ncm.GetDumpFilePath())

项目结构

├── main.go                 # CLI 命令行入口
├── ncmcrypt/               # 核心加解密库
│   ├── ncmcrypt.go          #   NCM 格式解析 / RC4 解密
│   ├── metadata.go          #   元数据解析（歌名/歌手/封面URL）
│   └── embed.go             #   内存写入 ID3 / FLAC 标签
├── utils/                  # AES / 文件工具
├── cmd/
│   ├── wasm/main.go         # WASM 编译入口（浏览器端）
│   └── server/main.go       # 静态文件服务器
├── web/                    # 前端（React + Tailwind）
└── Dockerfile              # 多阶段构建

License

MIT