Files
runaway/docs/pt/index.md
T
ruihan c2b55fc015
CI / ShellCheck (push) Failing after 12s
CI / Bash Syntax Check (push) Successful in 12s
CI / Markdown Lint (push) Successful in 15s
chore: remove remaining upstream author and origin-repo references
2026-11-09 10:45:03 +08:00

16 KiB
Raw Blame History

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

runaway logo
runaway
runaway

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 + heal pegam 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

Download direto

curl -L https://git.jskdjs.cn/ruihan/runaway/raw/branch/main/runaway-standalone.sh -o runaway
chmod +x runaway

De um pendrive USB (para o modo Recovery)

  1. Formate um USB/SSD como FAT32, APFS ou exFAT
  2. Copie a pasta runaway (ou apenas runaway-standalone.sh) para o drive
  3. Inicialize no Recovery e execute de /Volumes/SeuDrive/runaway

Início Rápido

Modo Recovery (bypass padrão)

  1. Inicialize no Recovery:

    • Apple Silicon: segure o botão power → Options → Continue
    • Intel: Cmd+R ao ligar
  2. Abra o Terminal (Utilitários → Terminal)

  3. Execute:

    "/Volumes/SeuDrive/runaway" bypass
    
  4. Siga as instruções para criar um usuário admin temporário

  5. 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 último release (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

  1. Instale o macOS em um Mac novo
  2. O Migration Assistant copia seus dados antigos
  3. 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

  1. A atualização do sistema restaura os daemons de registro automaticamente
  2. O bloqueio MDM em /etc/hosts geralmente é 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

  1. Inicialize no Recovery sem Wi-Fi
  2. Execute runaway init — assistente interativo
  3. Ele irá: suprimir MDM, instalar persist, instalar whitelist, executar audit
  4. 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 incluindo deviceenrollment.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:

  1. Execute diskutil list para encontrar seu volume de Dados
  2. Monte: diskutil mount /dev/diskXsY
  3. 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/hosts também bloqueia albert.apple.com (ativação do iCloud) e gdmf.apple.com
  • Use o comando whitelist em vez de firewall para 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.

  1. Abra o Apple Configurator 2 no Mac auxiliar
  2. Conecte o Mac travado via USB-C enquanto segura o power
  3. No Configurator: clique com direito no dispositivo DFU → Advanced → Restore
  4. Escolha o arquivo IPSW, aguarde 10–30 minutos
  5. 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 — backup salva o estado, restore reverte
  • Sem apagar dados — nunca executa profiles renew ou comandos de apagar
  • Idempotente — executar múltiplas vezes é inofensivo
  • Pede confirmação antes de ações destrutivas