19 KiB
runaway
单脚本 macOS MDM 绕过工具。可在恢复模式下运行,支持 Apple Silicon 和 Intel。
我做这个项目,是因为原先的 bypass-mdm 项目有五个不同的脚本(v2、v3、express、dualboot.sh、verify.sh),选项各有出入,而且没有一个能处理迁移助理之后的完整问题。本项目用一个文件把它们全部替代。
快速开始
- 把
runaway文件夹拷贝到外置 SSD(FAT32、APFS 或 exFAT) - 启动到恢复模式:
- Apple Silicon:按住电源键直到出现"正在载入启动选项",然后点"选项"→"继续"
- Intel:在启动声响起时按 Cmd+R
- 从"实用工具"菜单打开"终端"
- 运行:
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。具体做这些事:
- 查找并挂载 macOS 数据卷
- 需要时解锁 FileVault(会询问密码)
- 创建管理员用户(默认 Apple / 1234)
- 删除 DEP 激活记录
- 屏蔽 13 个以上 Apple MDM 域名,外加你所在组织的 MDM 服务器域名
- 停用 4 个注册守护进程
- 清理所有用户主目录中的用户级 MDM 残留
- 写入 .AppleSetupDone,跳过设置助理
suppress — 只压制注册,不建用户
./runaway suppress
与 bypass 相同,但不创建用户。适用于干净绕过被 macOS 更新破坏之后的情况。
admin — 仅创建管理员用户(仅限恢复模式)
./runaway admin
在系统上创建一个隐藏的本地管理员账户,不执行 MDM 绕过或压制。具体做这些事:
- 查找并挂载 macOS 数据卷
- 需要时解锁 FileVault
- 以自定义用户名和密码创建管理员用户
- 条件允许时尝试集成 FileVault;重启后请自行验证
- 通过 dscl 把账户从 macOS 登录窗口隐藏
- 用文件系统标志把该用户的主目录在
/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
在绕过完成后从已登录的桌面运行。它会:
- 终止 ManagedClient、mdmclient、activationd
- 强制移除描述文件
- 逐用户扫描并移除 MDM LaunchAgent
- 刷新 DNS 缓存,重启 mDNSResponder
- 检查钥匙串中的 MDM 身份证书
- 排查 JAMF/Intune/Workspace ONE 代理
- 停用 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 MDMaxm-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 文件。
步骤:
- 在辅助 Mac 上打开 Apple Configurator 2
- 按住电源键的同时用 USB-C 连接被锁的 Mac
- M1/M2:按住电源键 10 秒,连接 USB-C 期间持续按住
- M3/M4:连接期间按住电源键 + 音量减 10 秒
- 被锁的 Mac 会以 DFU 设备的形式出现在 Configurator 中
- 右键 → 高级 → 恢复(选择 IPSW 文件)
- 等待 10-30 分钟完成恢复
- Mac 重启进入设置助理——不要连接 Wi-Fi
- 立即启动到恢复模式(按住电源键)并运行
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。