免 Mac 浏览器侧载的幕后拼图:实测 iosBoom IPA Library 的 256 KB 流式聚合、双签名管线与 Safari UDID 闭环

免 Mac 浏览器侧载的幕后拼图:实测 iosBoom IPA Library 的 256 KB 流式聚合、双签名管线与 Safari UDID 闭环

在研究免越狱 iOS 侧载生态时,大多数人的关注点都在 AltStore、SideStore、Feather 这类客户端工具上;但过去一年里,以 iosBoom IPA Library 为代表的“免 Mac 纯浏览器侧载门户”正在迅速走红——用户只需打开网页,就能一站式检索数千款修改版或第三方 IPA、用 Safari 获取设备 UDID、上传 .p12 证书在线重签,并通过 itms-services:// 直接拉起系统安装弹窗。

为了弄清这类网页端 IPA 商店究竟是“静态链接列表”,还是背后真有一套精密的前后端工程拼图,我在浏览器中对 iosboom.com/ipa-library 及其关联的 /signer、/getudid、/app/Feather 路由进行了实机抓包与生产环境 ES 模块拆解。本文将完全基于实测观测到的真实架构、数据流转与源码模块,还原这套多租户白标侧载平台的底层实现,并客观审计它在前端私钥暂存与云端重签之间的真实信任边界。

[!NOTE] 实测观测基线说明
本文所有端点命名、状态机字段、目录统计与模块逻辑,均来自我在 2026 年 11 月 20 日对 https://iosboom.com/ipa-library(实测收录 2,189 款自建目录应用并联邦接入 5 个外部仓库)、/signer、/getudid 及 /app/Feather 线上生产环境及其前端 Chunk 模块的直接观测。部分细节涉及动态配置项(如后端 signer_api 热切换开关),会随站点运营策略实时变化。


一、不止是一个页面:白标化的 trystore.net 侧载控制面

刚打开 iosboom.com/ipa-library 时,我原本以为它是一个独立的自研单页站点,但顺着静态资源请求和生产环境入口模块(site-client-D7W_p3T3.js 与 PlusApps-DVgcgnLj.js)往下追,立刻发现了它真正的工程底色:这是一套支持英语与阿拉伯语 RTL 双语切换的白标侧载 SaaS 架构(内部大量沿用 __tryplus__、tryplus 与 trystore.net 命名空间)。

前端技术栈非常现代:由 React + Vite / Rolldown(rolldown-runtime)+ TanStack Router + TanStack Query + Framer Motion 驱动,配合 Tailwind CSS 渲染暗/亮自适应卡片栅格与无障碍语义标签;而在数据控制面层,浏览器通过定制反代域名 https://supapi.trystore.net 直连背后的 Supabase 实例,直接订阅或查询以下核心数据表:

  • plus_library_apps:自建精选 IPA 主库,支持分页拉取(每次 1000 条)、多语言字段(name_ar / subtitle_ar)、截图数组以及 R2 / GitHub 双模存储标记(storage_type)。
  • plus_repos:外部第三方 AltStore / Scarlet / KhoIPA 仓库清单(实测线上激活了 ucerts、AppTesters、IPAOMTK Apps、Build Store 与 Minoa's Combined)。
  • plus_repo_hidden_apps:细粒度运维屏蔽表,支持按 repo_key(或通配符 *)+ bundle_id / app_name 实时隐藏外部源里的失效或违规应用。
  • plus_settings 与 plus_signer_settings:全局功能开关,控制是否开放原始 .ipa 下载(allow_ipa_download)、是否开启免费共享证书横幅(free_mode_enabled + RPC plus_has_active_free_cert),以及当前激活的云端签名后端(signer_api)。
iosBoom IPA Library 多源联邦聚合与分发架构

这套架构最值得工程师玩味的地方,在于它把“重度算力与大文件吞吐剥离到 R2 与专用签名 Worker,把聚合、清洗与首屏加速下沉到浏览器本地”。


二、硬核前端工程:256 KB 流式 JSON 状态机与仓库净化管线

玩过 iOS 第三方软件源的人都知道,很多社区维护的 AltStore / KhoIPA JSON 仓库动辄几 MB 甚至十几 MB(包含数千款历史版本记录、截图 URL 与冗长描述),而且大量托管在 GitHub Raw 或个人 PHP 脚本下——直接 fetch().then(r => r.json()) 在移动端浏览器上不仅经常触发 CORS 跨域拦截,还要干等几秒到十几秒才能看见第一张应用卡片。

在拆解 repoFetch-ChCeU_i4.js 时,我看到了作者写出的一套非常巧妙的三级抗抖动拉取引擎:

1. 256 KB 边下边解的局部状态机(Streaming Partial JSON Parser)

当用户点击切换第三方仓库标签(例如 AppTesters 或 Minoa's Combined)时,前端会同时竞速发起两个动作:

  • 主路径 l(url) 尝试拉取完整 JSON;
  • 并发旁路 f(url) 则调用 Fetch Streams API(response.body.getReader()),设定了 s = 262144 字节(恰好 256 KB)的读取上限,一旦读满前 256 KB 立刻调用 reader.cancel() 掐断流!

拿到这前 256 KB 文本碎片后,函数 u(chunk) 会跑一个手写的字符级括号深度状态机(追踪字符串引号状态 r、反斜杠转义 i 以及大括号深度 n === 2 || n === 3),把已经完整闭合的单个 { "name": ..., "downloadURL": ... } 应用对象逐个 JSON.parse() 出来,趁完整请求还在网络传输途中就先行塞进状态 Le(...) 渲染首屏列表。这种在浏览器里对未闭合 JSON 流做“抢跑解析”的手法,把大仓库的体感白屏时间压低了一个数量级。

2. 透明 CORS 代理回退与配额自保 SWR 缓存

  • CORS 自动降级:所有外部 JSON 请求先直连目标源(AbortController 15 秒超时),一旦因跨域头缺失或网络异常报错,立即无缝回退到 https://trystore.net/api/repo?url=<encoded> 边缘代理拉取。
  • 防炸裂的 localStorage 缓存:缓存键前缀为 plus-repo-json:,TTL 设为 24 小时(864e5 ms)。有意思的是,代码里专门写了一条容量熔断规则——如果一个仓库的应用数量超过 400 个,直接跳过 localStorage 持久化,防止 5 MB 浏览器存储配额被撑爆;即便写入时触发异常,也会自动清扫所有历史 plus-repo-json:* 键再重试,并且写入动作统一包裹在 requestIdleCallback(5 秒超时)中,避免阻塞主线程滚动。

3. 杂乱上游数据的“洁癖级”归一化

从实测看,第三方源的 JSON 字段命名五花八门(比如 icon / iconURL / icon_url、bundleID / bundleIdentifier / bundle_id、versionDate / added),分类标签更是中英阿混杂。PlusApps-DVgcgnLj.js 与 repoVisibility-Ca2FAS8c.js 在渲染前执行了四道清洗流水线:

  1. 高危源与垃圾载荷过滤:内置硬编码过滤关键词 sidelix;通过正则拦截非 IPA 直链(如 .html、.php、.json、.zip、.deb 等网页跳转地址,除非是 .ipa 结尾或无后缀 CDN 分发链),并剔除默认占位图标。
  2. 双语正则分类归一化:把上游数十种五花八门的分类词(如 arcade、emulator、ألعاب、صور وفيديو)统一映射为 14 个标准分类;若原分类缺失,直接对应用名称和简介跑启发式关键词正则兜底。
  3. 三元组去重与位置插槽排序:外部聚合应用按 ${bundle_id}|${name}|${version} 复合键去重;而主库 plus_library_apps 则先按管理员指定的 position 固定插槽就位,其余空位按 download_count 下载量降序与字母表填充。
  4. 渲染期死图剔除:不仅靠 IntersectionObserver(rootMargin: 240px)按每次 24 张卡片懒加载,还在 <img> 的 onLoad 回调里检查 naturalWidth < 8 || naturalHeight < 8——遇到坏图或 1×1 像素追踪占位图时直接把该应用 ID 塞入 R 屏蔽集合隐藏掉,保证版面零裂图。

三、免 Mac 云端签名管线与 Safari UDID 采集闭环

仅有 IPA 列表还不够,普通未越狱 iPhone 要把 IPA 装进手机,必须经过设备 UDID 注册 → P12/描述文件签名 → itms-services:// OTA 安装三步闭环。我分别拆解了 /getudid(GetUdid-BuPEq0bp.js)与 /signer(Signer-3RXaWtxS.js + TrustpilotReviewButton-D5fcmXrl.js)的完整代码逻辑。

免 Mac 云端签名双管线与 Safari UDID 采集闭环

1. /getudid:基于 Safari 守卫的 OTA 描述文件回传

在 iOS 上,Chrome、Firefox 或内置 WebView 下载 .mobileconfig 时往往会卡在预览或无法跳转系统设置。因此 /getudid 页面启动时先跑了一段严格的 User-Agent 正则守卫(排除 CriOS、FxiOS、EdgiOS、OPiOS 等套壳内核),强制提示用户在原生 Safari 中打开。

点击下载后,设备拉取 https://udid.tryui.dev/udid/getudidiosoompage.mobileconfig;用户在 设置 → 通用 → VPN 与设备管理 确认安装后,iOS 系统将设备真实 UDID 与硬件型号标识符(PRODUCT)以挑战响应的方式回传给服务端,随后重定向回 /getudid?udid=...&model=...,再由前端的 formatDeviceModel 映射成人类可读的 iPhone / iPad 机型名称。

2. /signer:本地证书保险箱与可热切换的双引擎签名集群

最让我惊讶的是 /signer 的工程成熟度——它并非单一的简单表单上传,而是通过 Supabase 的 postgres_changes 实时订阅 plus_settings.signer_api,支持在不停服的情况下将全站签名算力在 tryui 与 ipasign 两套完全不同的后端架构之间毫秒级热切换:

  • 主路径 tryui(https://api.tryui.dev + R2 预签名直传 + SSE 进度流):
    面向动辄几百 MB 甚至上 GB 的大型游戏 IPA(如《Minecraft》或剪辑软件),直接走网关表单上传很容易触及边缘函数请求体上限或连接超时。于是 tryui 采用了标准的云原生“两段式预签名架构”:

    1. 前端先调用 Supabase Edge Function trydevui-r2-upload(action: "presign"),拿到 Cloudflare R2 的临时直传签名链接 uploadUrl 与 publicUrl;
    2. 浏览器通过 XMLHttpRequest 以 application/octet-stream 直接向 R2 PUT 原始 .ipa(超时设为 3,600,000 ms,即 1 小时),这段上传进度占据 UI 总进度的 0% ~ 50%;
    3. 接着向 https://api.tryui.dev/tasks 申请 task_id,将 .p12、.mobileprovision、证书密码、R2 临时 ipa_url 以及丰富的 Mach-O 定制参数一并提交——实测表单支持 Bundle ID / 名称覆盖(多开克隆)、版本号与最低系统要求修改、多 .dylib 插件注入、移除指定 .dylib、剥离 Apple Watch 插件 / Extensions / UISupportedDevices 限制、开启 UIFileSharingEnabled(文档共享)与强制重签;
    4. 任务提交后,前端优先建立 EventSource 长连接监听 https://api.tryui.dev/tasks/{taskId}/events(订阅 update / status / message 事件),一旦 SSE 遭遇代理断开,无缝降级为 2.5 秒一次的 GET /tasks/{taskId} 轮询;UI 内部用单调递增状态机(starting → uploading → downloading → processing → signing → packaging → publishing → completed)把后端进度映射到 50% ~ 100%,防止进度条回跳;
    5. 无论签名成功、失败还是用户中途取消,前端或清理回调都会触发 trydevui-r2-upload(action: "delete")删除 R2 上的临时包,避免存储空间泄露。
  • 备用路径 ipasign(https://ipa.ipasign.cc 直传签名):
    当控制面将 signer_api 切换为 ipasign 时,前端绕过 R2 预签名,直接构造 FormData(含 ipa、p12、mp、password 及可选的 bundle_id / bundle_name)POST 到 https://ipa.ipasign.cc/sign(超时 30 分钟),拿到 task_id 后每 3 秒轮询 GET /status/{task_id},完成后直接拼装 itms-services://?action=download-manifest&url=https%3A%2F%2Fipa.ipasign.cc%2Fmanifest%2F{task_id}.plist,在 iOS Safari 中一点即可唤醒系统原生桌面安装进程。


四、安全审计与架构权衡:哪些是真隔离,哪些是信任边界?

看懂了这套系统的工程巧妙之处后,作为安全与架构审视者,我必须把视线拉回它最核心的风险面。当你把自己的 Apple 个人开发证书(.p12)和密码放进网页签名器时,究竟发生了什么?我梳理了从边缘到终端的五层控制与信任模型:

iosBoom 托管侧载平台五层安全控制面与残留信任边界

[!WARNING] 证书隐私与前端存储的真实边界(必读)
在 /signer 页面的勾选框旁,标注着 "Save this certificate on this device only (never uploaded to our servers)"。从代码实测来看,这句话需要拆成两半准确理解:

  1. 持久化存储确实只在本地:勾选保存后,前端用 FileReader 将 .p12 与 .mobileprovision 转为 Base64,连同明文 password 一起写入浏览器 localStorage(键名为 tryplus.custom_certs.v1),确实没有存进 Supabase 数据库;但这也意味着密码是以明文 JSON 形式落在 localStorage 中(未使用 WebCrypto 加密或内存临时密钥),一旦同源环境遭遇第三方脚本或 XSS 漏洞,本地凭证将直接暴露。
  2. 执行重签瞬间仍必须上传至签名 Worker:因为浏览器 JS/WASM 目前并未在客户端本地执行 Mach-O 代码签名(底层重签仍依赖服务端的 zsign 类原生二进制),点击“Start signing”时,.p12、.mobileprovision 和证书密码依然会通过 HTTPS 表单提交至 api.tryui.dev 或 ipa.ipasign.cc 进行瞬态解密签名。换言之,“不上传”指的是不入库持久化,而不是私钥永不离开浏览器——使用公共在线签名服务时,建议只配合非核心的个人测试/单设备签名证书,切勿填入主力 Apple Developer 账号的高权限分发证书。

此外,这套架构还有三个客观的工程与生态约束值得留意:

  1. 公开 anon Key 与 RLS 策略的强绑定:前端代码里直接嵌入了 Supabase 的匿名访问凭证去查询 plus_library_apps 与 plus_repos。这在 Supabase 生态中属于标准前端用法,但整站的安全性高度依赖数据库端行级安全策略(RLS)与 Edge Function 鉴权是否严谨——一旦某张配置表或清理接口漏配写权限,就可能被恶意调用。
  2. 第三方源生命周期不可控:尽管 iosboom.com 本身配有 plus_repo_hidden_apps 与坏图隐藏机制,但诸如 AppTesters、IPAOMTK、Minoa's Combined 等外部源的下载直链仍可能受上游网盘失效、GitHub 限流或开发者撤包影响。
  3. Apple 证书吊销与版权合规博弈:/app/Feather 等详情页底部明确带有社区归档免责声明与 DMCA 投诉邮箱;而平台提供的免费共享证书(plus_has_active_free_cert)本质上处于苹果企业签 OCSP 吊销的高频拉锯战中,稳定性远不如绑死自己设备 UDID 的独立开发者证书。

五、总结:Web 侧载门户的现代架构范式

拆完 iosboom.com/ipa-library 及其底层模块,我最大的收获并不是“又多了一个下载 IPA 的网站”,而是看到了一套非常清晰的现代 Serverless + 流式前端侧载门户范式:

  • 用 Supabase + R2 预签名 解决多租户配置热更新与大体积 IPA 中转瓶颈;
  • 用 256 KB 字节流括号状态机 + 400 条阈值 SWR 缓存 + CORS 边缘回退,硬生生把动辄数 MB 的第三方社区 JSON 源驯服出了原生 App 般的秒开体验;
  • 用 Safari MobileConfig + 双引擎 SSE/轮询签名 Worker + itms-services://,把原本需要 Mac、Xcode 和终端命令行的 iOS 重签流程压缩成普通用户点三下屏幕就能完成的操作。

当然,便利性与信任边界永远是一体两面。如果这类在线签名平台未来能进一步结合 WebAssembly 编译版 zsign 实现纯浏览器本地签名(让 .p12 私钥与密码真正做到“计算不离端”),再辅以 WebCrypto 加密的 IndexedDB 凭据库,它的安全底座才算真正与它的前端工程水准齐平。


原文链接与参考资料