Files
runaway/README.zh-CN.md
T

19 KiB
Raw Blame History

runaway

单脚本 macOS MDM 绕过工具。可在恢复模式下运行,支持 Apple Silicon 和 Intel。

语言:English | 简体中文 | Português

我做这个项目,是因为原先的 bypass-mdm 项目有五个不同的脚本(v2、v3、express、dualboot.sh、verify.sh),选项各有出入,而且没有一个能处理迁移助理之后的完整问题。本项目用一个文件把它们全部替代。

快速开始

  1. 把 runaway 文件夹拷贝到外置 SSD(FAT32、APFS 或 exFAT)
  2. 启动到恢复模式:
    • Apple Silicon:按住电源键直到出现"正在载入启动选项",然后点"选项"→"继续"
    • Intel:在启动声响起时按 Cmd+R
  3. 从"实用工具"菜单打开"终端"
  4. 运行:
chmod +x "/Volumes/YourSSD/runaway/runaway"
"/Volumes/YourSSD/runaway/runaway"

在菜单里选 "Full bypass"(完整绕过)。如果你清楚自己要什么,也可以直接:

"/Volumes/YourSSD/runaway/runaway" bypass

无需联网。无需关闭 SIP。无需输入长长的 URL。

如果恢复模式下有网络,也可以:

curl -L https://raw.githubusercontent.com/mateussiqueira/runaway/main/runaway-standalone.sh -o /tmp/runaway
chmod +x /tmp/runaway && /tmp/runaway bypass

命令

bypass — 完整 MDM 绕过(仅限恢复模式)

./runaway bypass

创建临时管理员账户并压制 MDM。具体做这些事:

  1. 查找并挂载 macOS 数据卷
  2. 需要时解锁 FileVault(会询问密码)
  3. 创建管理员用户(默认 Apple / 1234)
  4. 删除 DEP 激活记录
  5. 屏蔽 13 个以上 Apple MDM 域名,外加你所在组织的 MDM 服务器域名
  6. 停用 4 个注册守护进程
  7. 清理所有用户主目录中的用户级 MDM 残留
  8. 写入 .AppleSetupDone,跳过设置助理

suppress — 只压制注册,不建用户

./runaway suppress

与 bypass 相同,但不创建用户。适用于干净绕过被 macOS 更新破坏之后的情况。

admin — 仅创建管理员用户(仅限恢复模式)

./runaway admin

在系统上创建一个隐藏的本地管理员账户,不执行 MDM 绕过或压制。具体做这些事:

  1. 查找并挂载 macOS 数据卷
  2. 需要时解锁 FileVault
  3. 以自定义用户名和密码创建管理员用户
  4. 条件允许时尝试集成 FileVault;重启后请自行验证
  5. 通过 dscl 把账户从 macOS 登录窗口隐藏
  6. 用文件系统标志把该用户的主目录在 /Users 中隐藏

heal — 检查并重新应用

sudo ./runaway heal       # 在已启动的系统里
./runaway heal            # 在恢复模式里

检查压制是否仍然完好。任何一环(DEP 标记、hosts 屏蔽、守护进程停用)被重置,都会重新应用。可放心反复运行。

persist — 开机自动修复

sudo ./runaway persist

安装 LaunchDaemon 到 /Library/LaunchDaemons/com.runaway.heal.plist,在每次开机以及其后每 24 小时运行一次 runaway heal。日志写入 /var/log/runaway-heal.log。

在升级 macOS 之前使用它。更新完成重启后,heal 会自动运行,把更新重置的内容重新应用一遍。

unpersist — 移除自动修复

sudo ./runaway unpersist

移除该 LaunchDaemon 并卸载它。

firewall — 内核级 MDM 封锁

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 — 移除防火墙

sudo ./runaway firewall-off

清空 Runaway 的 pf anchor 并还原 pf.conf。

whitelist — 只封锁 MDM,保留 iCloud

sudo ./runaway whitelist

firewall 的替代方案:只把必需的 MDM 域名(mdmenrollment.apple.com、deviceenrollment.apple.com、iprofiles.apple.com)解析成 IP 并封锁,其余流量不受影响。iCloud、App Store 和更新应可正常使用。

harden — 在已启动的系统上实时清理

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 — 深度系统扫描

sudo ./runaway audit

全面扫描:已安装的描述文件、注册状态、钥匙串证书、用户 LaunchAgent、系统 LaunchDaemon、运行中的进程、MDM 代理二进制文件、pf 防火墙状态。最后给出风险评分(LOW / MEDIUM / HIGH / CRITICAL)。

status — MDM 健康检查(仅限恢复模式)

./runaway status

显示 DEP 标记、hosts 屏蔽、守护进程覆盖、描述文件注册和备份状态。只能在恢复模式下运行,因为只有在那里才能干净地访问数据卷。

check — 抹盘/升级前评估

sudo ./runaway check

回答这个问题:"如果我抹掉这台 Mac,它会被锁吗?" 检查 DEP 记录、描述文件、注册状态、防火墙和持久化。同时做升级安全检查——告诉你升级 macOS 之前 persist 和 firewall 是否已安装。

返回两种结论之一:

  • SAFE TO FORMAT(可以抹盘) — 未检测到 MDM 注册
  • MDM DETECTED(检测到 MDM) — 抹盘后这台 Mac 会锁定。之后从恢复模式运行 bypass。

monitor — 后台 MDM 监视器

sudo ./runaway monitor

启动一个守护进程,每 5 分钟检查一次 MDM 状态。一旦检测到 MDM 试图重新注册(出现 DEP 记录、hosts 屏蔽丢失、注册重新激活),就自动修复并发送 macOS 通知。

sudo ./runaway monitor-stop      # 停止
sudo ./runaway monitor-status    # 查看是否在运行

日志写入 /var/log/runaway-monitor.log。该守护进程重启后不会自行存活——与 persist 配合可实现持久化。

backup / restore — 状态保存

./runaway backup
./runaway restore

备份会把 hosts、配置描述文件和 launchd 覆盖保存到 .runaway-backup/。restore 将其还原。

dualboot — 外置卷目标

sudo ./runaway dualboot

与 bypass 相同,但允许你选择目标卷(用于外置 macOS 安装或双系统)。会提示输入系统和数据卷名称。

version / help

./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 <path> 把日志输出写入文件

示例:

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 网络要求。

第 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 获取。

日志

所有命令都带时间戳和级别记录日志:

[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 <path> 把全部内容写入文件。

文件结构

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

该场景仍在调查中。在受影响的外置安装上运行:

./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 官方文档记载了分机型的外置安装说明以及可能的 USB 3/Thunderbolt 3 无线干扰。这些是调查线索,不是确认的原因。如果要对比启动盘线缆或扩展坞,先关机再更换连接;不要拔掉正在使用的启动盘。

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。