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

This commit is contained in:
2026-11-09 11:25:37 +08:00
parent d43c23135f
commit 5da405b034
4 changed files with 544 additions and 3 deletions
+541
View File
@@ -0,0 +1,541 @@
# runaway
macOS 向けシングルスクリプト MDM バイパスツール。リカバリモードから実行でき、Apple Silicon と Intel の両方に対応しています。
> 言語:[English](README.md) | [简体中文](README.zh-CN.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。