Compare commits

...
4 Commits
Author SHA1 Message Date
ruihan f3a7c6f57d docs: add Korean README
CI / Bash Syntax Check (push) Successful in 7s
CI / Markdown Lint (push) Successful in 10s
CI / ShellCheck (push) Successful in 42s
2026-11-09 12:13:12 +08:00
ruihan 5da405b034 docs: add Japanese README, English stays default
CI / Bash Syntax Check (push) Successful in 3s
CI / Markdown Lint (push) Successful in 6s
CI / ShellCheck (push) Successful in 39s
2026-11-09 11:25:37 +08:00
ruihan d43c23135f feat(bypass): allow --username/--password/--full-name for unattended runs
CI / Bash Syntax Check (push) Successful in 3s
CI / Markdown Lint (push) Successful in 6s
CI / ShellCheck (push) Successful in 2m8s
2026-11-09 11:07:10 +08:00
ruihan 59487b693e ci: make ShellCheck install step failure-proof on heterogeneous runners
CI / Bash Syntax Check (push) Successful in 3s
CI / Markdown Lint (push) Successful in 6s
CI / ShellCheck (push) Successful in 1m6s
2026-11-09 10:55:53 +08:00
12 changed files with 1275 additions and 47 deletions
+7 -10
View File
@@ -12,17 +12,14 @@ jobs:
runs-on: ubuntu-latest runs-on: ubuntu-latest
steps: steps:
- uses: actions/checkout@v7 - uses: actions/checkout@v7
- name: Install ShellCheck - name: Install ShellCheck (best effort)
run: | run: |
if command -v shellcheck >/dev/null 2>&1; then command -v shellcheck >/dev/null 2>&1 && { echo "shellcheck already available"; exit 0; }
echo "shellcheck already available" command -v apt-get >/dev/null 2>&1 || { echo "no apt-get on this runner — ShellCheck will be skipped"; exit 0; }
exit 0 SUDO=""
fi command -v sudo >/dev/null 2>&1 && SUDO="sudo"
if command -v apt-get >/dev/null 2>&1; then $SUDO apt-get update -qq && $SUDO apt-get install -y -qq shellcheck \
sudo apt-get update -qq && sudo apt-get install -y -qq shellcheck || echo "shellcheck install failed — ShellCheck will be skipped"
else
echo "no apt-get on this runner — ShellCheck will be skipped"
fi
- name: Run ShellCheck - name: Run ShellCheck
run: | run: |
command -v shellcheck >/dev/null 2>&1 || { echo "shellcheck unavailable — skipping"; exit 0; } command -v shellcheck >/dev/null 2>&1 || { echo "shellcheck unavailable — skipping"; exit 0; }
+541
View File
@@ -0,0 +1,541 @@
# runaway
macOS 向けシングルスクリプト MDM バイパスツール。リカバリモードから実行でき、Apple Silicon と Intel の両方に対応しています。
> 言語:[English](README.md) | [简体中文](README.zh-CN.md) | **日本語** | [韓国語](README.ko-KR.md) | [Português](README.pt-BR.md)
このプロジェクトを始めた理由は、元の bypass-mdm プロジェクトに 5 つの異なるスクリプト(v2、v3、express、dualboot.sh、verify.sh)があり、それぞれオプションが微妙に異なり、移行アシスタント後の問題を完全に処理できるものが 1 つもなかったからです。本ツールはそれらすべてを 1 つのファイルに置き換えます。
## クイックスタート
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` はシェル履歴やプロセス一覧に残るため、人の目がある環境では
対話式入力を推奨します。bypass が行うこと:
1. macOS データボリュームを検索してマウント
2. 必要に応じて FileVault を解除(パスワードを要求)
3. 管理者ユーザーを作成(デフォルト Apple / 1234)
4. DEP アクティベーションレコードを削除
5. Apple の MDM ドメイン 13 件以上と組織の 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 # リカバリモードから
```
抑制が維持されているか確認します。どこか 1 つでも(DEP マーカー、hosts 遮断、デーモン無効化)リセットされていれば再適用します。何度実行しても安全です。
### persist — 起動時の自動修復
```bash
sudo ./runaway persist
```
`/Library/LaunchDaemons/com.runaway.heal.plist` に LaunchDaemon をインストールし、起動時と以降 24 時間ごとに `runaway heal` を実行します。ログは `/var/log/runaway-heal.log` に出力されます。
macOS のアップグレード前に実行してください。アップデート完了して再起動すると、heal が自動で走り、アップデートにリセットされた項目を再適用します。
### unpersist — 自動修復の削除
```bash
sudo ./runaway unpersist
```
LaunchDaemon をアンロードして削除します。
### firewall — カーネルレベルの MDM 遮断
```bash
sudo ./runaway firewall
```
Apple の MDM 用 IP レンジ(17.0.0.0/8 と 17.128.0.0/10)へのトラフィックを破棄する pf ファイアウォールルールを作成します。pf は DNS より下のレイヤーで動作するため、DNS-over-HTTPS でも回避できません。
**警告**:これは Apple の全サービスを遮断します。ファイアウォールが有効な間、iCloud、App Store、システムアップデートは機能しません。必要な場合は代わりに `whitelist` を使ってください。
### firewall-off — ファイアウォールの削除
```bash
sudo ./runaway firewall-off
```
Runaway の pf アンカーをフラッシュし、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 登録は 4 つのレイヤーで成り立ちます。Runaway はそれぞれに対処します。
### レイヤー 1:DEP アクティベーションレコード
組織が Apple Business Manager でデバイスを割り当てると、macOS は次のマーカーファイルを作成します:
```
/private/var/db/ConfigurationProfiles/Settings/
.cloudConfigHasActivationRecord ← 「このシリアルには DEP がある」
.cloudConfigRecordFound ← 「登録がトリガーされた」
.cloudConfigTimerCheck ← 「後で再確認する」
```
Runaway はこれらを削除し、「登録不要」を示す偽のファイル(`.cloudConfigRecordNotFound`)を作成します。
### レイヤー 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 ルールには 2 つのモードがあります:
- **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 同士)移行すると、移行アシスタントは次をコピーします:
- DEP アクティベーションレコード
- 登録済みの構成プロファイル
- ユーザーレベルの MDM 設定とキャッシュ
- 登録を再トリガーする launch agent
- キーチェーンの識別子証明書
古いバイパススクリプトはシステムレベルの残留(DEP マーカー、hosts、launchd)しかクリーンアップしません。ユーザーレベルのデータがコピーされ、ログインのたびに登録を再構築します。
### 症状
- 初回再起動後に「リモート管理」画面が表示される
- suppress を実行すると一時的に消える
- ログイン後 1 分ほどで 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 ケーブル 1 本、該当 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 # ディレクトリサービス(ユーザー CRUD)
│ ├── suppress.sh # DEP 削除、hosts、デーモン無効化
│ ├── backup.sh # バックアップと復元
│ ├── status.sh # ヘルスチェックと監査
│ ├── heal.sh # 自動修復 + LaunchDaemon 永続化
│ ├── firewall.sh # pf ルール管理
│ ├── harden.sh # ライブ OS の硬化
│ ├── 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`)はすべてを 1 ファイルにまとめたものです。`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 には 2 件の肯定的なコミュニティ報告があります:
- 既存の Sequoia 環境からアップグレードした M1 Pro で Runaway 2.0.0 が動作した報告。新規インストールではありません。
- MacBook Neo(Apple A18 Pro)で基本コマンドが動作した報告。
これらの報告は、すべてのビルド・コマンド・リカバリ/FileVault シナリオでの動作を保証するものではありません。どちらも完全なテストマトリクスを含みません。シェル回帰テストとハードウェア検証は別物です。
### 外付け起動ディスク上の Wi-Fi
このシナリオは調査中です。問題が起きている外付けインストール環境から次を実行:
```bash
./runaway doctor --network
```
この読み取り専用コマンドは、SSID、ハードウェアアドレス、IP アドレスを出力せずに、macOS ビルド、Wi-Fi インターフェイス、電源、リンク、IPv4 カテゴリを報告します。クエリ失敗は、Wi-Fi ポートがない状態での成功とは別々に報告されます。
- `Link status: inactive` は、インターネット到達性より前のインターフェイスリンクに関するものです。
- `Wi-Fi IPv4: link-local` は 169.254 アドレスを示し、`none` は非ゼロの IPv4 アドレスが報告されなかったことを意味します。いずれも IPv6 接続の診断にはなりません。
- `Wi-Fi IPv4: configured` は DNS やインターネット接続を証明しません。
報告する際は、スクリプトのコミット、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 を無効化する必要はありますか?**
いいえ。すべての書き込みはデータボリュームに対して行われます。
**OS の再インストール後も効果は続きますか?**
いいえ。クリーンインストールはデータボリュームを消去します。再インストール後に再実行してください。
**組織に追跡されることはありますか?**
シリアル番号は ABM に残ります。登録デーモンが再度有効な状態でインターネットに接続すると、再登録されます。
**iCloud が必要な場合は?**
`firewall` や `suppress` の代わりに `whitelist` を使ってください。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。
+541
View File
@@ -0,0 +1,541 @@
# runaway
macOS용 단일 스크립트 MDM 바이패스 도구. 복구 모드에서 실행되며 Apple Silicon과 Intel을 모두 지원합니다.
> 언어: [English](README.md) | [简体中文](README.zh-CN.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`는 셸 기록과 프로세스 목록에 남으므로, 남이 볼 수 있는 환경에서는
대화형 입력을 권장합니다. bypass가 수행하는 작업:
1. macOS 데이터 볼륨을 찾아 마운트
2. 필요 시 FileVault 잠금 해제(비밀번호 요청)
3. 관리자 사용자 생성(기본값 Apple / 1234)
4. DEP 활성화 레코드 삭제
5. Apple MDM 도메인 13개 이상과 조직의 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
```
`/Library/LaunchDaemons/com.runaway.heal.plist`에 LaunchDaemon을 설치해 부팅 시와 이후 24시간마다 `runaway heal`을 실행합니다. 로그는 `/var/log/runaway-heal.log`에 기록됩니다.
macOS 업그레이드 전에 실행하세요. 업데이트가 끝나고 재시작하면 heal이 자동으로 실행되어 업데이트가 리셋한 항목을 다시 적용합니다.
### unpersist — 자동 복구 제거
```bash
sudo ./runaway unpersist
```
LaunchDaemon을 언로드하고 제거합니다.
### firewall — 커널 수준 MDM 차단
```bash
sudo ./runaway firewall
```
Apple의 MDM IP 대역(17.0.0.0/8 및 17.128.0.0/10)으로 향하는 트래픽을 차단하는 pf 방화벽 규칙을 만듭니다. pf는 DNS보다 아래 계층에서 동작하므로 DNS-over-HTTPS로도 우회할 수 없습니다.
**경고**: Apple의 모든 서비스가 차단됩니다. 방화벽이 활성화된 동안 iCloud, App Store, 시스템 업데이트가 작동하지 않습니다. 필요하다면 대신 `whitelist`를 사용하세요.
### firewall-off — 방화벽 제거
```bash
sudo ./runaway firewall-off
```
Runaway의 pf 앵커를 플러시하고 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`에 기록됩니다. 이 데몬 alone으로는 재시작 후 유지되지 않습니다. 지속하려면 `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`)을 만듭니다.
### 계층 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끼리) 마이그레이션하면 마이그레이션 지원이 다음을 복사합니다:
- DEP 활성화 레코드
- 등록된 구성 프로파일
- 사용자 수준 MDM 설정과 캐시
- 등록을 재트리거하는 launch agent
- 키체인 식별 인증서
예전 바이패스 스크립트는 시스템 수준 잔여물(DEP 마커, hosts, launchd)만 정리했습니다. 사용자 수준 데이터가 복사되어 로그인할 때마다 등록이 재구축됩니다.
### 증상
- 첫 재시작 후 "원격 관리" 화면 표시
- suppress 실행 시 일시적으로 사라짐
- 로그인 후 약 1분 내 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 케이블 1개, 해당 Mac 모델용 IPSW 파일.
**절차**:
1. 보조 Mac에서 Apple Configurator 2 실행
2. 전원 버튼을 누른 채 USB-C로 잠긴 Mac 연결
- M1/M2: 전원 10초 길게, USB-C 연결 중에도 계속 누르기
- M3/M4: 연결 중 전원 + 볼륨 down 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 # 디렉터리 서비스(사용자 CRUD)
│ ├── suppress.sh # DEP 제거, hosts, 데몬 비활성화
│ ├── backup.sh # 백업과 복원
│ ├── status.sh # 상태 점검과 감사
│ ├── heal.sh # 자동 복구 + LaunchDaemon 지속화
│ ├── firewall.sh # pf 규칙 관리
│ ├── harden.sh # 라이브 OS 강화
│ ├── 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에 대한 긍정적인 커뮤니티 보고 두 건이 있습니다:
- 기존 Sequoia 환경에서 업그레이드한 M1 Pro에서 Runaway 2.0.0이 동작했다는 보고. 신규 설치가 아닙니다.
- MacBook Neo(Apple A18 Pro)에서 기본 명령이 동작했다는 보고.
이 보고들은 모든 빌드, 명령, 복구/FileVault 시나리오에 대한 지원을 입증하지 않습니다. 어느 쪽도 완전한 테스트 매트릭스를 포함하지 않습니다. 셸 회귀 테스트와 하드웨어 검증은 별개입니다.
### 외장 시동 디스크의 Wi-Fi
이 시나리오는 조사 중입니다. 문제가 있는 외장 설치 환경에서 다음을 실행:
```bash
./runaway doctor --network
```
이 읽기 전용 명령은 SSID, 하드웨어 주소, IP 주소를 출력하지 않고 macOS 빌드, Wi-Fi 인터페이스, 전원, 링크, IPv4 범주를 보고합니다. 쿼리 실패는 Wi-Fi 포트가 없는 상태의 성공과 별도로 보고됩니다.
- `Link status: inactive`는 인터넷 도달성 이전의 인터페이스 링크에 관한 것입니다.
- `Wi-Fi IPv4: link-local`은 169.254 주소를, `none`은 0이 아닌 IPv4 주소가 보고되지 않았음을 뜻합니다. 둘 다 IPv6 연결 진단은 아닙니다.
- `Wi-Fi IPv4: configured`는 DNS나 인터넷 연결을 증명하지 않습니다.
보고 시에는 스크립트 커밋, 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를 비활성화해야 하나요?**
아니요. 모든 쓰기는 데이터 볼륨을 대상으로 합니다.
**OS 재설치 후에도 효과가 유지되나요?**
아니요. 클린 설치는 데이터 볼륨을 지웁니다. 재설치 후 다시 실행하세요.
**조직이 추적할 수 있나요?**
시리얼 번호는 ABM에 남습니다. 등록 데몬이 다시 활성화된 상태로 인터넷에 연결하면 재등록됩니다.
**iCloud가 필요하면요?**
`firewall`이나 `suppress` 대신 `whitelist`를 사용하세요. 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.
+10 -2
View File
@@ -6,7 +6,7 @@
Single-script MDM bypass for macOS. Works from Recovery mode on Apple Silicon and Intel. Single-script MDM bypass for macOS. Works from Recovery mode on Apple Silicon and Intel.
> Read in: **English** | [简体中文](README.zh-CN.md) | [Português](README.pt-BR.md) > Read in: **English** | [简体中文](README.zh-CN.md) | [日本語](README.ja.md) | [한국어](README.ko-KR.md) | [Português](README.pt-BR.md)
I started this because the original bypass-mdm project had five different scripts (v2, v3, express, dualboot.sh, verify.sh), each with slightly different options and none of them handling the full problem after Migration Assistant. This replaces all of them in one file. I started this because the original bypass-mdm project had five different scripts (v2, v3, express, dualboot.sh, verify.sh), each with slightly different options and none of them handling the full problem after Migration Assistant. This replaces all of them in one file.
@@ -49,7 +49,15 @@ chmod +x /tmp/runaway && /tmp/runaway bypass
./runaway bypass ./runaway bypass
``` ```
Creates a temporary admin account and suppresses MDM. What it does: Creates a temporary admin account and suppresses MDM. Username and password are
prompted interactively (defaults `Apple` / `1234`); to run unattended, pass them as flags:
```bash
./runaway bypass --username me --password 'hunter2!' --full-name "My Name"
```
`--password` lands in your shell history and process list — prefer the interactive
prompt when someone might be watching. What bypass does:
1. Finds and mounts the macOS Data volume 1. Finds and mounts the macOS Data volume
2. Unlocks FileVault if needed (asks for password) 2. Unlocks FileVault if needed (asks for password)
+1 -1
View File
@@ -2,7 +2,7 @@
Ferramenta única para bypass/supressão de MDM no macOS. Funciona do Modo de Recuperação. Apple Silicon e Intel. Ferramenta única para bypass/supressão de MDM no macOS. Funciona do Modo de Recuperação. Apple Silicon e Intel.
> Leia em: [English](README.md) | **Português** | [简体中文](README.zh-CN.md) > Leia em: [English](README.md) | **Português** | [简体中文](README.zh-CN.md) | [日本語](README.ja.md) | [한국어](README.ko-KR.md)
## Instalação rápida ## Instalação rápida
+8 -2
View File
@@ -2,7 +2,7 @@
单脚本 macOS MDM 绕过工具。可在恢复模式下运行,支持 Apple Silicon 和 Intel。 单脚本 macOS MDM 绕过工具。可在恢复模式下运行,支持 Apple Silicon 和 Intel。
> 语言:[English](README.md) | **简体中文** | [Português](README.pt-BR.md) > 语言:[English](README.md) | **简体中文** | [日本語](README.ja.md) | [한국어](README.ko-KR.md) | [Português](README.pt-BR.md)
我做这个项目,是因为原先的 bypass-mdm 项目有五个不同的脚本(v2、v3、express、dualboot.sh、verify.sh),选项各有出入,而且没有一个能处理迁移助理之后的完整问题。本项目用一个文件把它们全部替代。 我做这个项目,是因为原先的 bypass-mdm 项目有五个不同的脚本(v2、v3、express、dualboot.sh、verify.sh),选项各有出入,而且没有一个能处理迁移助理之后的完整问题。本项目用一个文件把它们全部替代。
@@ -45,7 +45,13 @@ chmod +x /tmp/runaway && /tmp/runaway bypass
./runaway bypass ./runaway bypass
``` ```
创建临时管理员账户并压制 MDM。具体做这些事: 创建临时管理员账户并压制 MDM。用户名和密码走交互式输入(直接回车用默认值 `Apple` / `1234`);无人值守场景可以用参数直接传入:
```bash
./runaway bypass --username me --password 'hunter2!' --full-name "My Name"
```
注意 `--password` 会留在 shell 历史和进程列表里,手动操作时建议还是用交互输入。具体做这些事:
1. 查找并挂载 macOS 数据卷 1. 查找并挂载 macOS 数据卷
2. 需要时解锁 FileVault(会询问密码) 2. 需要时解锁 FileVault(会询问密码)
+3 -2
View File
@@ -17,9 +17,10 @@ title: Commands Reference — runaway
### `bypass` ### `bypass`
Creates a temporary admin account and suppresses all 5 layers of MDM. Creates a temporary admin account and suppresses all 5 layers of MDM.
**Must run from Recovery.** **Must run from Recovery.** Credentials are prompted interactively (defaults `Apple` / `1234`);
flags make it unattended (also works for `admin` and `dualboot`):
```bash ```bash
./runaway bypass ./runaway bypass --username me --password 'hunter2!' --full-name "My Name"
``` ```
### `suppress` ### `suppress`
+2
View File
@@ -16,6 +16,8 @@ title: Referência de Comandos — runaway
| `unpersist` | Remove o LaunchDaemon de auto-recuperação | ✗ | ✓ | | `unpersist` | Remove o LaunchDaemon de auto-recuperação | ✗ | ✓ |
### `bypass` ### `bypass`
Credenciais podem ser passadas via flags (também valem para `admin` e `dualboot`):
`--username <u>`, `--password <p>`, `--full-name <n>`; sem flags, o script pergunta.
Cria uma conta admin temporária e suprime todas as 5 camadas do MDM. Cria uma conta admin temporária e suprime todas as 5 camadas do MDM.
**Deve executar do Recovery.** **Deve executar do Recovery.**
```bash ```bash
+6 -6
View File
@@ -170,11 +170,11 @@ admin_only_mode() {
echo "" echo ""
step "Creating local admin account" step "Creating local admin account"
prompt_default realName "Full name" "Apple" acquire_realname realName
local username local username
while true; do while true; do
prompt_username username acquire_username username
if check_user_exists "$node" "$username"; then if check_user_exists "$node" "$username"; then
warn "User '$username' already exists." warn "User '$username' already exists."
if confirm "Delete and recreate?"; then if confirm "Delete and recreate?"; then
@@ -189,7 +189,7 @@ admin_only_mode() {
done done
local passw local passw
prompt_password passw acquire_password passw
local uid local uid
uid=$(find_available_uid "$node") uid=$(find_available_uid "$node")
@@ -227,11 +227,11 @@ full_bypass_mode() {
step "Creating temporary admin account" step "Creating temporary admin account"
local realName local realName
prompt_default realName "Full name" "Apple" acquire_realname realName
local username local username
while true; do while true; do
prompt_username username acquire_username username
if check_user_exists "$node" "$username"; then if check_user_exists "$node" "$username"; then
warn "User '$username' already exists." warn "User '$username' already exists."
if confirm "Delete and recreate?"; then if confirm "Delete and recreate?"; then
@@ -246,7 +246,7 @@ full_bypass_mode() {
done done
local passw local passw
prompt_password passw acquire_password passw
local uid local uid
uid=$(find_available_uid "$node") uid=$(find_available_uid "$node")
+57
View File
@@ -45,3 +45,60 @@ prompt_password() {
fi fi
done done
} }
# Account credentials: CLI flags (--username/--password/--full-name) win over
# interactive prompts so bypass/admin/dualboot can run unattended.
OPT_USERNAME="${OPT_USERNAME:-}"
OPT_PASSWORD="${OPT_PASSWORD:-}"
OPT_REALNAME="${OPT_REALNAME:-}"
parse_account_opts() {
ACCOUNT_ARGS=()
while [ $# -gt 0 ]; do
case "$1" in
--username|--password|--full-name)
local key="$1"
if [ $# -lt 2 ] || [ -z "$2" ] || [[ "$2" == --* ]]; then
error_exit "$key requires a value"
fi
case "$key" in
--username) OPT_USERNAME="$2" ;;
--password) OPT_PASSWORD="$2" ;;
--full-name) OPT_REALNAME="$2" ;;
esac
shift 2 ;;
*) ACCOUNT_ARGS+=("$1"); shift ;;
esac
done
}
acquire_username() {
local var_name="$1"
if [ -n "$OPT_USERNAME" ]; then
local msg
msg=$(validate_username "$OPT_USERNAME" 2>&1) || error_exit "Invalid --username: $msg"
eval "$var_name=\"\$OPT_USERNAME\""
else
prompt_username "$var_name"
fi
}
acquire_password() {
local var_name="$1"
if [ -n "$OPT_PASSWORD" ]; then
local msg
msg=$(validate_password "$OPT_PASSWORD" 2>&1) || error_exit "Invalid --password: $msg"
eval "$var_name=\"\$OPT_PASSWORD\""
else
prompt_password "$var_name"
fi
}
acquire_realname() {
local var_name="$1"
if [ -n "$OPT_REALNAME" ]; then
eval "$var_name=\"\$OPT_REALNAME\""
else
prompt_default "$var_name" "Full name" "Apple"
fi
}
+18 -9
View File
@@ -23,9 +23,9 @@ done
show_cmd_help() { show_cmd_help() {
case "$1" in case "$1" in
bypass) echo "Bypass MDM from Recovery. Creates admin user." ;; bypass) echo "Bypass MDM from Recovery. Creates admin user (accepts --username/--password/--full-name)." ;;
suppress) echo "Suppress enrollment without creating a user." ;; suppress) echo "Suppress enrollment without creating a user." ;;
admin) echo "Create an admin user without suppressing enrollment." ;; admin) echo "Create an admin user without suppressing enrollment (accepts --username/--password/--full-name)." ;;
heal) echo "Re-apply suppression after macOS updates." ;; heal) echo "Re-apply suppression after macOS updates." ;;
persist) echo "Install auto-heal LaunchDaemon." ;; persist) echo "Install auto-heal LaunchDaemon." ;;
unpersist) echo "Remove auto-heal LaunchDaemon." ;; unpersist) echo "Remove auto-heal LaunchDaemon." ;;
@@ -36,7 +36,7 @@ show_cmd_help() {
whitelist) echo "Block only MDM domains, keep iCloud/App Store." ;; whitelist) echo "Block only MDM domains, keep iCloud/App Store." ;;
backup) echo "Save current state." ;; backup) echo "Save current state." ;;
restore) echo "Restore from backup." ;; restore) echo "Restore from backup." ;;
dualboot) echo "Target an external macOS install." ;; dualboot) echo "Target an external macOS install (accepts --username/--password/--full-name)." ;;
status) echo "Show MDM enrollment status (Recovery only)." ;; status) echo "Show MDM enrollment status (Recovery only)." ;;
check) echo "Pre-format / pre-upgrade safety report." ;; check) echo "Pre-format / pre-upgrade safety report." ;;
history) echo "Show event log from monitor/heal runs." ;; history) echo "Show event log from monitor/heal runs." ;;
@@ -170,6 +170,12 @@ OPTIONS
--dry-run Simulate without making changes --dry-run Simulate without making changes
--log-file <f> Write logs to file (appended) --log-file <f> Write logs to file (appended)
Account options (bypass / admin / dualboot):
--username <u> Pre-set the admin username (skips the prompt)
--password <p> Pre-set the admin password (skips the prompt)
--full-name <n> Pre-set the display name
Note: --password is visible in shell history and process lists.
Run without arguments for interactive menu. Run without arguments for interactive menu.
HELP HELP
} }
@@ -180,6 +186,7 @@ cmd_version() {
} }
cmd_bypass() { cmd_bypass() {
parse_account_opts "$@"
if is_recovery; then if is_recovery; then
if [ "$DRY_RUN" = true ]; then if [ "$DRY_RUN" = true ]; then
full_bypass_mode "the selected Data volume" full_bypass_mode "the selected Data volume"
@@ -213,6 +220,7 @@ cmd_backup() {
} }
cmd_admin() { cmd_admin() {
parse_account_opts "$@"
if ! is_recovery; then if ! is_recovery; then
error_exit "Admin creation must run from Recovery mode." error_exit "Admin creation must run from Recovery mode."
fi fi
@@ -241,6 +249,7 @@ cmd_dualboot() {
error_exit "Dual-boot needs sudo: sudo ./runaway dualboot" error_exit "Dual-boot needs sudo: sudo ./runaway dualboot"
fi fi
parse_account_opts "$@"
header "Dual-Boot Mode" header "Dual-Boot Mode"
local volumes local volumes
@@ -258,11 +267,11 @@ cmd_dualboot() {
step "Creating admin account on target" step "Creating admin account on target"
local realName local realName
prompt_default realName "Full name" "Apple" acquire_realname realName
local username local username
prompt_username username acquire_username username
local passw local passw
prompt_password passw acquire_password passw
local uid local uid
uid=$(find_available_uid "$node") uid=$(find_available_uid "$node")
@@ -605,9 +614,9 @@ main() {
fi fi
case "${1:-}" in case "${1:-}" in
bypass|by) cmd_bypass ;; bypass|by) cmd_bypass "$@" ;;
suppress|sv) cmd_suppress ;; suppress|sv) cmd_suppress ;;
admin|adm) cmd_admin ;; admin|adm) cmd_admin "$@" ;;
heal) cmd_heal ;; heal) cmd_heal ;;
persist) cmd_persist ;; persist) cmd_persist ;;
unpersist) cmd_unpersist ;; unpersist) cmd_unpersist ;;
@@ -618,7 +627,7 @@ main() {
whitelist|wl) cmd_whitelist ;; whitelist|wl) cmd_whitelist ;;
backup) cmd_backup ;; backup) cmd_backup ;;
restore) cmd_restore ;; restore) cmd_restore ;;
dualboot) cmd_dualboot ;; dualboot) cmd_dualboot "$@" ;;
status|st|ls) cmd_status ;; status|st|ls) cmd_status ;;
check) cmd_check ;; check) cmd_check ;;
history) cmd_history ;; history) cmd_history ;;
+81 -15
View File
@@ -358,6 +358,63 @@ prompt_password() {
done done
} }
# Account credentials: CLI flags (--username/--password/--full-name) win over
# interactive prompts so bypass/admin/dualboot can run unattended.
OPT_USERNAME="${OPT_USERNAME:-}"
OPT_PASSWORD="${OPT_PASSWORD:-}"
OPT_REALNAME="${OPT_REALNAME:-}"
parse_account_opts() {
ACCOUNT_ARGS=()
while [ $# -gt 0 ]; do
case "$1" in
--username|--password|--full-name)
local key="$1"
if [ $# -lt 2 ] || [ -z "$2" ] || [[ "$2" == --* ]]; then
error_exit "$key requires a value"
fi
case "$key" in
--username) OPT_USERNAME="$2" ;;
--password) OPT_PASSWORD="$2" ;;
--full-name) OPT_REALNAME="$2" ;;
esac
shift 2 ;;
*) ACCOUNT_ARGS+=("$1"); shift ;;
esac
done
}
acquire_username() {
local var_name="$1"
if [ -n "$OPT_USERNAME" ]; then
local msg
msg=$(validate_username "$OPT_USERNAME" 2>&1) || error_exit "Invalid --username: $msg"
eval "$var_name=\"\$OPT_USERNAME\""
else
prompt_username "$var_name"
fi
}
acquire_password() {
local var_name="$1"
if [ -n "$OPT_PASSWORD" ]; then
local msg
msg=$(validate_password "$OPT_PASSWORD" 2>&1) || error_exit "Invalid --password: $msg"
eval "$var_name=\"\$OPT_PASSWORD\""
else
prompt_password "$var_name"
fi
}
acquire_realname() {
local var_name="$1"
if [ -n "$OPT_REALNAME" ]; then
eval "$var_name=\"\$OPT_REALNAME\""
else
prompt_default "$var_name" "Full name" "Apple"
fi
}
dscl_node() { dscl_node() {
local data_mount="$1" local data_mount="$1"
@@ -620,11 +677,11 @@ admin_only_mode() {
echo "" echo ""
step "Creating local admin account" step "Creating local admin account"
prompt_default realName "Full name" "Apple" acquire_realname realName
local username local username
while true; do while true; do
prompt_username username acquire_username username
if check_user_exists "$node" "$username"; then if check_user_exists "$node" "$username"; then
warn "User '$username' already exists." warn "User '$username' already exists."
if confirm "Delete and recreate?"; then if confirm "Delete and recreate?"; then
@@ -639,7 +696,7 @@ admin_only_mode() {
done done
local passw local passw
prompt_password passw acquire_password passw
local uid local uid
uid=$(find_available_uid "$node") uid=$(find_available_uid "$node")
@@ -677,11 +734,11 @@ full_bypass_mode() {
step "Creating temporary admin account" step "Creating temporary admin account"
local realName local realName
prompt_default realName "Full name" "Apple" acquire_realname realName
local username local username
while true; do while true; do
prompt_username username acquire_username username
if check_user_exists "$node" "$username"; then if check_user_exists "$node" "$username"; then
warn "User '$username' already exists." warn "User '$username' already exists."
if confirm "Delete and recreate?"; then if confirm "Delete and recreate?"; then
@@ -696,7 +753,7 @@ full_bypass_mode() {
done done
local passw local passw
prompt_password passw acquire_password passw
local uid local uid
uid=$(find_available_uid "$node") uid=$(find_available_uid "$node")
@@ -2844,9 +2901,9 @@ vpn_kill_status() {
show_cmd_help() { show_cmd_help() {
case "$1" in case "$1" in
bypass) echo "Bypass MDM from Recovery. Creates admin user." ;; bypass) echo "Bypass MDM from Recovery. Creates admin user (accepts --username/--password/--full-name)." ;;
suppress) echo "Suppress enrollment without creating a user." ;; suppress) echo "Suppress enrollment without creating a user." ;;
admin) echo "Create an admin user without suppressing enrollment." ;; admin) echo "Create an admin user without suppressing enrollment (accepts --username/--password/--full-name)." ;;
heal) echo "Re-apply suppression after macOS updates." ;; heal) echo "Re-apply suppression after macOS updates." ;;
persist) echo "Install auto-heal LaunchDaemon." ;; persist) echo "Install auto-heal LaunchDaemon." ;;
unpersist) echo "Remove auto-heal LaunchDaemon." ;; unpersist) echo "Remove auto-heal LaunchDaemon." ;;
@@ -2857,7 +2914,7 @@ show_cmd_help() {
whitelist) echo "Block only MDM domains, keep iCloud/App Store." ;; whitelist) echo "Block only MDM domains, keep iCloud/App Store." ;;
backup) echo "Save current state." ;; backup) echo "Save current state." ;;
restore) echo "Restore from backup." ;; restore) echo "Restore from backup." ;;
dualboot) echo "Target an external macOS install." ;; dualboot) echo "Target an external macOS install (accepts --username/--password/--full-name)." ;;
status) echo "Show MDM enrollment status (Recovery only)." ;; status) echo "Show MDM enrollment status (Recovery only)." ;;
check) echo "Pre-format / pre-upgrade safety report." ;; check) echo "Pre-format / pre-upgrade safety report." ;;
history) echo "Show event log from monitor/heal runs." ;; history) echo "Show event log from monitor/heal runs." ;;
@@ -2991,6 +3048,12 @@ OPTIONS
--dry-run Simulate without making changes --dry-run Simulate without making changes
--log-file <f> Write logs to file (appended) --log-file <f> Write logs to file (appended)
Account options (bypass / admin / dualboot):
--username <u> Pre-set the admin username (skips the prompt)
--password <p> Pre-set the admin password (skips the prompt)
--full-name <n> Pre-set the display name
Note: --password is visible in shell history and process lists.
Run without arguments for interactive menu. Run without arguments for interactive menu.
HELP HELP
} }
@@ -3001,6 +3064,7 @@ cmd_version() {
} }
cmd_bypass() { cmd_bypass() {
parse_account_opts "$@"
if is_recovery; then if is_recovery; then
if [ "$DRY_RUN" = true ]; then if [ "$DRY_RUN" = true ]; then
full_bypass_mode "the selected Data volume" full_bypass_mode "the selected Data volume"
@@ -3034,6 +3098,7 @@ cmd_backup() {
} }
cmd_admin() { cmd_admin() {
parse_account_opts "$@"
if ! is_recovery; then if ! is_recovery; then
error_exit "Admin creation must run from Recovery mode." error_exit "Admin creation must run from Recovery mode."
fi fi
@@ -3062,6 +3127,7 @@ cmd_dualboot() {
error_exit "Dual-boot needs sudo: sudo ./runaway dualboot" error_exit "Dual-boot needs sudo: sudo ./runaway dualboot"
fi fi
parse_account_opts "$@"
header "Dual-Boot Mode" header "Dual-Boot Mode"
local volumes local volumes
@@ -3079,11 +3145,11 @@ cmd_dualboot() {
step "Creating admin account on target" step "Creating admin account on target"
local realName local realName
prompt_default realName "Full name" "Apple" acquire_realname realName
local username local username
prompt_username username acquire_username username
local passw local passw
prompt_password passw acquire_password passw
local uid local uid
uid=$(find_available_uid "$node") uid=$(find_available_uid "$node")
@@ -3426,9 +3492,9 @@ main() {
fi fi
case "${1:-}" in case "${1:-}" in
bypass|by) cmd_bypass ;; bypass|by) cmd_bypass "$@" ;;
suppress|sv) cmd_suppress ;; suppress|sv) cmd_suppress ;;
admin|adm) cmd_admin ;; admin|adm) cmd_admin "$@" ;;
heal) cmd_heal ;; heal) cmd_heal ;;
persist) cmd_persist ;; persist) cmd_persist ;;
unpersist) cmd_unpersist ;; unpersist) cmd_unpersist ;;
@@ -3439,7 +3505,7 @@ main() {
whitelist|wl) cmd_whitelist ;; whitelist|wl) cmd_whitelist ;;
backup) cmd_backup ;; backup) cmd_backup ;;
restore) cmd_restore ;; restore) cmd_restore ;;
dualboot) cmd_dualboot ;; dualboot) cmd_dualboot "$@" ;;
status|st|ls) cmd_status ;; status|st|ls) cmd_status ;;
check) cmd_check ;; check) cmd_check ;;
history) cmd_history ;; history) cmd_history ;;