4.0 KiB
runaway
Ferramenta única para bypass/supressão de MDM no macOS. Funciona do Modo de Recuperação. Apple Silicon e Intel.
Instalação rápida
# Download direto
curl -L https://git.jskdjs.cn/ruihan/runaway/raw/branch/main/runaway-standalone.sh -o runaway
chmod +x runaway && sudo ./runaway
Como usar
- Copie a pasta
runawaypara um SSD externo (FAT32/APFS/exFAT) - Inicialize no Modo de Recuperação:
- Apple Silicon: segure o botão de energia → Opções → Continuar
- Intel: Cmd+R na inicialização
- Abra o Terminal (Utilitários) e execute:
chmod +x "/Volumes/SeuSSD/runaway/runaway"
"/Volumes/SeuSSD/runaway/runaway"
Escolha "Full bypass" no menu. Ou use a linha de comando:
"/Volumes/SeuSSD/runaway/runaway" bypass
Comandos principais
| Comando | Função |
|---|---|
bypass |
Bypass completo — cria admin + suprime MDM |
suppress |
Silencia o MDM sem criar usuário |
heal |
Verifica e reaplica supressão após updates |
persist |
Auto-heal em toda inicialização |
firewall |
Bloqueia IPs da Apple via pf (kernel) |
whitelist |
Bloqueia só MDM, mantém iCloud |
harden |
Mata processos MDM + remove perfis |
audit |
Varredura profunda + score de risco |
check |
Relatório pré-formatação |
monitor |
Vigia MDM a cada 5min |
doctor |
Diagnóstico pré-vôo completo |
report |
Status completo do sistema |
demo |
Simulação sem alterar nada |
vpn-kill |
Bloqueia MDM fora da VPN |
update |
Auto-update do GitHub |
uninstall |
Remove todos os vestígios |
test |
Simulação (dry-run) |
Aliases
by = bypass, sv = suppress, fw = firewall, wl = whitelist,
st = status, mn = monitor, doc = doctor, up = update
Por que não usar só o bypass-mdm?
O projeto original cresceu para 5 scripts (v2, v3, express, dualboot.sh, verify.sh), cada um com opções diferentes. O Runaway substitui todos em um único comando.
Como funciona
O MDM opera em 4 camadas. O Runaway ataca todas:
- Marcadores DEP — remove arquivos
.cloudConfig*, cria iscas - Rede —
/etc/hostsbloqueia 13+ domínios Apple + servidor MDM da org - Daemons — desabilita
ManagedClient.enroll,activationd, etc - Usuário — limpa
~/Library/Preferences/com.apple.mdm.*de todos os usuários
Firewall pf (comandos firewall/whitelist) pega o que o /etc/hosts não consegue — especialmente DNS-over-HTTPS.
Intel vs Apple Silicon
| Intel T2 | Apple Silicon | |
|---|---|---|
| Recuperação | Cmd+R | Segurar Power |
| Volume sistema | Gravável (SIP off) | SSV (só leitura) |
| FileVault | Suportado | Suportado |
| Migration Assistant | Menos risco | Traz MDM de volta |
Migration Assistant
Se você migrar de um Intel para Apple Silicon, o MDM vai voltar após o reboot. O Migration Assistant copia artefatos de usuário que os scripts antigos não limpam. O Runaway limpa /Users/*/Library explicitamente.
Se ainda assim voltar, execute sudo ./runaway harden do sistema já iniciado.
Troubleshooting
MDM volta após reboot — execute runaway suppress da Recuperação. Se persistir, são artefatos do Migration Assistant. Execute runaway harden após o login.
profiles mostra matrícula — cosmético. O SSV armazena estado de perfil em modo somente leitura. Verifique os marcadores DEP com runaway status.
FileVault não desbloqueia — você precisa da senha de um usuário ou da chave de recuperação.
Update do macOS — execute runaway heal. Se usou persist antes do update, ele faz isso automaticamente.
Limitações
- O serial continua no Apple Business Manager. Só a organização pode remover.
- Um wipe completo limpa o volume de Dados — execute novamente da Recuperação.
- O bloqueio de hosts pode ser burlado por DNS cache ou DoH. Firewall pf resolve.
Licença
MIT. Veja LICENSE.