简介面向 macOS 用户的 QQ 音乐 QMC 格式转换源码包支持将 qmcflac、qmc0、qmc3、mflac、mflac0 等加密音频转为 flac 或 mp3 普通格式。项目以 Swift 编写包含完整 Xcode 工程、解码核心模块、界面与测试代码适合计算机、电子、数学等专业学生作为课程设计、期末大作业或毕设项目参考也适合开发者学习音频解密思路与 mac 应用开发实践。压缩包共 34 个文件以 Swift 源文件、PNG 截图、JSON/plist 工程配置为主另有操作演示 GIF、README 说明整体约 946KB解码器、TEA 加密算法、窗口控制器等模块划分清晰下载后可直接打开工程运行。目前已有 1405 人学习适合需要研究 QMC 格式转换或进行 macOS 工具类项目实战演练的读者。1. QMC格式转换为什么你下载的FLAC在macOS上死活打不开你在QQ音乐里点下载客户端明明告诉你这是一首FLAC等它下完你把文件拖到macOS的访达里一看后缀却是.qmcflac双击之后系统只能弹出一句没有可用的应用程序。这不是个例QQ音乐会在本地音频外面套一层加密封装qmcflac、qmc0、qmc3、mflac、mflac0这些后缀都属于这层封装区别只是里面封的是FLAC还是MP3。和网易云的NCM、酷狗的KGM/MGG一样QMC文件不能靠改名回到普通格式必须做一次真实的解密还原。这篇笔记专门讲macOS上如何把这五类后缀批量转成可播放的flac和mp3以及转换中一定会踩到的几个坑。2. 解密原理先立住QMC2/QMC1的密钥藏在哪为什么改后缀必翻车做转换之前先把原理讲清楚。很多人第一次拿到QMC文件第一反应是把.qmcflac改成.flac改完发现还是打不开于是得出结论macOS不支持flac这是完全错的方向。问题不在播放器而在文件内容本身QMC是加密后的字节流不是普通的FLAC容器。只有理解了它怎么加密你才知道该选什么工具、为什么有的歌转了是噪声、为什么有的工具只支持qmc0不支持mflac。2.1 先分清五种后缀qmcflac、qmc0、qmc3、mflac、mflac0QQ音乐不同版本、不同音质档位下载下来的文件后缀并不统一。常见的就是标题里这五类我把它们的对应关系整理成一张表后缀内部实际编码常见来源转换目标.qmcflacFLAC普通用户下载的FLAC音质.flac.qmc0MP3普通用户下载的标准音质.mp3.qmc3MP3普通用户下载的高品音质.mp3.mflacFLAC较新客户端下载的FLAC音质.flac.mflac0FLAC新客户端/会员下载的FLAC音质.flac为什么同一个封装体系要分这么多种后缀而不是统一叫.qqmusic或者干脆不显示后缀最直接的原因是QQ音乐客户端要区分内部编码FLAC源的封装和MP3源的封装不能混用解密后一个是flac流、一个是mp3流播放器解析方式完全不同。.qmcflac和.mflac虽然目标都是flac但加密机制不完全一样老一批解密工具往往只支持qmc0/qmc3的固定密钥对mflac就无能为力这也是后面避坑章节要重点讲的。这里还要提醒一句后缀不能完全代表内部编码。.qmcflac改名为.mflac不会改变加密内容反过来也一样。解密的正确做法是看工具输出的真实流格式而不是迷信文件名。2.2 解密到底解什么文件头标记、掩码表与逐字节异或QMC的加密思路和NCM、KGM这类国内音乐平台的本地DRM在一个路子上不是把整个文件用AES之类的块加密算法锁起来而是对原始音频字节流做逐字节混淆。公开实现里常见的方式是拿一个密钥生成一串掩码字节把音频的每个字节和掩码做异或运算密文就产生了。解密的时候在同样的位置再异或一次数据就还原了。难点在掩码是怎么生成的。早期qmc0、qmc3这代文件用的是一段写死在工具里的固定文本密钥所有歌曲共用同一套规则所以老解密工具内置这张表就能通吃。而qmcflac、mflac、mflac0这一代掩码的生成参数被写进了文件本体——通常藏在文件开头的某个偏移位置解密器需要先从文件头把这段参数取出来再根据参数构造掩码序列最后对文件主体做异或。这也是为什么老工具解新文件全是噪声旧工具不知道新版本掩码的生成规则异或用的字节对不上还原出来的流自然是乱码。这个认知直接影响你选工具。如果工具宣称支持mflac/mflac0说明它实现了动态掩码的提取逻辑如果只写了支持qmc0/qmc3那你拿它处理mflac就是白费功夫。反过来有些工具统一按文件头判断版本而不是按后缀这类工具容错率更高推荐优先用。2.3 为什么改后缀不靠谱播放器认魔数不认文件名把.qmcflac改成.flac之后文件头依然是密文而macOS上的播放器识别格式靠的是文件内容里的魔数magic number不是扩展名。真正的FLAC文件开头四个字节是固定的66 4c 61 43用十六进制看就是fLaCMP3文件开头要么是ID3标签要么是FF FB、FF F3这类同步字。QMC密文没有这些特征所以VLC、IINA、QuickTime一个都不认。那为什么QQ音乐自己能直接播放这些文件因为它内置了解密器播放前先在内存里把字节流还原再把还原后的数据交给音频解码器。有人会觉得那我把后缀改成flacQQ音乐是不是也认——能认但它认的是自己的解密逻辑不是因为你改对了后缀。更麻烦的情况是有些转换工具靠后缀决定输出格式如果源文件后缀和真实编码不一致工具就会把MP3流硬写进flac容器播放器看到fLaC魔数以为是对的解出来却是噪音。所以后面批量脚本里我坚持先判型再给扩展名。3. 在macOS上搭好环境Intel与Apple Silicon都要过的三道关标题限定了仅支持macOS那环境配置就是绕不开的一步。macOS和Linux虽然都是Unix系但有三件事不一样CPU架构、包管理器路径、以及Gatekeeper的拦截。这三关过不去后面命令跑得再熟也没用。3.1 先看机器架构uname -m 决定用哪个二进制第一步先确认处理器架构终端里执行uname -mApple SiliconM1/M2/M3/M4系列会输出arm64Intel芯片的Mac输出x86_64。这一步不能跳过因为仅支持macOS的工具包很可能同时只带一个平台的二进制或者压缩包里分开放了两个版本。你在Apple Silicon上强行跑x86_64的二进制系统要么提示需要Rosetta要么直接报Killed: 9反过来在Intel Mac上跑arm64二进制系统直接不认。我一般会在解压后先看一眼工具包里的文件是不是Mach-O格式用file qmc-cli就能看到类似Mach-O 64-bit executable arm64的输出。如果工具包作者只编译了Intel版而你又是Apple Silicon机器别急着放弃——多数情况下可以通过arch -x86_64配合Rosetta运行但性能不是问题问题是要装Rosetta环境。更推荐的做法是找对应架构的版本省得后面排查隔离属性时多一个变量。3.2 用Homebrew装ffmpeg转换不一定用它校验一定用它接下来装ffmpeg。解密工具本身可能不依赖ffmpeg但转换完的校验环节离不开两样东西ffprobe看格式参数ffmpeg提封面、做转封装。macOS上最省事的装法是Homebrewbrew install ffmpeg装完立刻验证ffprobe -version能打印出版本信息就说明PATH没问题。这里有个细节ffmpeg的二进制体积不小依赖也多安装过程如果中断过再跑一次brew install ffmpeg可能会卡在already installed的状态——这时候先brew uninstall ffmpeg再装或者直接用brew upgrade ffmpeg继续不要反复重试同一个install命令。如果你不想装Homebrew下载别人编译好的静态版ffmpeg放到/usr/local/bin也是一种常见做法但升级和依赖管理都很痛苦。我见过有人把ffmpeg直接扔进~/Downloads然后用绝对路径调用结果每次终端会话都要重新找路径纯属给自己找麻烦。装进系统PATH里才是正路。3.3 让zsh认得命令.zprofile与PATH配置很多人在macOS上遇到明明装了Homebrew但终端说找不到brew的问题原因只有一个zsh登录时没有加载Homebrew的环境变量。macOS默认shell是zsh登录启动时会读取~/.zprofileHomebrew装完后终端里那行提示——eval $(/opt/homebrew/bin/brew shellenv)——就是要写进这个文件的。echo eval $(/opt/homebrew/bin/brew shellenv) ~/.zprofile source ~/.zprofile注意路径Apple Silicon上Homebrew装在/opt/homebrew所以是/opt/homebrew/bin/brewIntel Mac上装在/usr/local路径是/usr/local/bin/brew。写错了等于白写。改完之后验证which brew which ffprobe两条命令都有输出说明环境通了。还有一个常见玄学问题终端里能用的命令在脚本或GUI应用里却找不到。这是因为终端登录shell读了.zprofile而你的脚本或某些应用没有走登录shell环境。遇到这种黑匣子现象先which确认路径再决定是改脚本还是用绝对路径调用别急着重装系统。4. 把QMC还原成普通格式五类后缀一次批量转换的命令写法环境就绪之后进入正题。下面命令里的可执行文件我统一记为qmc-cli你从zip解压出来的实际文件名可能是qmcdecoder、qmc2mp3、mflac2flac之类替换成真实文件名即可。整章按单文件跑通 → 目录批量 → 并行加速三层递进每一步都先跑通再做下一步。4.1 单文件先跑通最小命令与输出参数先把一个文件转成功验证工具在你这个macOS版本上能正常工作。解压工具包后终端进入对应目录给二进制加执行权限chmod x qmc-cli ./qmc-cli 01 前奏.qmcflac -o 01 前奏.flac命令说明-o指定输出路径这是这类工具最常用的参数。我习惯显式指定输出文件名而不是让工具自动命名原因是自动命名可能会直接在原目录生成同名文件若工具没有自动加后缀就会覆盖源文件——解密失败时你连后悔药都没得吃。指定-o之后原文件保留输出文件另存至少能对比着排查。输出之后立刻做一次最小验证xxd -l 16 01 前奏.flac前四个字节应该是66 4c 61 43也就是ASCII的fLaC。如果看到的是ID3或者别的值说明这个工具是靠后缀决定输出容器的源文件后缀和实际内容不一致后面批量时不能单纯看后缀。4.2 五种后缀批量处理一个脚本同时完成qmcflac转flac与qmc0转mp3单个文件没问题后写一个能递归处理整个目录的脚本。我常用的是find搭配while read而不是for f in *.qmcflac原因后面避坑章节会细说find . -type f \( -name *.qmcflac -o -name *.qmc0 -o -name *.qmc3 -o -name *.mflac -o -name *.mflac0 \) -print0 | while IFS read -r -d f; do case $f in *.qmcflac|*.mflac|*.mflac0) extflac ;; *.qmc0|*.qmc3) extmp3 ;; esac out${f%.*}.${ext} echo ${f} - ${out} ./qmc-cli $f -o $out || echo FAIL: ${f} done逻辑说明find把符合五种后缀的文件全部找出来-print0让文件名之间用空字符分隔而不是换行这样带空格和换行的文件名都不会被拆坏。while IFS read -r -d f一次读入一个完整文件名到变量fIFS防止把行首尾空格吃掉-r防止文件名里的反斜杠被转义。case根据后缀决定输出扩展名qmcflac、mflac、mflac0 输出flacqmc0、qmc3 输出mp3。${f%.*}是去掉最后一个点及其后面内容再用$ext拼上目标扩展名。最后|| echo FAIL: $f保证单个文件失败时不会中断整个循环。跑完这个脚本目录下会多出一批.flac和.mp3文件原文件还在。我建议先不要删原文件等抽查完一部分再统一清理避免转换工具本身出问题导致全军覆没。4.3 大量文件时怎么加速xargs -P与并行队列一个文件夹几百个文件时上面的串行循环也够用但如果你有几千首歌串行会等到怀疑人生。这时用xargs做并行find . -type f \( -name *.qmcflac -o -name *.qmc0 -o -name *.qmc3 -o -name *.mflac -o -name *.mflac0 \) -print0 | xargs -0 -P 4 -I {} bash -c f$1 case $f in *.qmcflac|*.mflac|*.mflac0) extflac ;; *.qmc0|*.qmc3) extmp3 ;; esac ./qmc-cli $f -o ${f%.*}.$ext _ {}参数说明xargs -0与find -print0配套-P 4表示同时跑4个转换进程-I {}把每个文件名替换到{}位置后面的_ {}是传给bash -c的位置参数——$0是下划线占位文件名作为$1传入。并行度不要超过CPU线程数Apple Silicon 的8核机器设4到6路比较合适如果文件在机械硬盘上并行反而会因磁头来回寻道而变慢这时退回串行更实际。并行最大的缺点是错误日志会乱成一团某个文件失败时不容易对应到具体文件。所以我一般会在批量后单独跑一遍校验缺失文件的find命令把没有生成对应.flac或.mp3的源文件筛出来重新转换。5. QMC转换避坑手册五个高频翻车现场与排查命令这章是血泪经验汇总。QMC转换本身没什么算法难度但实际操作中能翻车的点全在细节里。每条我都按现象 → 原因 → 解决来写你遇到同类问题可以直接照方抓药。5.1 转换后文件打不开源文件后缀和真实编码不一致现象转换过程没有报错输出文件也有几百MB但双击没反应ffprobe直接报unknown format。原因源文件后缀与内部编码不符。比如一首实际是MP3编码的歌下载下来后缀却是.qmcflac或者反过来某些老版本客户端的文件明明以flac编码后缀却是.qmc0。工具如果按后缀决定目标扩展名就会把mp3流写进flac容器或把flac流写进mp3容器播放器认了魔数却解不出正常音频。解决批量脚本不要只信后缀。解密前先抽几个样本看头部特征xxd -l 16 源文件.qmcflac如果头部前四个字节不是符合预期的密文标记就要警惕。转换完成后用ffprobe抽查输出文件确认实际编码流与容器一致。我现在的习惯是无论后缀是什么先转一个用xxd验证魔数再决定整个批次的方向。5.2 转出来全是杂音密钥版本和工具版本不匹配现象转换成功播放器也能识别格式但声音是连续的嘶嘶声或高频噪声完全无法听。原因掩码表版本不匹配。qmc0、qmc3用固定密钥老工具内置了这套规则就能解qmcflac、mflac、mflac0是动态掩码掩码生成参数存在文件头里。新客户端更新了掩码生成算法后老工具按旧规则去异或得到的字节流全是错的播出来自然是白噪声。这跟文件损坏完全是两回事。解决换支持mflac/mflac0的新工具版本或者用能自动识别文件版本的工具。怎么判断工具是否支持看它的说明里是否同时提到qmcflac和mflac这两种处理分支。如果没有就别拿它处理mflac文件。另外同一首歌如果有不同后缀的版本可以各转一个做对比如果qmc0转mp3正常、mflac转flac是噪声基本可以断定是工具对动态掩码支持不到位。5.3 批量处理到一半中断文件名里的空格和特殊字符现象批量脚本跑了一部分突然报No such file or directory中断位置往往在带空格或中文名的文件上。原因典型的for f in *.qmcflac写法会把文件名按空格拆成多个字段中文路径在某种shell编码下也可能出错。批处理时没有对文件名加引号或者用了for而不是find -print0遇到01 前奏.qmcflac这个文件命令实际执行时就变成了处理01和前奏.qmcflac两个不存在的文件。解决全部改用4.2小节里find -print0while read -d 双引号的写法。关键就两处文件名的读取分隔符用空字符引用变量时加双引号。顺手做个防御[ -e $f ] echo $f在循环开头检查文件是否存在可以快速定位哪些文件因为被拆坏而根本没进入处理队列。5.4 macOS提示已损坏或无法打开Gatekeeper拦截现象工具第一次运行时终端或访达提示无法打开因为来自身份不明的开发者甚至直接说文件已损坏无法打开。很多新手看到已损坏三个字就以为二进制文件坏了重下好几遍还是一样。原因从网络下载的二进制文件带有com.apple.quarantine属性macOS的Gatekeeper会拦截未签名应用这是安全机制不是文件损坏。终端里直接执行也会被拦因为拦截发生在exec阶段。解决给二进制去掉隔离属性xattr -d com.apple.quarantine ./qmc-cli执行前确认已经chmod x。顺序上我建议先chmod x再xattr -d有些macOS版本在文件无执行权限时会重新打上隔离标记。另外不要图省事用sudo spctl --master-disable全局关闭Gatekeeper得不偿失。如果不想动命令行访达里右键→打开再点一次打开也能放行但只对当前文件有效。5.5 磁盘空间突然不够没算清汇出体积现象转换到一半报磁盘满或者转换完发现输出文件比源文件大了好几倍。原因很多人默认flac转mp3会变小但qmc3/qmc0转出来的本身就是源MP3码率体积并不会缩水而96kHz/24bit的高规格flac转出来依然是这个规格一首歌100MB以上很正常。更糟的情况是工具误判格式把mp3流包进flac容器体积反而膨胀。转换前不看源文件大小和采样率一股脑全转几千首歌很容易填满整个磁盘。解决批量之前先抽一个文件看参数ffprobe -v error -show_entries streamcodec_name,sample_rate,bits_per_raw_sample,bit_rate -of defaultnoprint_wrappers1 源文件.qmcflac看到bits_per_raw_sample24、sample_rate96000这种参数就要预估体积并检查磁盘剩余空间。df -h看一眼再动手能省掉很多中途清理的麻烦。大目录建议分批次转换每批转换完先核对输出数量和总体积再进下一批。6. 转换完成的最后一道工序用ffprobe和魔数做无损自检转换完成不等于转换正确。加密文件解密后理论上应该和QQ音乐服务器端的源文件完全一致实际转换中工具版本不对、判型错误、封装错误都会产出能播但错了的文件。所以我会在批量之后做三道自检全过才算收工。第一道是魔数自检确认容器类型xxd -l 16 输出.flacflac文件前四字节必须是66 4c 61 43fLaCmp3文件前四字节应该是49 44 33ID3或FF FB、FF F3这类同步字。如果扩展名是flac但看到的不是fLaC直接判定封装错误。第二道是参数核对确认没有丢采样率和位深ffprobe -v error -show_entries streamcodec_name,sample_rate,bits_per_raw_sample,bit_rate -of defaultnoprint_wrappers1 输出.flac重点看两个值codec_name应该是flac而不是pcm_s16le、pcm_f32le这类裸流——那说明flac容器里装的根本不是flac编码sample_rate和bits_per_raw_sample要与你抽查源文件时看到的一致。96kHz/24bit的源转完变成44.1kHz/16bit听力上可能不明显但文件已经残了。第三道是顺手提取封面这也是很多人转完才想起来要的东西。flac和mp3的内嵌封面可以用ffmpeg直接抽ffmpeg -i 输出.flac -an -c:v copy cover.jpg-an丢弃音频流-c:v copy把封面帧原样复制出来不做任何重编码所以执行很快。如果文件没有封面图ffmpeg会报Output file does not contain any stream不用慌说明这张专辑本来就没嵌图。另外多说一句很多人拿到解密后的flac还会再转一次ALAC喂给Apple Music这种二次转码注意别把96kHz/24bit降成48kHz/24bit除非你确定播放设备支持。我在转换后都会用ffprobe存一份参数清单和原始文件做对比避免二次转换悄悄改变规格。我现在的习惯是每次换工具版本、或升级QQ音乐客户端后重新下载文件都先挑一首96kHz/24bit的flac做基准样本转换后对一遍魔数和ffprobe参数确认无误再跑全量。曾经偷懒跳过这一步结果一整批qmcflac被旧工具转成了44.1kHz的mp3文件躺在硬盘里过了半年才发现。希望帮到你。本文还有配套的精品资源点击获取