16 KiB
layout, title, description
| layout | title | description |
|---|---|---|
| default | runaway | Bypass MDM em um único script para macOS — cobre todas as 5 camadas do MDM da Apple |
Instalar · Início Rápido · Comandos · Guia de Arquitetura · FAQ · Solução de Problemas
runaway substitui os cinco scripts originais do bypass-mdm em um único arquivo que lida com todas as camadas do registro MDM da Apple: marcadores DEP, bloqueio de rede, substituição de daemons, artefatos de nível de usuário e firewall a nível de kernel. Funciona no modo Recovery em Apple Silicon e Intel.
O que torna o runaway diferente de outras ferramentas de bypass:
- Cobre todas as 5 camadas — não apenas marcadores DEP ou arquivo hosts. Bloqueia todos os caminhos que o MDM usa para re-registrar.
- Limpeza de artefatos de usuário — o Migration Assistant copia caches MDM por usuário. O Runaway limpa todos os diretórios home.
- Firewall pf a nível de kernel —
/etc/hostsé contornado por DNS-over-HTTPS. pf não. - Daemon de auto-recuperação — sobrevive a atualizações do macOS.
persist+healpegam tudo que a atualização resetar. - 39 comandos — bypass, suppress, monitor, harden, audit, backup, predict, remediate e mais.
- macOS 12–27 — testado em Intel T2, M1, M2, M3, M4, M5.
Instalar
Homebrew (mais fácil)
brew install mateussiqueira/runaway/runaway
Download direto
curl -L https://raw.githubusercontent.com/mateussiqueira/runaway/main/runaway-standalone.sh -o runaway
chmod +x runaway
De um pendrive USB (para o modo Recovery)
- Formate um USB/SSD como FAT32, APFS ou exFAT
- Copie a pasta
runaway(ou apenasrunaway-standalone.sh) para o drive - Inicialize no Recovery e execute de
/Volumes/SeuDrive/runaway
Início Rápido
Modo Recovery (bypass padrão)
-
Inicialize no Recovery:
- Apple Silicon: segure o botão power → Options → Continue
- Intel: Cmd+R ao ligar
-
Abra o Terminal (Utilitários → Terminal)
-
Execute:
"/Volumes/SeuDrive/runaway" bypass -
Siga as instruções para criar um usuário admin temporário
-
Reinicie. O registro MDM será suprimido.
Sistema já iniciado (já configurado)
Se você já tem um Mac que foi bypassado anteriormente e o MDM voltou após uma atualização:
sudo ./runaway heal
Ou para verificar o status atual:
sudo ./runaway status -d
Configuração com um comando (Mac novo)
sudo ./runaway init
Assistente interativo que executa a configuração completa: firewall, monitor, persist, backup e audit.
Comandos
Bypass & suppress
| Comando | Descrição | Recovery | Iniciado |
|---|---|---|---|
bypass |
Bypass completo: cria usuário admin + suprime MDM | ✓ | ✗ |
suppress |
Suprime registro sem criar um usuário | ✓ | ✓ |
heal |
Reaplica supressão após atualizações do macOS | ✓ | ✓ |
persist |
Instala LaunchDaemon para auto-recuperação na inicialização | ✓ | ✓ |
unpersist |
Remove o LaunchDaemon de auto-recuperação | ✗ | ✓ |
Firewall & hardening
| Comando | Descrição |
|---|---|
firewall |
Bloqueia IPs Apple MDM via pf (nível de kernel, à prova de DoH) |
firewall-off |
Remove o bloqueio pf do MDM |
whitelist |
Bloqueia apenas domínios MDM, mantém iCloud/App Store |
harden |
Mata processos MDM, remove perfis, limpa DNS — do sistema iniciado |
Diagnósticos
| Comando | Descrição |
|---|---|
audit |
Varredura MDM profunda — perfis, certificados, launch agents, score de risco |
check |
Avaliação pré-formatação — este Mac vai travar após limpar? |
history |
Mostra o log de eventos do monitor/heal |
history-clear |
Limpa o log de eventos |
doctor |
Diagnóstico pré-voo — root, Recovery, libs, disco, dependências |
status |
Status do registro MDM (use -d para modo profundo) |
report |
Relatório completo do sistema em formato legível ou JSON |
Monitoramento
| Comando | Descrição |
|---|---|
monitor |
Monitora o estado do MDM a cada 5 minutos, auto-recupera se necessário |
monitor-stop |
Para o monitor em segundo plano |
monitor-status |
Verifica se o monitor está rodando |
monitor-install |
Instala o monitor como um LaunchDaemon |
Kill-switch VPN
| Comando | Descrição |
|---|---|
vpn-kill |
Instala kill-switch pf — bloqueia MDM fora do túnel VPN |
vpn-kill-remove |
Remove o kill-switch VPN |
vpn-kill-status |
Verifica o estado do kill-switch VPN |
Utilitários
| Comando | Descrição |
|---|---|
update |
Autoatualização a partir do GitHub Releases (verificada com GPG) |
uninstall |
Remoção completa com confirmações de segurança |
reinstall |
Desinstalar + instalar (atualização atômica) |
config |
Ver/editar configurações persistentes em ~/.runaway.conf |
backup |
Salva o estado atual para restaurar depois |
restore |
Restaura a partir de um backup anterior |
demo |
Fluxo de bypass simulado — sem alterações reais |
test |
Simulação dry-run de qualquer comando |
dualboot |
Mira um volume externo ou dual-boot |
Comandos inteligentes (v2.0)
| Comando | Descrição |
|---|---|
init |
Assistente de configuração interativo — firewall, monitor, persist, backup |
suggest |
Análise de risco e recomendações baseadas no sistema |
remediate |
Limpeza por organização (JAMF, Mosyle, Addigy, Kandji, VMware) |
predict |
Consulta de número serial — prevê qual organização registrou este Mac |
telemetry |
Gerencia estatísticas de uso anônimas (opt-in) |
discord-bot |
Inicia o bot de alertas do Discord |
discord-bot-stop |
Para o bot do Discord |
discord-bot-status |
Verifica se o bot do Discord está rodando |
Aliases
Cada comando tem um alias curto:
by = bypass fw = firewall fw-off = firewall-off
sv = suppress mn = monitor doc = doctor
st = status up = update uni = uninstall
rei = reinstall vk = vpn-kill vkr = vpn-kill-remove
vks = vpn-kill-status wl = whitelist
it = init su = suggest rm = remediate
pr = predict tel = telemetry db = discord-bot
dbs = discord-bot-stop dbs2 = discord-bot-status
Opções globais
| Opção | Efeito |
|---|---|
--verbose |
Mostra mensagens de debug |
--log-file <caminho> |
Escreve logs em um arquivo |
Cenários
Antes de comprar um Mac usado
./runaway predict ABC12345678 # verifica serial contra organizações conhecidas
./runaway check # este Mac é seguro para formatar?
predict consulta o serial contra prefixos conhecidos de organizações MDM. Se corresponder a JAMF, Mosyle ou outra, você sabe o que esperar antes de comprar.
Recuperação após Migration Assistant
- Instale o macOS em um Mac novo
- O Migration Assistant copia seus dados antigos
- O MDM aparece em minutos após o login
Solução: Inicialize no Recovery e execute runaway suppress (ou bypass se precisar de um novo admin). Remove os marcadores DEP, artefatos de usuário e preferências MDM que o MA transferiu.
Atualização do macOS trouxe o MDM de volta
- A atualização do sistema restaura os daemons de registro automaticamente
- O bloqueio MDM em
/etc/hostsgeralmente é preservado
Solução: sudo ./runaway heal — re-desabilita daemons e verifica todas as camadas. Se você executou persist antes da atualização, isso acontece automaticamente na próxima inicialização.
Configurando um Mac novo antes do primeiro boot
- Inicialize no Recovery sem Wi-Fi
- Execute
runaway init— assistente interativo - Ele irá: suprimir MDM, instalar persist, instalar whitelist, executar audit
- Reinicie, configure normalmente, o MDM nunca incomoda
Como Funciona
O MDM (Mobile Device Management) opera em cinco camadas no macOS. O Runaway bloqueia todas elas:
Camada 1: Marcadores DEP → /etc/hosts → Camada 2: Bloqueio de rede
Camada 3: Override de daemons → launchd desabilitado → Camada 4: Artefatos de usuário
Camada 5: Firewall pf → nível de kernel, à prova de DoH
Camada 1: Marcadores de registro DEP
Em /var/db/ConfigurationProfiles/Settings/, a Apple armazena arquivos .cloudConfig* que marcam o Mac como registrado no DEP. Removê-los é a abordagem padrão de bypass.
O que o runaway faz: Remove todos os marcadores .cloudConfig*, cria arquivos falsos que dizem ao macOS que o dispositivo nunca foi registrado e impede a recriação bloqueando também a camada de rede.
Camada 2: Bloqueio de rede
O cliente de registro contata os servidores da Apple para baixar o perfil MDM. Sem acesso à rede, ele não pode completar o registro.
O que o runaway faz:
/etc/hosts(básico): Bloqueia 13+ domínios Apple MDM incluindodeviceenrollment.apple.com,mdmenrollment.apple.com,iprofiles.apple.com. Entradas IPv4 (0.0.0.0) e IPv6 (::).- Firewall pf (avançado): Filtragem de pacotes a nível de kernel que bloqueia faixas de IP Apple mesmo quando DoH é usado.
Domínios bloqueados:
| Domínio | Serviço |
|---|---|
iprofiles.apple.com |
Entrega de perfis |
deviceenrollment.apple.com |
Serviço DEP |
mdmenrollment.apple.com |
Registro MDM |
acmdm.apple.com |
Apple Configurator 2 MDM |
axm-adm-mdm.apple.com |
Registro ACM |
albert.apple.com |
Atribuição ABM |
gdmf.apple.com |
Framework MDM |
configuration.apple.com |
Serviço de configuração |
xp.apple.com |
Gerenciamento de dispositivos |
gs.apple.com |
Registro GSM |
tb.apple.com |
Trust de dispositivo |
vpp.itunes.apple.com |
Programa de compra em volume |
Mais o host MDM específico da sua organização, extraído do registro DEP.
Camada 3: Override de daemons
O macOS registra quatro daemons de registro que executam na inicialização:
| Daemon | Propósito |
|---|---|
com.apple.ManagedClient.enroll |
Registro principal |
com.apple.ManagedClient.cloudConfiguration |
Configuração em nuvem |
com.apple.mdmclient.daemon.runatboot |
Cliente MDM |
com.apple.activationd |
Ativação do dispositivo |
O que o runaway faz: Cria overrides launchd desabilitados para todos os quatro, impedindo que iniciem.
Camada 4: Limpeza de artefatos de usuário
O Migration Assistant e caches de login deixam dados de registro MDM nos diretórios home:
~/Library/Preferences/com.apple.mdm.*
~/Library/Preferences/com.apple.ManagedClient.*
~/Library/Application Support/com.apple.ManagedClient*/
~/Library/Caches/com.apple.mdmclient
~/Library/LaunchAgents/com.apple.mdm.*
O que o runaway faz: Varre todos os diretórios home no volume de Dados e remove todos os preferences, caches e launch agents relacionados ao MDM.
Camada 5: Firewall pf (opcional, avançado)
/etc/hosts pode ser contornado por DNS-over-HTTPS (DoH). O pf opera a nível de kernel — DoH não o contorna.
Comando firewall: Bloqueia toda a faixa de IP da Apple (17.0.0.0/8 + 17.128.0.0/10). 100% eficaz mas quebra iCloud, App Store e atualizações.
Comando whitelist: Resolve apenas os domínios MDM essenciais para IPs e bloqueia especificamente aqueles. Mantém iCloud e App Store funcionando.
Intel vs Apple Silicon
| Intel T2 | Apple Silicon | |
|---|---|---|
| Recovery | Cmd+R ao ligar | Segurar botão power |
| Volume do sistema | Gravável com SIP desabilitado | Apenas leitura (SSV) |
| Desbloqueio FileVault | diskutil apfs unlockVolume |
Igual, precisa de senha ou chave de recuperação |
| Daemons de registro | Menos | activationd + cloudConfiguration |
| Migration Assistant | Menos arriscado | Carrega estado MDM — sempre limpar depois |
No Apple Silicon, todas as escritas miram o volume de Dados. O volume do sistema nunca é modificado. Não precisa desabilitar SIP.
Compatibilidade com versões do macOS
| Versão | Codinome | Status |
|---|---|---|
| 12.x | Monterey | ✓ Testado |
| 13.x | Ventura | ✓ Testado |
| 14.x | Sonoma | ✓ Testado |
| 15.x | Sequoia | ✓ Testado |
| 26.x | Tahoe | ✓ Testado |
| 27.x | (atual) | ✓ Testado |
Deve funcionar em qualquer versão que use o mesmo mecanismo de registro MDM — que não mudou desde Monterey.
Solução de Problemas
MDM volta após reiniciar
A causa mais provável são artefatos de nível de usuário. Execute do Recovery:
sudo ./runaway suppress
Ou de um sistema já iniciado:
sudo ./runaway harden
Erro "Not a known DirStatus"
O script detecta volumes automaticamente, mas se você tiver uma configuração não padrão:
- Execute
diskutil listpara encontrar seu volume de Dados - Monte:
diskutil mount /dev/diskXsY - Execute runaway novamente
Perfis ainda mostram registro
Isso é cosmético. O macOS armazena estado de perfis no SSV (Volume Selado do Sistema). Verifique os marcadores DEP reais:
sudo ./runaway status -d
FileVault está ativado
O Runaway detecta FileVault e pede a chave de recuperação ou senha do volume. Se o desbloqueio automático falhar, desbloqueie o volume manualmente no Utilitário de Disco primeiro.
Atualização do macOS reativou o MDM
Execute sudo ./runaway heal após qualquer atualização do macOS. Se você usou persist antes da atualização, isso acontece automaticamente na próxima inicialização.
Posso usar iCloud após o bypass?
Sim, mas:
- O bloqueio básico de
/etc/hoststambém bloqueiaalbert.apple.com(ativação do iCloud) egdmf.apple.com - Use o comando
whitelistem vez defirewallpara bloquear apenas domínios MDM e deixar iCloud/App Store funcionando - Ou remova manualmente essas duas linhas de
/etc/hosts
Restauração DFU / IPSW (travamento total)
Se o MDM for inquebrável mesmo do Recovery, o dispositivo pode precisar de uma restauração completa de firmware. Isso se aplica apenas ao Apple Silicon.
Você precisa de um segundo Mac com Apple Configurator 2 (grátis), um cabo USB-C e o arquivo IPSW para seu modelo de Mac.
- Abra o Apple Configurator 2 no Mac auxiliar
- Conecte o Mac travado via USB-C enquanto segura o power
- No Configurator: clique com direito no dispositivo DFU → Advanced → Restore
- Escolha o arquivo IPSW, aguarde 10–30 minutos
- Após restaurar, inicialize no Recovery sem Wi-Fi e execute
runaway bypass
Isso apaga todos os dados. Arquivos IPSW em ipsw.me.
Logging
Todos os comandos registram com timestamps e níveis:
[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
Use --verbose para mensagens de debug e --log-file <caminho> para escrever tudo em um arquivo.
Segurança
- Sem escritas no SSV — todas as alterações miram o volume de Dados
- Reversível —
backupsalva o estado,restorereverte - Sem apagar dados — nunca executa
profiles renewou comandos de apagar - Idempotente — executar múltiplas vezes é inofensivo
- Pede confirmação antes de ações destrutivas