Files
runaway/README.zh-CN.md
T

530 lines
19 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# runaway
单脚本 macOS MDM 绕过工具。可在恢复模式下运行,支持 Apple Silicon 和 Intel。
> 语言:[English](README.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://raw.githubusercontent.com/mateussiqueira/runaway/main/runaway-standalone.sh -o /tmp/runaway
chmod +x /tmp/runaway && /tmp/runaway bypass
```
---
## 命令
### bypass — 完整 MDM 绕过(仅限恢复模式)
```bash
./runaway bypass
```
创建临时管理员账户并压制 MDM。具体做这些事:
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 <path>` | 把日志输出写入文件 |
示例:
```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 <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
该场景仍在调查中。在受影响的外置安装上运行:
```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。