本地部署Unlock-Music音乐解锁工具教程

Unlock-Music是一款强大的开源工具，能够在浏览器中解锁加密的音乐文件，支持多种主流音乐平台的加密格式。本文将详细介绍如何在本地部署和使用这款工具。

支持的加密格式

Unlock-Music支持广泛的加密音乐格式，包括：

• QQ音乐：.qmc0、.qmc2、.qmc3、.qmc4、.qmc6、.qmc8、.qmcflac、.qmcogg、.tkm
• 网易云音乐：.ncm、.ncmcache
• 酷狗音乐：.kgm、.kgma、.vpr
• 酷我音乐：.kwm
• 虾米音乐：.xm
• 咪咕音乐：.mg3d
• 喜马拉雅：.x2m、.x3m
• JOOX音乐：.ofl_en

核心功能特性

• 浏览器内解锁：所有解密过程在本地浏览器中完成，保护用户隐私
• 批量处理：支持多文件同时拖拽上传和解密
• 元数据保留：自动识别并保留歌曲封面、歌手、专辑等元信息
• PWA支持：可作为渐进式Web应用安装使用
• 多线程处理：利用Web Workers提高解密效率
• WASM加速：通过WebAssembly技术优化解密性能

环境准备

在开始部署之前，请确保系统满足以下要求：

• Node.js (v16.x或更高版本)
• npm包管理器
• 现代浏览器（Chrome 80+、Firefox 75+、Edge 80+）

本地部署步骤

1. 获取项目源代码

首先克隆项目仓库到本地：

git clone https://gitcode.com/gh_mirrors/un/unlock-music
cd unlock-music

2. 安装项目依赖

使用npm安装项目所需的所有依赖：

npm ci

3. 构建项目

执行构建命令生成生产版本：

npm run build

构建完成后，可以在dist目录中找到生成的静态文件。

4. 启动开发服务器（可选）

如需进行开发调试，可以启动开发服务器：

npm run serve

服务器启动后，在浏览器中访问http://localhost:8080即可使用。

5. 构建浏览器扩展（可选）

如需构建浏览器扩展版本，在构建成功后执行：

npm run make-extension

使用方法

网页版使用

1. 打开构建好的dist/index.html文件或通过开发服务器访问
2. 将加密的音乐文件拖拽到页面中的虚线区域
3. 等待解密完成
4. 点击下载按钮保存解密后的文件

文件选择界面

通过FileSelector组件可以方便地上传加密音乐文件，支持多文件选择和拖拽操作。

配置选项

通过ConfigDialog组件可以调整各种设置，包括输出格式偏好、元数据处理方式和文件名生成规则等。

项目结构解析

核心解密模块

项目的解密逻辑主要集中在src/decrypt目录下：

• QQ音乐解密：src/decrypt/qmc.ts
• 网易云音乐解密：src/decrypt/ncm.ts
• 酷狗音乐解密：src/decrypt/kgm.ts
• 酷我音乐解密：src/decrypt/kwm.ts
• 虾米音乐解密：src/decrypt/xm.ts

WebAssembly加速

项目使用WebAssembly来加速解密过程：

• KgmWasm模块：src/KgmWasm/ 用于酷狗音乐解密加速
• QmcWasm模块：src/QmcWasm/ 用于QQ音乐解密加速

前端界面组件

• 文件选择器：src/component/FileSelector.vue
• 预览表格：src/component/PreviewTable.vue
• 配置对话框：src/component/ConfigDialog.vue

注意事项

1. 版权声明：请确保仅对自己拥有合法版权的音乐文件进行解密操作
2. 浏览器兼容性：推荐使用现代浏览器以获得最佳体验
3. 安全提示：所有操作在本地完成，文件不会上传到任何服务器
4. 文件安全：建议从官方渠道获取源代码，避免使用第三方修改版本

常见问题

Q：解密后的文件保存在哪里？

A：所有操作在本地完成，解密后的文件通过浏览器默认下载路径保存。

Q：为什么有些文件解密失败？

A：可能是由于格式不支持或加密算法更新，请尝试更新到项目最新版本。

Q：是否支持手机端使用？

A：支持通过手机浏览器打开使用，但建议在电脑端进行批量处理。

总结

Unlock-Music作为一款开源免费的音乐解锁工具，提供了简单易用、安全高效的解决方案。通过本地部署，用户可以完全掌控解密过程，保护个人隐私。无论是整理个人音乐库还是解决格式兼容性问题，都是一个值得尝试的工具。

项目持续更新中，建议关注最新版本以获得更多格式支持和功能优化。