--- layout: default title: runaway description: 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** ```bash 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: ```bash "/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: ```bash sudo ./runaway heal ``` Ou para verificar o status atual: ```bash sudo ./runaway status -d ``` ### Configuração com um comando (Mac novo) ```bash 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 ` | Escreve logs em um arquivo | --- ## Cenários ### Antes de comprar um Mac usado ```bash ./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: ```bash sudo ./runaway suppress ``` Ou de um sistema já iniciado: ```bash 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: ```bash 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](https://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 ` 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 --- ## Links - [Repositório GitHub](https://git.jskdjs.cn/ruihan/runaway) - [README completo](https://git.jskdjs.cn/ruihan/runaway/src/branch/main/README.md) - [Guia de Arquitetura](guide) - [FAQ](faq) - [Changelog](https://git.jskdjs.cn/ruihan/runaway/src/branch/main/CHANGELOG.md) - [Contribuindo](https://git.jskdjs.cn/ruihan/runaway/src/branch/main/CONTRIBUTING.md) - [Código de Conduta](https://git.jskdjs.cn/ruihan/runaway/src/branch/main/CODE_OF_CONDUCT.md) - [Política de Segurança](https://git.jskdjs.cn/ruihan/runaway/src/branch/main/SECURITY.md) - [Discussões](https://git.jskdjs.cn/ruihan/runaway/discussions) - [Reportar Bug](https://git.jskdjs.cn/ruihan/runaway/issues/new?template=bug_report.md)