542 lines
24 KiB
Markdown
542 lines
24 KiB
Markdown
# 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.
|