Thor 扩展管理器评测:签名验证 + SHA-256 校验的内置扩展目录如何保障安全
Thor 扩展管理器评测:签名验证 + SHA-256 校验的内置扩展目录如何保障安全
Thor 是一款开源(GPL-3.0)的 Android 应用管理器,其内置的 Thor 扩展管理器(Extension Manager) 提供可选插件目录。每个扩展在安装前都必须通过签名验证 + SHA-256 哈希校验两道核心关卡,本文带你完整走一遍这套 7 层校验链,看看它凭什么敢在 App 内直接安装插件。
什么是 Thor 扩展管理器?
简单来说:
- 扩展 = 独立的 Android 应用,包名必须以
com.valhalla.thor.ext.开头,由项目方或社区构建 - 目录 = 应用内置的 Extension Store,打开时通过 HTTPS 拉取一份 JSON 目录文件
- 只有目录中标记为
verified且带下载链接的条目才能安装,其余显示为 "Source only — build it yourself"(仅源码,需自行编译)
值得一提的是:扩展商店是 Thor 唯一的网络访问用途。目录只在打开商店时才请求,请求是普通的 GET,不附带任何用户标识,因此隐私面极小。
安装前的 7 层校验链:逐层拆解
Thor 的下载与校验逻辑集中在 StoreRepositoryImpl.kt,规则非常清晰:
| 步骤 | 校验内容 | 失败结果 |
|---|---|---|
| 1️⃣ 目录资格 | 条目必须标记 verified 且有下载 URL | 只显示"仅源码",无安装按钮 |
| 2️⃣ 传输协议 | URL 必须为 HTTPS,明文 HTTP 直接拒绝 | 中止安装 |
| 3️⃣ 主机白名单 | 只接受 github.com 及其资源 CDN(*.githubusercontent.com) |
中止安装 |
| 4️⃣ 边下边算 | 下载的同时流式计算 SHA-256,手动跟随重定向(最多 5 次,每一跳都重新校验主机) | 中止并删除文件 |
| 5️⃣ 哈希比对 | 计算结果与目录中固定的哈希值比对 | 中止安装,删除文件 |
| 6️⃣ 签名证书比对 | APK 签名证书的 SHA-256 指纹必须与 Thor 内置的固定密钥一致 | 中止安装,删除文件 |
| 7️⃣ 移交安装器 | 全部通过后才把文件交给 Android 安装器 | — |
几个对新手友好的设计细节:
- 边下边算哈希:文件流式写入磁盘的同时完成 SHA-256 计算(见 downloadHashing),不存在"一段未校验的文件躺在磁盘上"的时间窗口
- 手动跟随重定向:不让 HTTP 栈自动跳转,而是逐跳复查协议与主机,防止目录被篡改后用重定向把下载"拐"到别的服务器
- 失败即删文件:任何一步失败,临时 APK 都会被删除,不留残余
签名验证:最关键的一道防线 🛡️
哈希校验能防"文件被篡改",但如果整个目录被攻击者替换呢?这时起决定作用的是第 6 步——固定签名密钥(Pinned Signer)。
Thor 内置了一个专用扩展签名密钥(RSA-4096),其证书 SHA-256 指纹直接写死在 ExtensionTrust.kt 中。下载后的 APK 会先于安装器被 isApkFileSignerPinned 检查:
即使目录被攻破,Thor 也绝不可能安装一份"不是项目方签名"的 APK。
这条路径上没有任何调试放松——下载来的 APK 永远必须精确匹配固定密钥。调试构建的宽松策略只针对"已安装在设备上的自研扩展",从不作用于商店下载。
持续校验:每次加载都重新验证
校验并不止于安装那一刻,Thor 在加载扩展时也会再次核对签名:
- 缓存的扩展实例只在版本号(versionCode)和磁盘路径都未变化时才被复用
- 一旦扩展更新、重装或降级,旧实例立即失效并触发全新校验
- 任何与固定密钥不再匹配的扩展会停止加载,且不会出现在扩展管理器列表中
这套逻辑实现在 ExtensionManager.loadExtensions,并贯彻"失败即视为不可信(fail-closed)"原则——读不到证书、格式异常等任何意外情况,答案一律是"不信任",而不是"大概没问题"。
Verified 徽章意味着什么?信任边界要分清
首次打开扩展管理器时,Thor 会弹出一份责任告知书(还附带一道小算术题,防止惯性滑动关闭),大意是:
- 扩展可能改变 App 与系统的行为,任何人都能构建扩展
- 项目方只为自己分发并签名的扩展背书;你安装后的行为责任自负
- 带 Verified 徽章的扩展 = 使用项目专用密钥签名;从别处侧载的扩展,正式版 Thor 会拒绝加载
需要清醒认识的是:验证证明的是"文件就是发布的那份,未被篡改",不等于对扩展行为本身的审计。所以让某个扩展执行特权操作前,读一遍它的源码(目录条目中的 sourcePath 字段就指向源码位置)是值得的时间。官方完整的扩展政策文档见 extensions-policy.mdx,与 App 内文案完全一致。
评测总结:这套方案适合谁?
✅ 做得好的
- 校验链层层递进,每层都有明确的失败路径,"失败关闭"贯彻到底
- 网络面极小:只为目录发起一次请求,不收集任何数据
- 文档透明,目录数据模型(ExtensionCatalog.kt)中
verified与apkUrl缺一不可才可安装 - 首发体验友好:扩展商店入口就在家页 Bento 网格上,一键进入
⚠️ 要知道的
- 目前目录中扩展数量有限,属于"小而精"生态
- 部分扩展需要 LSPosed / Xposed(即需要 Root),商店会以 "Requires LSPosed" 明确标出
- 卸载扩展就是卸载一个普通 Android 应用,没有 Thor 专属卸载入口
总的来说,Thor 扩展管理器把"在 App 内装插件"这件高风险的事,做成了教科书式的防御纵深:HTTPS → 主机白名单 → 流式 SHA-256 → 固定签名密钥 → 加载期复检。对新手用户来说,你几乎不需要理解这些机制,认准 Verified 徽章即可;而对开发者来说,这套实现本身就是一份安全校验的优秀参考。
📁 相关源码速查
- 下载与 SHA-256 校验:app/src/main/java/com/valhalla/thor/data/repository/StoreRepositoryImpl.kt
- 固定签名密钥清单:app/src/main/java/com/valhalla/thor/data/manager/ExtensionTrust.kt
- 扩展加载与签名复检:app/src/main/java/com/valhalla/thor/data/manager/ExtensionManager.kt
- 官方扩展政策页:web/src/pages/extensions-policy.mdx
- 项目简介与功能清单:README.md

