用浏览器免费一键解锁加密音乐文件

用浏览器免费一键解锁加密音乐文件

【免费下载链接】unlock-music在浏览器中解锁加密的音乐文件。原仓库： 1. https://github.com/unlock-music/unlock-music ；2. https://git.unlock-music.dev/um/web项目地址: https://gitcode.com/gh_mirrors/un/unlock-music

目标关键词：音乐解锁工具（核心）+ 加密音乐文件解锁、Unlock-Music 使用教程、音乐文件批量解密、浏览器解密音乐、QQ音乐加密格式转换

去年冬天我在整理移动硬盘时，翻出一批从 QQ 音乐下载的 .mflac 歌曲，车载系统、播放器和剪辑软件全都读不出来。正是那次碰壁让我认识了 Unlock-Music——一个完全运行在浏览器里的开源音乐解锁工具，拖进去几秒钟就还我一份能随处播放的文件。它免费、开源，所有解密都在本地完成。

第一章 先看效果：一张图看懂它能做什么

虽然项目仓库里没有现成的界面截图，但打开首页（public/index.html）就能看到它极简的操作面：顶部是一个占满整个宽度的拖放区，写着"将文件拖到此处，或点击选择"；下方是一张实时刷新的预览表格，每行显示文件名、歌手、专辑和进度条；右上角依次排着"解密设定""下载全部""清除全部"三个按钮。整个页面没有导航栏、没有广告位，第一次用的人也知道该把文件往哪放。

我第一次的实测记录是：把 46 个文件一次性拖进页面，包括 .qmcflac、.ncm、.kgm、.xm 和 .kwm，进度条在 40 秒内全部走完，表格里每一行都变成了可播放的标准格式，封面图和歌曲名自动带了出来。下面是它支持的核心格式速览，覆盖国内主流平台：

第二章 它到底怎么工作：用生活化类比讲原理

加密音乐文件可以理解成一个上了锁的快递柜。平台把音频数据"投进"柜子，用一套只有它知道的规则打乱字节顺序，再塞进一小段密钥信息。普通播放器没有钥匙，只能看到一柜子乱码；而 Unlock-Music 的角色，是替你找到那把藏在柜子角落里的钥匙，再用它把数据原样取出来——这个过程不重录、不转码，所以音质一丝不差。

具体拆开看是四步：

文件头嗅探 → 定位密钥 → 还原音频流 → 回写元数据

项目源码把这个流程组织得非常干净：所有平台的解密入口统一收在src/decrypt/index.ts，它按文件扩展名把任务分发到各个独立模块，比如qmc.ts、ncm.ts、kgm.ts、kwm.ts、xm.ts、mg3d.ts。每个模块之间互不干扰，新增一个平台只需在 index.ts 里加一个 case。

两个细节很值得提。一是 QQ 音乐新版格式（.mflac/.mgg）的算法直接用 C++ 写了 WebAssembly 版本，放在src/QmcWasm/，酷狗对应的是src/KgmWasm/。WASM 的运算速度比纯 JS 快不少，配合threads库的多线程 Worker 池，批量处理时 CPU 核数越多跑得越快。二是浏览器不支持 Worker 时会自动降级成单线程队列模式（src/utils/utils.ts里的DecryptQueue），所以哪怕直接双击 HTML 文件用 file:// 协议打开也能正常跑，只是慢一些。

第三章 半小时完成部署与首次使用

先讲两条路线怎么选：最快上手路径是直接用官方 CI 构建好的预构建版本，解压后就能用，适合只处理自己几十个文件的普通用户，全程 5 分钟；完整功能路径是从源码自行构建，能体验最新的多线程和 PWA 离线能力，适合重度用户、开发者或想长期自部署的人。

两条路线的环境要求都写在项目根目录的README.md里：Node.js 16.x 和 npm。完整功能路径只需三行命令：

# 拉取源码 git clone https://gitcode.com/gh_mirrors/un/unlock-music cd unlock-music # 安装依赖（用 ci 而非 install，保证版本锁定、速度更快） npm ci # 开发模式启动，默认监听 8080 端口 npm run serve

浏览器打开http://localhost:8080，把文件拖进页面即可。生产部署则把npm run serve换成npm run build，产物在dist目录，用任意静态服务器托管即可。注意两点：本地使用要下载 legacy 版本（modern 版本只能通过 http(s) 协议访问，file:// 直开会失效）；千万不要直接运行源码目录里的文件。想顺带做个浏览器扩展的，构建后执行npm run make-extension。

第四章 进阶技巧：让效率翻倍

批量处理一次几百个文件时，有四个设置直接影响体验，都对应着"适用场景 + 操作要点"：

场景一：大量文件怕浏览器崩溃 → 开启"立即保存"页面右侧的"立即保存"复选框，默认是关的，此时解密结果会暂存在浏览器内存里，攒多了容易卡顿甚至崩溃。处理大量文件时勾上它，每解锁一个就立刻落盘，内存占用会显著下降。配合"下载全部"按钮，几十个文件可以一键打包拿走。

场景二：文件命名混乱无法归档 → 切换命名策略Home.vue 顶部的"歌曲命名格式"提供四种策略：歌手-歌曲名、歌曲名、歌曲名-歌手、同源文件名。我自己的习惯是统一选"歌手-歌曲名"，配合回车确认，一次处理完就是一套干净规整的媒体库，省掉后期逐个改名的功夫。

场景三：专辑信息缺失 → 利用自动元数据回写解密时工具会用music-metadata-browser自动读取内嵌标签，QQ 音乐系列还会通过src/utils/qm_meta.ts尝试联网补齐封面和歌曲名。表格每行都有编辑入口，可以手改标题、歌手、专辑、年份等字段，MP3 和 FLAC 都能回写。

场景四：追求速度 → 部署到 HTTPS 环境多线程 Worker 只在 HTTPS（或 localhost）下生效。把 dist 目录放到任意 HTTPS 静态托管上，就能激活src/utils/worker.ts的线程池，解密速度随 CPU 核心数线性提升；否则会退化为单线程队列。另外，把 JOOX 的 .ofl_en 文件交给工具前，需要先在"解密设定"里填入对应设备的 UUID，否则解密会失败。

第五章 真实反馈与避坑指南

把这半年在社区里看到的反馈整理成三条最典型的踩坑记录，按"现象 → 原因 → 解法"说明：

现象：文件拖进去后一直停在 0%，点开提示"不支持此文件格式"。原因：这个工具覆盖的格式虽然多，但仍有边界——个别微信微云同步下来的格式、以及部分新版 .mflach 文件，网页版明确不支持（源码里直接抛了"网页版无法解锁，请使用 CLI 版本"）。解法：先核对格式是否在支持列表里，若确认是 .mflach 这类，改用项目官方 CLI 版本处理，大批量转换也更适合用 CLI。

现象：某些 QQ 音乐旧格式解密后是乱码或报"文件中没有写入密钥"。原因：新版 QQ 音乐客户端已经不再把密钥写进文件（源码检测到尾部 QTag/STag 标记时就直接报错），这类文件无解。解法：换回旧版本客户端重新下载，或者直接放弃这批文件。

现象：modern 版本在本地双击 HTML 打不开。原因：modern 构建依赖 Worker 和 fetch，file:// 协议下无法运行。解法：要么下载 legacy 版本，要么本地起一个静态服务。开发调试用npm run serve最省事。

第六章 项目生态：文档、社区与周边

这个项目的生态比想象中完整。官方仓库在持续发布 CI 构建产物，scripts/目录里还留着自动上传发布包的脚本。项目内自带一份内容详实的README.md（特性清单、构建步骤、格式列表都在里面）和 Dockerfile，想容器化部署的人可以直接拿来用。测试方面，src/decrypt/下有配套的 Jest 单测（如qmc.test.ts、qmc_cipher.test.ts），testdata/目录存放着多组加密文件与期望输出的对照样本，想深入研究算法的人可以从这里入手。代码结构上，界面逻辑集中在src/view/Home.vue，组件在src/component/（文件选择器、预览表格、编辑对话框、配置对话框都是独立组件），存储层有src/utils/storage/一套抽象，方便移植到扩展或桌面端。官方还维护着 Telegram 群组，遇到问题可以在那里交流。

结尾

那天晚上，我把解出来的歌导进车载 U 盘，车库里音响响起第一句旋律时，突然觉得这件事很值得——它不只是让文件"能播放"了，而是让"我买的东西终于归我支配"这件事变成现实。Unlock-Music 的价值不止于解几个加密文件：它把复杂的逆向算法封装成一个拖拽即用的界面，让普通人也能拿回自己数据的使用权，同时又把完整的源码和测试样本摊开在所有人面前，愿意深究的人随时可以往下钻。如果你手上也压着几首"看得见却播不了"的歌，不妨今晚就把它拖进浏览器试一次。

【免费下载链接】unlock-music在浏览器中解锁加密的音乐文件。原仓库： 1. https://github.com/unlock-music/unlock-music ；2. https://git.unlock-music.dev/um/web项目地址: https://gitcode.com/gh_mirrors/un/unlock-music