Unlock Music 音乐解锁工具完全指南
项目地址: https://gitcode.com/gh_mirrors/un/unlock-music Unlock Music 是一款强大的开源工具，能够在浏览器中轻松解锁多种加密音乐文件，支持QQ音乐、网易云音乐、酷狗等主流音乐平台的加密格式。无需安装复杂软件，通过简单操作即可恢复音频文件的原始状态，让您自由管理和播放喜爱的音乐。
核心功能特性
全面支持主流加密格式
Unlock Music 几乎覆盖了国内所有主流音乐平台的加密格式，包括：
- QQ音乐：.qmc0/.qmc2/.qmc3/.qmcflac/.qmcogg/.tkm/.tm0/.tm2/.tm3/.tm6/.mflac/.mgg/.mflac0/.mgg1/.mggl
- 网易云音乐：.ncm格式
- 酷狗音乐：.kgm/.vpr格式
- 酷我音乐：.kwm格式
- Moo音乐：.bkcmp3/.bkcflac等
- 其他平台：虾米(.xm)、喜马拉雅(.x2m/.x3m)、咪咕(.mg3d)、JOOX Music(.ofl_en)
便捷的操作体验
- 纯浏览器操作：完全在浏览器中运行，无需安装任何桌面软件
- 拖放操作：直接拖拽文件到页面即可开始处理
- 批量处理：支持同时上传多个文件进行解密
- 元信息编辑：自动恢复并允许编辑歌曲的元信息和专辑封面
- 多线程处理：利用Web Worker技术提升解密速度
- PWA支持：可作为渐进式Web应用安装使用
使用方法
使用预构建版本（推荐新手）
- 从项目官方地址下载最新的预构建版本
- 解压缩下载的文件
- 双击打开
index.html文件即可使用
注意：本地使用请下载legacy版本（modern版本只能通过http(s)协议访问）
自行构建项目
如果您熟悉命令行操作，可以通过以下步骤自行构建项目：
环境准备
- Node.js (v16.x)
- npm包管理器
构建步骤
# 获取项目源代码
git clone https://gitcode.com/gh_mirrors/un/unlock-music.git
cd unlock-music
# 安装依赖
npm ci
# 构建项目
npm run build
构建后的产物将保存在dist目录中，直接打开其中的index.html即可使用。
如需开发调试，可以执行npm run serve启动开发服务器。
浏览器扩展版本
Unlock Music还提供了浏览器扩展版本，安装后可直接在浏览器中使用：
- 按照上述步骤构建项目
- 执行以下命令构建扩展：
npm run make-extension - 在浏览器中加载扩展（通常在扩展管理页面开启"开发者模式"，然后选择构建好的extension目录）
技术实现原理
解密核心架构
Unlock Music的解密功能主要通过JavaScript实现，核心代码位于src/decrypt目录。针对不同格式，项目采用了不同的解密策略：
- QQ音乐的.qmc系列格式使用src/decrypt/qmc.ts中的解密算法
- 网易云音乐的.ncm格式解密逻辑在src/decrypt/ncm.ts中实现
- 酷狗音乐的.kgm格式通过WebAssembly技术加速解密
WebAssembly加速技术
为提升部分复杂算法的解密速度，项目使用WebAssembly技术，将C++编写的解密逻辑编译为wasm模块。相关的C++代码位于：
- QQ音乐格式WASM实现：src/QmcWasm/
- 酷狗音乐格式WASM实现：src/KgmWasm/
构建WASM部分需要Linux环境和python3，可以通过运行scripts/build-wasm.sh脚本来编译。
许可证信息
Unlock Music项目采用MIT许可证开源，详细条款见项目根目录下的LICENSE文件。根据许可证要求，您可以自由使用、修改和分发本项目，但必须保留原始的版权声明和许可条款。
使用建议
- 解密后的文件会自动保留原始元信息（歌曲名、歌手、专辑等）
- 如果解密后的文件无法播放，尝试使用其他播放器或检查文件完整性
- 对于大型音乐库，建议使用项目的CLI版本进行批量处理，效率更高
希望本指南能帮助您更好地使用Unlock Music！如有任何问题，可以查阅项目的官方文档。享受自由的音乐体验！
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
