docs: add Simplified Chinese README, English stays default
This commit is contained in:
+529
@@ -0,0 +1,529 @@
|
||||
# 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。
|
||||
Reference in New Issue
Block a user