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

This commit is contained in:
2026-11-09 12:13:12 +08:00
parent 5da405b034
commit f3a7c6f57d
5 changed files with 545 additions and 4 deletions
+1 -1
View File
@@ -2,7 +2,7 @@
macOS 向けシングルスクリプト MDM バイパスツール。リカバリモードから実行でき、Apple Silicon と Intel の両方に対応しています。 macOS 向けシングルスクリプト MDM バイパスツール。リカバリモードから実行でき、Apple Silicon と Intel の両方に対応しています。
> 言語:[English](README.md) | [简体中文](README.zh-CN.md) | **日本語** | [Português](README.pt-BR.md) > 言語:[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 つのファイルに置き換えます。 このプロジェクトを始めた理由は、元の bypass-mdm プロジェクトに 5 つの異なるスクリプト(v2、v3、express、dualboot.sh、verify.sh)があり、それぞれオプションが微妙に異なり、移行アシスタント後の問題を完全に処理できるものが 1 つもなかったからです。本ツールはそれらすべてを 1 つのファイルに置き換えます。
+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.
+1 -1
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) | [日本語](README.ja.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.
+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) | [日本語](README.ja.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
+1 -1
View File
@@ -2,7 +2,7 @@
单脚本 macOS MDM 绕过工具。可在恢复模式下运行,支持 Apple Silicon 和 Intel。 单脚本 macOS MDM 绕过工具。可在恢复模式下运行,支持 Apple Silicon 和 Intel。
> 语言:[English](README.md) | **简体中文** | [日本語](README.ja.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),选项各有出入,而且没有一个能处理迁移助理之后的完整问题。本项目用一个文件把它们全部替代。