微信小程序 wxapkg 落盘位置提取与 wxappUnpacker 解包(UnpackMiniApp 解密)
mobile · verified
一句话结论
微信小程序运行后会把打包文件缓存在 Android 存储 /data/data/com.tencent.mm/MicroMsg/<32位hash>/appbrand/pkg/ 下(*.wxapkg,主包与分包);清空旧包后重新把目标小程序各页面走一遍得到新包,用 UnpackMiniApp 判断并解除加密,再用 wxappUnpacker 的 wuWxapkg.js(Node.js 环境)解包,即可得到 app-service.js、app.json、页面目录等可读源码,用于审计客户端加密/签名算法。
原理
- 小程序代码(JS/WXML/WXSS/配置)被打包进 wxapkg 文件;微信在本地运行小程序时会把包缓存到磁盘,Android 上路径为
/data/data/com.tencent.mm/MicroMsg/<user-hash>/appbrand/pkg/,其中<user-hash>随微信账号变化。 - wxapkg 格式:文件头
firstMark=0xbe、infoListLength、dataLength、lastMark=0xed,随后是文件索引表与数据区;解包器按索引把每个文件还原并做 JS 美化/配置补全。 - 部分环境(尤其 PC 微信)下载的包是加密的,需要 UnpackMiniApp 之类工具按包尾/密钥判断并解密;已解密的包也可以让工具先判断“是否加密”再决定是否处理。
- 主包之外还有分包(文件名带
_pages_xxx_等前缀),功能分散在多个包中,解包时要逐个处理。 - 为什么可复用:后端把签名/加密逻辑放在小程序 JS 里时,反编译是还原算法、伪造请求的前置步骤;小程序包对持有设备的人没有保密性。
触发条件
- Android 设备/模拟器已登录微信,并完整使用过目标小程序(各页面都打开过)。
- 能访问
/data/data/com.tencent.mm/(root、文件管理器 root 模式或 adb)。 - 本地有 Node.js 环境(wxappUnpacker 依赖 esprima、css-tree、cssbeautify、vm2、uglify-es、js-beautify)。
- 目标小程序未使用运行时完整性校验/代码虚拟化,否则反编译结果可能不完整。
利用步骤
- 打开微信进入目标小程序,把所有功能页面走一遍,让包完整落盘。
- 用 root 文件管理器/ADB 进入
/data/data/com.tencent.mm/MicroMsg/<32位hash>/appbrand/pkg/,确认出现多个*.wxapkg。 - 为排除旧包干扰:删除该目录下已有 wxapkg,重新打开小程序并走一遍页面,新生成的文件即目标包(含主包与分包)。
- 把包拉到本地,用 UnpackMiniApp(“PC 微信小程序一键解密”)选择加密小程序包,工具自动判断是否加密并解密。
- 在 wxappUnpacker 目录执行依赖安装:
bash npm install npm install esprima css-tree cssbeautify vm2 uglify-es js-beautify - 对主包执行
node wuWxapkg.js <主包.wxapkg>;若报错可能选错包(不是主包)或包未解密,但通常仍会输出部分文件。输出目录包含app-service.js、app.json、app-config.json、pages/、components/等。 - 在
app-service.js中搜索sign、encrypt、AES、key、iv、nonce、timestamp等关键词,定位客户端加密/签名逻辑,转入协议复现与改包重放。
PoC
# 设备侧:定位并拉取最新 wxapkg(路径中的 hash 随账号变化)
adb shell "ls /data/data/com.tencent.mm/MicroMsg/*/appbrand/pkg/"
adb pull /data/data/com.tencent.mm/MicroMsg/<hash>/appbrand/pkg/<pkg>.wxapkg ./
# 本地:解密(GUI 选择加密包,输出解密后的 wxapkg)
# UnpackMiniApp.exe -> 选择加密小程序包
# 本地:解包(Node.js)
cd wxappUnpacker
npm install && npm install esprima css-tree cssbeautify vm2 uglify-es js-beautify
node wuWxapkg.js <pkg>.wxapkg
# 输出:app-service.js / app.json / pages/ 等
说明:原文在夜神模拟器(Android 9)实测,包位于 /data/data/com.tencent.mm/MicroMsg/e594472a.../appbrand/pkg/;wuWxapkg.js 输出 Header info: firstMark 0xbe, infoListLength 1439, dataLength 549002, lastMark 0xed 后生成 38 个文件,解包目录与图 19 一致。原文未给工具版本,依赖以实际 npm 安装为准。
变体与关联
- 变体:PC 微信的 wxapkg 缓存目录在
%APPDATA%下的WeChat Files/Applet相关路径,可用同类工具解包;UnpackMiniApp本身就是按 PC 微信包设计。 - 变体:分包
_pages_xxx_.wxapkg单独解包后合并目录;主包缺失的模块常在分包里。 - 变体:不落盘反编译,改用微信 devtools/WeChatOpenDevTools 断点读加密函数(见关联卡)。
- 关联:[[mobile-miniprogram-sm-crypto-protocol-burp-transparent]](解包后定位 webpack 模块与国密协议);[[mobile-miniprogram-wxapkg-aes-cbc-sorted-sign-replay]](解包后还原 AES/签名改包重放);[[mobile-miniprogram-devtools-force-enable-wechat-version-pin]](静态看不懂时开 devtools 断点);[[mobile-android-anti-detection-root-emulator-proxy]](root 模拟器环境准备)。
- 边界:小程序代码虚拟化/加固、wxapkg 强加密且工具不支持、运行时完整性校验会导致解包失败或源码不完整;解包仅解决“看得见”,业务漏洞仍需单独验证。
检测与防御
- 开发者:不要把密钥、签名 secret、加解密逻辑放在小程序前端;关键逻辑上移服务端并绑定会话/设备。
- 平台/加固:代码混淆、虚拟化、运行时完整性校验、反调试;wxapkg 加密并轮换密钥。
- 检测(防守视角):设备上出现 wxapkg 批量复制/删除行为、root 文件管理器访问
/data/data/com.tencent.mm、PC 端调试工具连小程序 runtime。