完整教程：Unlock Music 多种音乐免费解锁使用教程

项目简介

Unlock Music 是一个开源的音乐文件解锁工具，可以在浏览器中直接解锁各大音乐平台的加密音乐文件。该项目基于 MIT 协议开源，主要用于学习和技术研究目的。

主要特性

支持的加密格式

Unlock Music 支持解锁以下主流音乐平台的加密文件：

QQ 音乐系列

• .qmc0 / .qmc2 / .qmc3 - QQ 音乐旧版加密格式
• .qmcflac / .qmcogg - QQ 音乐无损格式
• .tkm - QQ 音乐特殊格式
• .tm0 / .tm2 / .tm3 / .tm6 - QQ 音乐 Tm 格式
• .mflac / .mgg / .mflac0 / .mgg1 / .mggl - QQ 音乐新格式
• .bkcmp3 / .bkcflac - Moo 音乐格式
• .ofl_en - QQ 音乐海外版 JOOX Music

其他平台

• .ncm - 网易云音乐
• .xm - 虾米音乐
• .kwm - 酷我音乐
• .kgm / .vpr - 酷狗音乐
• .x2m / .x3m - 喜马拉雅（Android）
• .mg3d - 咪咕音乐

核心功能

✅ 纯浏览器端解锁 - 所有处理在本地完成，无需上传文件
✅ 拖放操作 - 支持直接拖拽文件到页面
✅ 批量处理 - 一次性解锁多个文件
✅ 多线程加速 - 利用 Web Worker 提升处理速度
✅ 元信息编辑 - 支持写入和编辑歌曲标题、艺术家、专辑等信息
✅ 专辑封面 - 自动获取或手动添加专辑封面
✅ PWA 支持 - 可作为渐进式 Web 应用离线使用
✅ 多种命名方式 - 支持多种文件命名格式（艺术家-歌曲名、歌曲名-艺术家等）

快速开始

方法一：在线使用（推荐）

1. 访问在线版本：unlock-music 或官方站点
2. 无需安装，直接使用

方法二：下载本地使用

步骤 1：下载预构建版本

从以下渠道获取最新版本：

• GitHub Releases
• CI 自动构建 - 可在 UM-Packages 下载

⚠️ 重要提示：本地使用请下载 legacy 版本（modern 版本只能通过 HTTP(S) 协议访问）

步骤 2：解压并运行

1. 下载后解压 ZIP 文件
2. 找到 index.html 文件
3. 双击打开即可使用（或通过本地 Web 服务器运行）

注意：请勿直接运行源代码，必须先构建

详细使用教程

基础操作

1. 上传文件

有两种方式上传加密文件：

方式 A：拖拽上传

• 直接将加密的音乐文件拖拽到页面中央的上传区域
• 支持一次拖拽多个文件

方式 B：点击选择

• 点击上传区域的"点击选择"按钮
• 在弹出的文件选择器中选择文件

2. 等待解锁

• 文件上传后会自动开始解锁
• 页面底部会显示进度条：已完成数 / 总数
• 解锁成功会显示通知提示

3. 查看结果

解锁完成后，在页面下方的表格中可以看到：

列名	说明
封面	专辑封面图片
歌曲	歌曲标题
歌手	艺术家名称
专辑	专辑名称
操作	播放、下载、编辑、删除按钮

4. 下载文件

单个下载：点击表格中对应歌曲的 下载按钮

批量下载：点击页面顶部的"下载全部"按钮

高级功能

编辑元信息

如果自动识别的信息不准确，可以手动编辑：

1. 点击歌曲行的 ✏️ 编辑按钮
2. 在弹出的对话框中可以修改：
   • 歌曲标题
   • 艺术家
   • 专辑名称
   • 专辑艺术家
   • 风格/类型
   • 专辑封面（支持上传自定义图片）
3. 点击"确定"保存修改

文件命名设置

在页面顶部可以选择下载文件的命名格式：

• 歌手-歌曲名（默认）：周杰伦 - 稻香.mp3
• 歌曲名：稻香.mp3
• 歌曲名-歌手：稻香 - 周杰伦.mp3
• 同源文件名：保持原始文件名

立即保存模式

对于大批量文件解锁：

1. 勾选"立即保存"选项
2. 解锁后的文件会立即下载，不在浏览器中保留
3. 可以防止处理大量文件时内存不足

⚙️ 解密设定

某些格式需要额外配置：

1. 点击"解密设定"按钮
2. 根据需要填写相关参数（如 JOOX UUID）
3. 保存设置后再进行解锁

播放功能

点击歌曲行的 ▶️ 播放按钮可以直接在浏览器中试听解锁后的音乐。

️ 管理文件

• 删除单个：点击歌曲行的 ️ 删除按钮
• 清除全部：点击页面顶部的"清除全部"按钮

自行构建

环境要求

JavaScript 部分

• Node.js v16.x 或更高版本
• npm 包管理器

WASM 部分（可选）

• Linux 操作系统
• Python 3

构建步骤

1. 克隆仓库

git clone https://github.com/ipid/unlock-music.git
cd unlock-music

2. 安装依赖

npm ci

3. 构建项目

开发模式（带热重载）：

npm run serve

生产构建：

npm run build

构建完成后，产物位于 dist 目录。

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

npm run make-extension

5. 构建 WASM 模块（可选）

./scripts/build-wasm.sh

⚠️ 注意事项

安全与隐私

1. 本地处理：所有解锁操作均在浏览器本地完成，不会上传文件到服务器
2. 网络请求：仅在获取专辑封面和歌曲信息时需要联网
3. 文件安全：建议在 HTTPS 环境下使用以获得最佳安全性

使用建议

1. 大批量转换：建议使用 CLI 版本
2. 浏览器兼容性：推荐使用现代浏览器（Chrome、Edge、Firefox）
3. HTTPS 环境：在 HTTPS 下可启用 Web Worker 多线程加速
4. 文件格式：确保上传的是支持的加密格式

法律声明

• 本工具仅用于学习和技术研究目的
• 请确保您对音乐文件拥有合法使用权
• 请勿用于商业用途或侵犯版权
• 修改和再分发时请遵循 MIT 许可协议

故障排除

常见问题

Q: 解锁失败怎么办？

A:

• 确认文件格式是否在支持列表中
• 检查文件是否损坏
• 某些格式（如 JOOX）需要在"解密设定"中配置参数
• 查看浏览器控制台是否有错误信息

Q: 为什么没有专辑封面？

A:

• 自动获取封面需要联网
• 可以手动编辑添加自定义封面图片
• 部分歌曲可能没有可用的封面信息

Q: 批量处理速度慢？

A:

• 在 HTTPS 环境下使用可启用多线程加速
• 使用"立即保存"模式避免内存占用
• 大批量建议使用 CLI 版本

Q: 下载的文件在哪里？

A: 文件会下载到浏览器默认下载目录，可在浏览器设置中查看和修改。