Erosion-CN README

项目的 README,来自 github.com/Kianuni/Erosion-CN。合并为一个 markdown 文件:README.md。


App Icon

Erosion-CN

基于 worse_query 的 iOS / iPadOS 系统配置与 MobileGestalt 研究工具箱(中英双语 · 防白苹果安全加固版)

支持 iOS / iPadOS 27.0 – 27.2 / 27.3 beta 1(完整支持)以及 iOS / iPadOS 26.x(部分支持)。

简体中文 · English Documentation · AppleFlow 配套分流与排雷台 · AppleLens 观测与排障台

GitHub Releases IPA Downloads GitHub Stars Official AltSource AltGallery Upstream Repo License

Kianuni/Erosion-CN | #2 Swift Repository Of The Day  Kianuni/Erosion-CN | #18 Repository Of The Day


[!WARNING] 系统版本重要提醒(2026-11-17):苹果已于 iOS / iPadOS 27.3 beta 2(Build 24C5049d) 正式封堵 worse_query 沙盒漏洞——升级后将无法读写 MobileGestalt 且已生效的修改会被系统重置。当前最高仅支持至 27.3 beta 1,强烈建议停留在 iOS 27.2.1(功能最完整)并关闭系统自动更新。

项目简介

Erosion-CN 衍生自上游 jailbreakdotparty/Erosion,提供中英双语界面,修复了原版多项真机 Bug,并做了防白苹果安全加固:

v1.0.0 – v1.0.2 核心新特性

📜 完整的技术改进说明与版本历史见 CHANGELOG.md,各版本发布说明见 Releases。
📖 外部独立底层架构解析:《从 worse_query 逃逸到 MobileGestalt 运行时重构:深入 Erosion-CN 的防白苹果原位写入、双重金库与国行底层解锁架构》


系统兼容性

[!IMPORTANT] 操作前请务必通过电脑完整备份设备重要数据!修改系统底层配置存在潜在风险,仅供安全研究与学习交流,请仅在本人持有的设备上使用并自行承担风险。


安装与签名要求

[!WARNING] 本项目底层依赖至少一个有效的 App Group 容器权限。请使用支持保留或注入 App Group 的个人 Apple ID 自签工具(如 SideStore / AltStore / Feather / Sideloadly / Impactor / iLoader)或带 App Group 权限的开发者证书签名安装。

方式一:订阅官方自动更新源(推荐 · 支持一键升级)

在 iPhone / iPad 浏览器中点击下方按钮即可一键添加官方软件源(每次新 Release 发布自动同步,内含 App Group 权限声明与 SHA-256 校验):

Add to SideStore Add to AltStore Add to Feather More Clients

手动添加官方源地址(兼容 SideStore / AltStore / Feather / LiveContainer / ESign):

https://raw.githubusercontent.com/Kianuni/Erosion-CN/main/apps.json

方式二:手动下载 IPA 签名安装

  1. 前往 Releases 页面 下载最新的 Erosion_v1.0.2_Bilingual.ipa。
  2. 使用上述签名工具安装至设备;首次运行可在「主页」日志确认已成功识别 App Group。
  3. 详细使用说明与原厂状态恢复教程请查阅:

常见问题与排障指南 (FAQ / Q&A)

Q1:为什么打开了开关,eSIM 还是没生效?或者国行 18 Pro / 18 Pro Max 改完后「添加 eSIM」反而消失了?

请按以下 6 种情况逐一排查:

  1. 国行 iPhone 18 Pro / 18 Pro Max(A3715 / A3718)插着双实体卡(或背面副卡)触发基带卡槽冲突(18 系列最常见!)
    国行 18 Pro / Pro Max 为特殊的**「正反双实体 SIM 卡槽 + 内置 eSIM」三通道复用硬件**,而美版 LL/A(A3472 / A3473)为无卡槽纯 eSIM 机型(国际版也仅正面单卡槽)。若卡托内插着两张实体卡(或插在卡托背面副卡槽)重启,基带检测到卡槽占用冲突会临时隐藏「添加 eSIM」与 EID(或导致背面副卡不工作)。
    ✅ 真机实测 100% 解决与双实体卡共存步骤(「空卡写卡法」):
    • ① 先拔出 SIM 卡托(不插任何实体卡,保持空卡状态),在 Erosion-CN 开启「解除地区限制」+「解除国行底层限制」点击应用后 空卡关机冷重启(注:若在 27.3 beta 1 空卡下仍隐藏入口,可先关闭上方地区限制、仅单开「解除国行底层限制」空卡重启,「添加 eSIM」必出);
    • ② 空卡开机连 Wi-Fi(挂外区节点 + 开启飞行模式),扫码把需要的海外 eSIM 全部添加完毕;
    • ③ 插回实体卡策略:若平时只需 1 张实体卡 + 多张海外/国内 eSIM,将实体卡装在卡托正面(主卡槽)即可直接共存;若平时还需使用卡托背面第 2 张实体卡,写完海外 eSIM 后进 Erosion-CN 单独关闭「解除国行底层限制」(保留上方「解除地区限制」开启,且自 v0.8.1 起还可在下方修改模式切换为「仅改区域代码 LL(保留 CH/A 后缀与双卡兼容)」以保留原厂 CH/A 与监管型号),应用重启后再插回正反双实体卡——背面实体卡即可恢复工作,且已写入芯片的海外 eSIM 依然完整保留、可随时在设置中切换启用!
  2. 只点了「注销 (Respring)」,没有「手动关机重启」
    「解除国行底层限制」修改的是二进制 CacheData(green-tea 槽位)。负责蜂窝基带与 eUICC 芯片的守护进程(CommCenter、ctkd)在注销桌面时不会重载缓存,甚至会因新旧区域参数半同步导致「添加 eSIM」入口临时隐藏。写入后必须手动滑动关机、等待黑屏后再按电源键开机(冷重启) 才会生效。
  3. 只改了 LL/A,漏开了「解除国行底层限制 (eSIM / FaceTime 音频)」
    常规解锁必须将 「解除地区限制(国行 AI / 美版 LL/A)」 与下方的 「解除国行底层限制 (eSIM / FaceTime 音频)」 两个开关同时打开并冷重启;若只改了上方的 LL/A 而未解开下方的 green-tea 硬件锁,系统校验区域冲突同样会屏蔽 eSIM 菜单。
  4. 误开了「机型伪装 (ProductType)」或曾用其他改机工具盲改过缓存
    原生 AI 机型严禁修改机型标识符(如把国行主板 iPhone19,7 强改成美版 iPhone19,3),否则基带校验失配会导致整个 eSIM 菜单消失。若之前被其他工具改坏,请点击 MobileGestalt 右上角 ⋯ →「清除并重建缓存」 并重启恢复纯净原厂基线,再重新按需开启开关。
  5. 在中国大陆境内扫码添加海外 eSIM 时提示“不支持 / 无法激活”
    若「添加 eSIM」按钮已出现,但扫码瞬间被拦截,是系统激活时通过境内基站/定位触发了位置校验。扫码写卡时请开启 飞行模式 + 连接 Wi-Fi(挂全局海外代理)(必要时临时关闭 设置 → 隐私与安全性 → 定位服务 → 系统服务 中的「蜂窝网络搜索 / 无线局域网与蓝牙」),写卡成功后再恢复正常即可长期双待使用。
  6. 老款纯双实体卡槽国行机型的物理硬件限制
    仅自带物理 eUICC 安全芯片的国行机型(如 国行 iPhone Air、内置物理 eSIM 的 iPhone 18 系列 等)支持解锁海外 eSIM 自由扫码;早期纯双实体 nano-SIM 卡槽且主板物理空焊 eUICC 芯片的常规国行机型属于硬件缺失,开启该开关仅用于解锁 FaceTime 音频(语音通话) 与 AI 区域准入,无法凭空生成物理 eSIM 芯片。

Q2:需要开启「监管模式 (Supervision)」吗?以前别的工具留下的伪监管怎么清理?

Q3:满血使用 Apple Intelligence + ChatGPT(同时保留国行普通话「询问来电原因」)怎么设地区和代理规则?

Q4:Siri 聊天已经正常了,为什么「跑马灯视觉智能 (Visual Intelligence)」、「相机内嵌 SIRI 档位」或图乐园提示不可用?

首先注意 iOS 27 中两套视觉入口的底层架构完全不同:

Q5:为什么解锁国行限制或开启「将“无线局域网”显示为“Wi-Fi”」后,单应用「不允许联网」不见了?

在 iOS 26/27 中,国行独有的单应用三态联网菜单(关闭 / 无线局域网 / 无线局域网与蜂窝数据)同时受底层 green-tea(国行硬件门控)与 wapi(无线局域网命名与 WAPI 开关)共同控制——因此无论是开启「解除国行底层限制」(解锁 Apple 智能与 FaceTime 音频必需)还是开启「将“无线局域网”显示为“Wi-Fi”」,系统网络权限都会切换为国际版逻辑(仅允许单独关闭单个 App 的「蜂窝数据」,不再提供禁止单应用使用 Wi-Fi 的入口)。如需恢复国行「不允许联网」菜单,关闭对应开关重新应用并重启即可恢复。

Q6:为什么照片「快速消除」正常,但「高质量消除 / 扩图延伸 / 重构」报错?另外要不要升新测试版?

可根据报错弹出的速度 1 秒区分是本地槽位问题还是网络限流问题:

Q7:自签证书 7 天过期、卸载重装 App 会导致修改失效或丢失原厂备份吗?

Q8:还有哪些特性属于纯物理硬件或非缓存 (slot = -1) 限制,改 MobileGestalt 也无法解锁?

Q9:点击应用时报 result: -1 写入失败,或者「关于本机」已变 LL/A 但 AI 菜单仍未出现怎么办?

Q10:万一改出异常,或者之前被别的工具改出「相机黑屏 / eSIM 消失」,怎么一键救回?


自行编译

在安装有 Xcode 26 / 27 的 macOS 环境中克隆本仓库并执行构建脚本即可生成未签名 .ipa(已自动内嵌标准 entitlements):

git clone https://github.com/Kianuni/Erosion-CN.git
cd Erosion-CN
chmod +x ipabuild.sh
./ipabuild.sh

协同生态 (Ecosystem)

Erosion-CN(底层准入)、AppleFlow(零 MitM 分流)与 AppleLens(macOS 观测与 USB 排障)共同组成面向 Apple Intelligence 的完整开源工具链;此外,也欢迎搭配 Kianuni 旗下的其他安全、隐私与个性化开源工具(全部开源透明、无暗桩):

  [1. Erosion-CN] 底层准入 ──▶ [2. AppleFlow] 零 MitM 分流 ──▶ [3. AppleLens] macOS 观测 · 探针 · 报告解读
项目 定位与核心特性 适用系统 / 场景
AppleFlow 零 MitM 的 Apple 智能、PCC 隐私云计算与中文 Siri 极简分流方案,附带 在线配置体检与出口探针台 Surge / Loon / Shadowrocket / Stash / Mihomo / QX / Sing-box
AppleLens 零 MitM、纯只读的 macOS 原生 Apple 智能三态雷达、USB 真机日志翻译排障、四路分流探针与透明报告解读工作台 macOS 14.0+ 桌面端 / CLI / USB 连线 iPhone 排障
WQGuard 100% 只读开源的沙盒越权检测、侧载 IPA 安全审查与固件 CVE 防护工具 iOS / iPadOS 26.2+ – 27.x 侧载排雷与设备自检
Camlo Camlo · 开幕 — 免电脑一键换上滑动解锁变身、裸眼 3D 与动态锁屏壁纸,让 iPhone 锁屏活起来 iOS / iPadOS 26 – 27 个性化锁屏美化
Enkard 纯离线、零云同步、绑定 Apple Secure Enclave 硬件安全芯片的 iPhone 银行级加密卡包 个人隐私卡券 / 敏感凭据本地加密收纳

致谢与开源许可 (Credits & License)

本项目基于 GNU General Public License v3.0 (GPLv3) 开源,谨向上游作者与社区研究者致以诚挚感谢:


Star History

Star History Chart

免责声明

本项目仅供 iOS 系统安全研究、逆向工程学习与技术交流使用。请严格遵守所在地法律法规与电信合规要求,切勿用于任何非法用途;开发者不对因使用本软件造成的任何数据丢失、功能异常或售后问题承担责任。

Erosion-CN (Kianuni/Erosion-CN)

正在搜索数据库…

这是什么?这是 Erosion iOS/iPadOS 工具包的简体中文分支版本,用于读取和编辑 MobileGestalt 系统设置,并提供应用数据备份和缓存清理功能,面向安全研究与学习。
这是我要安装的应用,还是一个库?这是一个应用。你可以在设备上安装预编译的 .ipa 文件,也可以在 Mac 上用 Xcode 自行构建未签名的 .ipa。
我该怎么把它装到设备上?从 Releases 下载最新的 Erosionv0.7.2zh-Hans.ipa,并使用 SideStore、AltStore、Feather、Sideloadly、Impactor 或 iLoader 等签名工具进行安装。首次启动时,请在首页标签的日志中确认已检测到 App Group。
安装前我需要准备什么?需要一个能保留 App Group 权限(entitlements)的签名工具,并配合个人 Apple ID 或具有 App Group 权限的开发者证书使用。从源码构建则需要一台安装了 Xcode 26 或 27 的 Mac。
它会损坏我的设备吗?会。修改底层系统配置存在真实风险,因此请先将设备备份到电脑上,并且只在你自己拥有的硬件设备上使用。作者不对任何数据丢失承担责任。
它支持哪些 iOS 版本?完整支持涵盖 iOS/iPadOS 27.0 至 27.2.1 以及 27.3 beta 1。iOS/iPadOS 26.0 至 26.7.2 仅获得部分支持,例如壁纸、拨号界面外观和容器浏览,不支持写入 MobileGestalt。
与上游的 Erosion 相比,这个分支修复了哪些问题?它修复了重启后会被还原的更改,以及由 plist 编辑器误读布尔值和浮点值而导致的相机黑屏问题。此外,它还提供完整的简体中文界面。
写入之后,它如何避免留下损坏或空白的系统文件?它会从偏移量 0 开始原地覆盖文件,必要时截断文件末尾,并使用 FFULLFSYNC 强制将数据刷入磁盘。随后它会回读文件进行校验,一旦发现不一致就自动回滚。
它能管理应用数据并清理缓存吗?可以。应用数据备份视图会将 Documents 和 Library/Preferences 打包成 zip 文件,用于备份和恢复。缓存清理工具可按应用单独或批量清理 Library/Caches 和 tmp 目录,并保护 Documents 和登录数据不被删除。
最新版本带来了哪些值得注意的功能?v0.7.2 新增了 MGInspector 探测工具,可将实时 MobileGestalt 值与原始备份进行比较,还新增了 Apple Intelligence 检查面板。此外,它还解锁了相机音频混合、空间音频录制和健康应用高血压趋势模式。
有哪些类似的项目?WQFiles, 3105, macos-sysdata, AirBeep, GestaltX, ipadn, FilzaSlop, Ketamine
作者
Kianuni
大小
1.4 MB
星标
2.3K
时长
8天
提交 · 90 天