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 应用离线使用
✅ 多种命名方式 - 支持多种文件命名格式（艺术家-歌曲名、歌曲名-艺术家等）
🚀 快速开始
方法一：在线使用（推荐）
- 访问在线版本：unlock-music 或官方站点
- 无需安装，直接使用
方法二：下载本地使用
步骤 1：下载预构建版本
从以下渠道获取最新版本：
- GitHub Releases
- CI 自动构建 - 可在 UM-Packages 下载
⚠️ 重要提示：本地使用请下载 legacy 版本（modern 版本只能通过 HTTP(S) 协议访问）
步骤 2：解压并运行
- 下载后解压 ZIP 文件
- 找到
index.html文件 - 双击打开即可使用（或通过本地 Web 服务器运行）
📌 注意：请勿直接运行源代码，必须先构建
📚 详细使用教程
基础操作
1. 上传文件
有两种方式上传加密文件：
方式 A：拖拽上传
- 直接将加密的音乐文件拖拽到页面中央的上传区域
- 支持一次拖拽多个文件
方式 B：点击选择
- 点击上传区域的"点击选择"按钮
- 在弹出的文件选择器中选择文件
2. 等待解锁
- 文件上传后会自动开始解锁
- 页面底部会显示进度条：
已完成数 / 总数 - 解锁成功会显示通知提示
3. 查看结果
解锁完成后，在页面下方的表格中可以看到：
| 列名 | 说明 |
|---|---|
| 封面 | 专辑封面图片 |
| 歌曲 | 歌曲标题 |
| 歌手 | 艺术家名称 |
| 专辑 | 专辑名称 |
| 操作 | 播放、下载、编辑、删除按钮 |
4. 下载文件
单个下载：点击表格中对应歌曲的 📥 下载按钮
批量下载：点击页面顶部的"下载全部"按钮
高级功能
🎨 编辑元信息
如果自动识别的信息不准确，可以手动编辑：
- 点击歌曲行的 ✏️ 编辑按钮
- 在弹出的对话框中可以修改：
- 歌曲标题
- 艺术家
- 专辑名称
- 专辑艺术家
- 风格/类型
- 专辑封面（支持上传自定义图片）
- 点击"确定"保存修改
📁 文件命名设置
在页面顶部可以选择下载文件的命名格式：
- 歌手-歌曲名（默认）：
周杰伦 - 稻香.mp3 - 歌曲名：
稻香.mp3 - 歌曲名-歌手：
稻香 - 周杰伦.mp3 - 同源文件名：保持原始文件名
💾 立即保存模式
对于大批量文件解锁：
- 勾选"立即保存"选项
- 解锁后的文件会立即下载，不在浏览器中保留
- 可以防止处理大量文件时内存不足
⚙️ 解密设定
某些格式需要额外配置：
- 点击"解密设定"按钮
- 根据需要填写相关参数（如 JOOX UUID）
- 保存设置后再进行解锁
🎵 播放功能
点击歌曲行的 ▶️ 播放按钮可以直接在浏览器中试听解锁后的音乐。
🗑️ 管理文件
- 删除单个：点击歌曲行的 🗑️ 删除按钮
- 清除全部：点击页面顶部的"清除全部"按钮
🔧 自行构建
环境要求
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
⚠️ 注意事项
安全与隐私
- 本地处理：所有解锁操作均在浏览器本地完成，不会上传文件到服务器
- 网络请求：仅在获取专辑封面和歌曲信息时需要联网
- 文件安全：建议在 HTTPS 环境下使用以获得最佳安全性
使用建议
- 大批量转换：建议使用 CLI 版本
- 浏览器兼容性：推荐使用现代浏览器（Chrome、Edge、Firefox）
- HTTPS 环境：在 HTTPS 下可启用 Web Worker 多线程加速
- 文件格式：确保上传的是支持的加密格式
法律声明
- 本工具仅用于学习和技术研究目的
- 请确保您对音乐文件拥有合法使用权
- 请勿用于商业用途或侵犯版权
- 修改和再分发时请遵循 MIT 许可协议
故障排除
常见问题
Q: 解锁失败怎么办？
A:
- 确认文件格式是否在支持列表中
- 检查文件是否损坏
- 某些格式（如 JOOX）需要在"解密设定"中配置参数
- 查看浏览器控制台是否有错误信息
Q: 为什么没有专辑封面？
A:
- 自动获取封面需要联网
- 可以手动编辑添加自定义封面图片
- 部分歌曲可能没有可用的封面信息
Q: 批量处理速度慢？
A:
- 在 HTTPS 环境下使用可启用多线程加速
- 使用"立即保存"模式避免内存占用
- 大批量建议使用 CLI 版本
Q: 下载的文件在哪里？
A: 文件会下载到浏览器默认下载目录，可在浏览器设置中查看和修改。