# runaway 单脚本 macOS MDM 绕过工具。可在恢复模式下运行,支持 Apple Silicon 和 Intel。 > 语言:[English](README.md) | **简体中文** | [日本語](README.ja.md) | [Português](README.pt-BR.md) 我做这个项目,是因为原先的 bypass-mdm 项目有五个不同的脚本(v2、v3、express、dualboot.sh、verify.sh),选项各有出入,而且没有一个能处理迁移助理之后的完整问题。本项目用一个文件把它们全部替代。 ## 快速开始 1. 把 `runaway` 文件夹拷贝到外置 SSD(FAT32、APFS 或 exFAT) 2. 启动到恢复模式: - **Apple Silicon**:按住电源键直到出现"正在载入启动选项",然后点"选项"→"继续" - **Intel**:在启动声响起时按 Cmd+R 3. 从"实用工具"菜单打开"终端" 4. 运行: ```bash chmod +x "/Volumes/YourSSD/runaway/runaway" "/Volumes/YourSSD/runaway/runaway" ``` 在菜单里选 "Full bypass"(完整绕过)。如果你清楚自己要什么,也可以直接: ```bash "/Volumes/YourSSD/runaway/runaway" bypass ``` 无需联网。无需关闭 SIP。无需输入长长的 URL。 如果恢复模式下有网络,也可以: ```bash curl -L https://git.jskdjs.cn/ruihan/runaway/raw/branch/main/runaway-standalone.sh -o /tmp/runaway chmod +x /tmp/runaway && /tmp/runaway bypass ``` --- ## 命令 ### bypass — 完整 MDM 绕过(仅限恢复模式) ```bash ./runaway bypass ``` 创建临时管理员账户并压制 MDM。用户名和密码走交互式输入(直接回车用默认值 `Apple` / `1234`);无人值守场景可以用参数直接传入: ```bash ./runaway bypass --username me --password 'hunter2!' --full-name "My Name" ``` 注意 `--password` 会留在 shell 历史和进程列表里,手动操作时建议还是用交互输入。具体做这些事: 1. 查找并挂载 macOS 数据卷 2. 需要时解锁 FileVault(会询问密码) 3. 创建管理员用户(默认 Apple / 1234) 4. 删除 DEP 激活记录 5. 屏蔽 13 个以上 Apple MDM 域名,外加你所在组织的 MDM 服务器域名 6. 停用 4 个注册守护进程 7. 清理所有用户主目录中的用户级 MDM 残留 8. 写入 .AppleSetupDone,跳过设置助理 ### suppress — 只压制注册,不建用户 ```bash ./runaway suppress ``` 与 bypass 相同,但不创建用户。适用于干净绕过被 macOS 更新破坏之后的情况。 ### admin — 仅创建管理员用户(仅限恢复模式) ```bash ./runaway admin ``` 在系统上创建一个隐藏的本地管理员账户,不执行 MDM 绕过或压制。具体做这些事: 1. 查找并挂载 macOS 数据卷 2. 需要时解锁 FileVault 3. 以自定义用户名和密码创建管理员用户 4. 条件允许时尝试集成 FileVault;重启后请自行验证 5. 通过 dscl 把账户从 macOS 登录窗口隐藏 6. 用文件系统标志把该用户的主目录在 `/Users` 中隐藏 ### heal — 检查并重新应用 ```bash sudo ./runaway heal # 在已启动的系统里 ./runaway heal # 在恢复模式里 ``` 检查压制是否仍然完好。任何一环(DEP 标记、hosts 屏蔽、守护进程停用)被重置,都会重新应用。可放心反复运行。 ### persist — 开机自动修复 ```bash sudo ./runaway persist ``` 安装 LaunchDaemon 到 `/Library/LaunchDaemons/com.runaway.heal.plist`,在每次开机以及其后每 24 小时运行一次 `runaway heal`。日志写入 `/var/log/runaway-heal.log`。 在升级 macOS 之前使用它。更新完成重启后,heal 会自动运行,把更新重置的内容重新应用一遍。 ### unpersist — 移除自动修复 ```bash sudo ./runaway unpersist ``` 移除该 LaunchDaemon 并卸载它。 ### firewall — 内核级 MDM 封锁 ```bash sudo ./runaway firewall ``` 创建 pf 防火墙规则,丢弃发往 Apple MDM IP 段(17.0.0.0/8 和 17.128.0.0/10)的流量。pf 工作在 DNS 之下——DNS-over-HTTPS 无法绕过。 **警告**:这会屏蔽所有 Apple 服务。防火墙生效期间,iCloud、App Store 和系统更新都会失效。如果需要这些,请改用 `whitelist`。 ### firewall-off — 移除防火墙 ```bash sudo ./runaway firewall-off ``` 清空 Runaway 的 pf anchor 并还原 pf.conf。 ### whitelist — 只封锁 MDM,保留 iCloud ```bash sudo ./runaway whitelist ``` `firewall` 的替代方案:只把必需的 MDM 域名(mdmenrollment.apple.com、deviceenrollment.apple.com、iprofiles.apple.com)解析成 IP 并封锁,其余流量不受影响。iCloud、App Store 和更新应可正常使用。 ### harden — 在已启动的系统上实时清理 ```bash sudo ./runaway harden ``` 在绕过完成后从已登录的桌面运行。它会: 1. 终止 ManagedClient、mdmclient、activationd 2. 强制移除描述文件 3. 逐用户扫描并移除 MDM LaunchAgent 4. 刷新 DNS 缓存,重启 mDNSResponder 5. 检查钥匙串中的 MDM 身份证书 6. 排查 JAMF/Intune/Workspace ONE 代理 7. 停用 iCloud 私人中继(一个 DoH 漏洞入口) ### audit — 深度系统扫描 ```bash sudo ./runaway audit ``` 全面扫描:已安装的描述文件、注册状态、钥匙串证书、用户 LaunchAgent、系统 LaunchDaemon、运行中的进程、MDM 代理二进制文件、pf 防火墙状态。最后给出风险评分(LOW / MEDIUM / HIGH / CRITICAL)。 ### status — MDM 健康检查(仅限恢复模式) ```bash ./runaway status ``` 显示 DEP 标记、hosts 屏蔽、守护进程覆盖、描述文件注册和备份状态。只能在恢复模式下运行,因为只有在那里才能干净地访问数据卷。 ### check — 抹盘/升级前评估 ```bash sudo ./runaway check ``` 回答这个问题:**"如果我抹掉这台 Mac,它会被锁吗?"** 检查 DEP 记录、描述文件、注册状态、防火墙和持久化。同时做升级安全检查——告诉你升级 macOS 之前 `persist` 和 `firewall` 是否已安装。 返回两种结论之一: - **SAFE TO FORMAT(可以抹盘)** — 未检测到 MDM 注册 - **MDM DETECTED(检测到 MDM)** — 抹盘后这台 Mac 会锁定。之后从恢复模式运行 bypass。 ### monitor — 后台 MDM 监视器 ```bash sudo ./runaway monitor ``` 启动一个守护进程,每 5 分钟检查一次 MDM 状态。一旦检测到 MDM 试图重新注册(出现 DEP 记录、hosts 屏蔽丢失、注册重新激活),就自动修复并发送 macOS 通知。 ```bash sudo ./runaway monitor-stop # 停止 sudo ./runaway monitor-status # 查看是否在运行 ``` 日志写入 `/var/log/runaway-monitor.log`。该守护进程重启后不会自行存活——与 `persist` 配合可实现持久化。 ### backup / restore — 状态保存 ```bash ./runaway backup ./runaway restore ``` 备份会把 hosts、配置描述文件和 launchd 覆盖保存到 `.runaway-backup/`。restore 将其还原。 ### dualboot — 外置卷目标 ```bash sudo ./runaway dualboot ``` 与 bypass 相同,但允许你选择目标卷(用于外置 macOS 安装或双系统)。会提示输入系统和数据卷名称。 ### version / help ```bash ./runaway version ./runaway help ``` --- ## 别名 每个命令都有更短的别名: | 别名 | 完整命令 | |-------|-------------| | `by` | bypass | | `sv` | suppress | | `st`, `ls` | status | | `fw` | firewall | | `fw-off` | firewall-off | | `wl` | whitelist | | `mn` | monitor | | `mn-stop` | monitor-stop | | `mn-st` | monitor-status | --- ## 选项 可放在任何命令前的全局选项: | 选项 | 作用 | |--------|--------| | `--verbose` | 显示调试消息 | | `--log-file ` | 把日志输出写入文件 | 示例: ```bash sudo ./runaway --verbose --log-file /tmp/runaway.log heal ``` --- ## 工作原理 macOS 上的 MDM 注册分四层。Runaway 逐一处理。 ### 第 1 层:DEP 激活记录 当组织在 Apple Business Manager 中分配一台设备时,macOS 会创建标记文件: ``` /private/var/db/ConfigurationProfiles/Settings/ .cloudConfigHasActivationRecord ← "此序列号有 DEP" .cloudConfigRecordFound ← "注册已被触发" .cloudConfigTimerCheck ← "稍后再次检查" ``` Runaway 会删除这些文件,并创建诱饵文件(`.cloudConfigRecordNotFound`、`.cloudConfigProfileInstalled`)来表示"无需注册"。 ### 第 2 层:网络封锁 注册客户端要联系 Apple 服务器下载 MDM 描述文件。没有网络访问,注册就无法完成。 Runaway 通过 `/etc/hosts` 屏蔽: - `iprofiles.apple.com` — 描述文件下发 - `deviceenrollment.apple.com` — DEP 服务 - `mdmenrollment.apple.com` — MDM 服务 - `acmdm.apple.com` — Apple Configurator MDM - `axm-adm-mdm.apple.com` — ACM 注册 - `albert.apple.com` — ABM 设备分配 - `gdmf.apple.com` — 软件更新目录 - `xp.apple.com` — 设备管理 - `gs.apple.com` — 软件更新 - `tb.apple.com` — 设备信任 - `vpp.itunes.apple.com` — 批量采购 - 你所在组织的 MDM 服务器(从 DEP 记录中提取) IPv4(0.0.0.0)和 IPv6(::)条目都会添加。 列表中的部分主机同时提供一般 Apple 服务。屏蔽软件更新相关主机可能影响更新;这与 Wi-Fi 无线故障是两回事。用于 Rosetta 2 更新的 `configuration.apple.com` 已不再屏蔽。参见 [Apple 网络要求](https://support.apple.com/en-gb/101555)。 ### 第 3 层:launchd 守护进程覆盖 macOS 注册了开机运行的注册守护进程: | 守护进程 | 作用 | |--------|-------------| | `com.apple.ManagedClient.enroll` | 主注册流程 | | `com.apple.ManagedClient.cloudConfiguration` | 云配置 | | `com.apple.mdmclient.daemon.runatboot` | MDM 客户端 | | `com.apple.activationd` | 设备激活 | Runaway 通过 `/private/var/db/com.apple.xpc.launchd/disabled.plist` 中的 launchd 覆盖来停用它们。 ### 第 4 层:用户级清理 用户主目录里携带会在登录后触发重新注册的 MDM 残留: ``` ~/Library/Preferences/com.apple.mdm.* ~/Library/Preferences/com.apple.ManagedClient.* ~/Library/Application Support/com.apple.ManagedClient*/ ~/Library/LaunchAgents/com.apple.mdm.* ``` Runaway 会从数据卷上的每个主目录中移除它们。这是大多数脚本遗漏的一步——也是迁移助理之后 MDM 卷土重来的原因。 ### 第 5 层:pf 防火墙(可选) hosts 文件可以被 DNS-over-HTTPS 或缓存的 DNS 绕过。pf(包过滤器)在内核层工作,对两者免疫。Runaway 安装的 pf 规则有两种模式: - **firewall**:封锁 Apple 整个 IP 段(17.0.0.0/8 + 17.128.0.0/10)——激进但 100% 有效 - **whitelist**:只把 MDM 域名解析成 IP 并针对性封锁——保留 iCloud 可用 ## Intel 与 Apple Silicon 对比 | | Intel T2 | Apple Silicon | |---|---|---| | 恢复模式 | 开机按 Cmd+R | 按住电源键 | | 系统卷 | 关闭 SIP 后可写 | 加密签名(SSV)——只读 | | FileVault 解锁 | diskutil apfs unlockVolume | 相同,但需要用户密码或恢复密钥 | | 注册守护进程 | 较少 | activationd + cloudConfig | | NVRAM 标志 | 部分存在 | 更多固件级标志 | | 迁移助理 | 风险较低 | **会携带 MDM 状态**——见下文 | 在 Apple Silicon 上,所有写入都针对数据卷。系统卷永不被修改。无需关闭 SIP。 ## 迁移助理导致的失败 这是 MDM 卷土重来最常见的原因。 从 Intel Mac 迁移到 Apple Silicon(或在两台 Apple Silicon Mac 之间迁移)时,迁移助理会复制: - DEP 激活记录 - 已注册的配置描述文件 - 用户级 MDM 偏好设置和缓存 - 重新触发注册的 launch agent - 钥匙串身份证书 旧的绕过脚本只清理系统级残留(DEP 标记、hosts、launchd)。用户级内容被复制过去后,每次登录都会重建注册。 ### 症状 - 首次重启后出现"远程管理"画面 - 运行 suppress 后暂时消失 - 登录后约一分钟内 MDM 描述文件再次出现 ### 解决办法 **从恢复模式**:运行 `runaway bypass`(或 `suppress`)。同时清理系统级和用户级残留。 **如果 MDM 仍然回来**:正常启动,登录后立即运行 `sudo ./runaway harden`。它会在 MDM 进程重建之前终止它们并移除描述文件。 **预防**:在迁移助理之前运行 `sudo ./runaway persist` 和 `sudo ./runaway whitelist`。LaunchDaemon + pf 规则能在迁移中存活,拦住漏网之鱼。 ## 彻底无法绕过时:DFU / IPSW 恢复 如果 MDM 连恢复模式都破不掉——设备可能需要完整的固件恢复。仅适用于 Apple Silicon Mac。 **你需要**:另一台装有 Apple Configurator 2(App Store 免费下载)的 Mac、一根 USB-C 线,以及对应你 Mac 型号的 IPSW 文件。 **步骤**: 1. 在辅助 Mac 上打开 Apple Configurator 2 2. 按住电源键的同时用 USB-C 连接被锁的 Mac - M1/M2:按住电源键 10 秒,连接 USB-C 期间持续按住 - M3/M4:连接期间按住电源键 + 音量减 10 秒 3. 被锁的 Mac 会以 DFU 设备的形式出现在 Configurator 中 4. 右键 → 高级 → 恢复(选择 IPSW 文件) 5. 等待 10-30 分钟完成恢复 6. Mac 重启进入设置助理——**不要连接 Wi-Fi** 7. 立即启动到恢复模式(按住电源键)并运行 `runaway bypass` **这会抹掉所有数据。** IPSW 文件可在 [ipsw.me](https://ipsw.me) 获取。 ## 日志 所有命令都带时间戳和级别记录日志: ``` [INF] Data volume: /Volumes/Macintosh HD - Data [ OK] Admin 'apple' created (UID 501) [WRN] DEP activation record present [ERR] Firewall needs sudo: sudo ./runaway firewall [STP] Locating Data volume by APFS role... [DBG] Checking pfctl availability ``` 用 `--verbose` 查看调试消息,用 `--log-file ` 把全部内容写入文件。 ## 文件结构 ``` runaway/ ├── runaway # 主脚本(入口) ├── lib/ │ ├── colors.sh # 日志、颜色、交互提示 │ ├── detect.sh # 恢复模式检测、卷挂载 │ ├── validate.sh # 用户名/密码校验 │ ├── dscl.sh # 目录服务(用户增删改) │ ├── suppress.sh # DEP 移除、hosts、守护进程停用 │ ├── backup.sh # 备份与还原 │ ├── status.sh # 健康检查与审计 │ ├── heal.sh # 自动修复 + LaunchDaemon 持久化 │ ├── firewall.sh # pf 规则管理 │ ├── harden.sh # 运行中系统的加固 │ ├── whitelist.sh # 保留 iCloud 的选择性封锁 │ ├── check.sh # 抹盘前评估 │ └── monitor.sh # 后台 MDM 监视器 ├── README.md ├── CONTRIBUTING.md ├── CODE_OF_CONDUCT.md ├── SECURITY.md ├── CHANGELOG.md └── LICENSE (MIT) ``` 独立单文件版(`runaway-standalone.sh`)把所有内容打包进一个文件。用 `bash examples/build-standalone.sh` 构建。 ## 局限性 - **序列号仍留在 ABM 里。** 只有组织能移除它。如果设备在所有防护被移除后联网,它会重新注册。 - **完整抹盘后需要重跑。** 干净安装会清空数据卷。之后启动到恢复模式再运行一次 bypass。 - **macOS 更新可能重置守护进程。** 更新前务必运行 `persist`,让 heal 在更新后自动运行。 - **profiles status 可能显示已注册。** 这只是表象——SSV 只读保存描述文件状态。DEP 标记和守护进程停用优先级更高。 - **hosts 文件可被绕过。** DNS-over-HTTPS 和缓存 DNS 能绕过 `/etc/hosts`。需要内核级方案时用 `firewall` 或 `whitelist`。 ## 安全性 Runaway 的设计原则是安全: - **不写 SSV** — 所有改动都针对数据卷 - **可逆** — `backup` 保存状态,`restore` 还原 - **不抹数据** — 从不运行 `profiles renew` 或擦除命令 - **幂等** — 多次运行无害 - **破坏性操作前会请求确认** ## 故障排查 ### 重启后 MDM 又回来了 从恢复模式运行 `runaway suppress`。如果仍然回来,说明有迁移助理残留。在已启动的系统里运行 `runaway harden`。 ### profiles 显示已注册 表象而已。SSV 保存着描述文件状态,但注册守护进程已停用。运行 `runaway status` 查看数据卷上的真实状态。 ### FileVault 解锁失败 你需要某个用户密码或 FileVault 恢复密钥。两者都没有的话,恢复模式无法挂载数据卷。 ### "Not a macOS Data volume"(不是 macOS 数据卷) Runaway 会在挂载的卷上检查 `/private/var/db/dslocal/nodes/Default`。如果不存在,说明挂错了磁盘。运行 `diskutil list` 找到正确的那个。 ### macOS 27 及更高版本 目前有两个 macOS 27.2 的正面社区报告: - 有报告称 Runaway 2.0.0 在从现有 Sequoia 环境升级的 M1 Pro 上正常工作。这不是全新安装。 - 有报告称基础命令在 MacBook Neo(Apple A18 Pro)上正常工作。 这些报告不能证明对每个构建、命令或恢复模式/FileVault 场景的支持。两份报告都没有完整的测试矩阵。Shell 回归测试与硬件验证是两回事。 ### 外置启动盘上的 Wi-Fi 该场景仍在调查中。在受影响的外置安装上运行: ```bash ./runaway doctor --network ``` 这个只读命令会报告 macOS 构建、Wi-Fi 接口、电源、链路和 IPv4 类别,不会打印 SSID、硬件地址或 IP 地址。查询失败与"查询成功但没有 Wi-Fi 端口"会分开报告。 - `Link status: inactive` 关乎接口链路,先于互联网可达性。 - `Wi-Fi IPv4: link-local` 表示 169.254 地址;`none` 表示没有报告非零 IPv4 地址。两者都不能诊断 IPv6 连通性。 - `Wi-Fi IPv4: configured` 不能证明 DNS 或互联网可用。 反馈时请附上脚本 commit、Mac 型号、确切的 OS 构建、SSD/线缆/扩展坞连接方式,以及(如果知道)在该外置安装上运行 Runaway 之前 Wi-Fi 是否正常。仅内置安装上 Wi-Fi 正常,无法定位外置安装上变化了什么。 `dualboot` 代码不会直接改写 Wi-Fi 偏好或开关无线。测试保留了模拟的网络偏好,但不能复现 macOS 服务对账户、注册或启动变更的反应。 Apple 官方文档记载了[分机型的外置安装](https://support.apple.com/en-eg/111336)说明以及可能的 [USB 3/Thunderbolt 3 无线干扰](https://support.apple.com/en-us/102319)。这些是调查线索,不是确认的原因。如果要对比启动盘线缆或扩展坞,先关机再更换连接;不要拔掉正在使用的启动盘。 ### monitor 启动不了 检查它是否已在运行(`monitor-status`)。检查权限——它需要 root。查看日志 `/var/log/runaway-monitor.log`。 ## 常见问题 **支持哪些 macOS 版本?** 现有目标是 macOS 12–15 和 26。验证取决于命令、OS 构建和硬件。macOS 27.2 仅有上文所述的有限社区报告;它们不能替代在目标 Mac 上对恢复模式、FileVault 和网络的实测。 **需要关闭 SIP 吗?** 不需要。所有写入都针对数据卷。 **重装系统后还能生效吗?** 不能。干净安装会清空数据卷。重装后请重新运行。 **组织能追踪到吗?** 序列号仍留在 ABM 中。如果设备在注册守护进程被重新启用的情况下联网,它会重新注册。 **需要 iCloud 怎么办?** 用 `whitelist` 代替 `firewall` 或 `suppress`。它只封锁 MDM 端点。 **为什么迁移助理之后 MDM 又回来了?** 迁移助理会复制用户级缓存、偏好设置和 launch agent。Runaway 处理了这一点——迁移后从恢复模式运行 `bypass` 或 `suppress`。 ## 参与贡献 运行 `make ci` 需要 Bash、Python 3.9+、ShellCheck 和 Bats(在 Bats 1.12 上验证过)。测试套件使用临时卷和无副作用的 macOS 命令夹具;不在真实 Mac 硬件上验证行为。 参见 CONTRIBUTING.md。欢迎 PR,尤其是: - 新 macOS 版本兼容性 - 更多 MDM 域名或守护进程标签 - 迁移助理检测 - iCloud / MDM 域名研究 ## 许可证 MIT。