9.6 KiB
layout, title
| layout | title |
|---|---|
| default | Referência de Comandos — runaway |
Referência de 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 | ✗ | ✓ |
bypass
Cria uma conta admin temporária e suprime todas as 5 camadas do MDM. Deve executar do Recovery.
./runaway bypass
suppress
Silencia o registro MDM sem criar um novo usuário. Funciona tanto do Recovery quanto do sistema já iniciado.
sudo ./runaway suppress
heal
Reaplica a supressão após atualizações do macOS reativarem os daemons de registro.
Em sistemas já iniciados, precisa de sudo. Com persist, executa automaticamente em cada inicialização.
sudo ./runaway heal
persist
Instala um LaunchDaemon que executa heal automaticamente em cada inicialização.
Sobrevive a atualizações do macOS.
sudo ./runaway persist
unpersist
Remove o LaunchDaemon de persistência.
sudo ./runaway unpersist
Firewall & Rede
| Comando | Descrição | Privilégio |
|---|---|---|
firewall |
Bloqueia faixas de IP Apple MDM via pf | sudo |
firewall-off |
Remove o bloqueio pf do MDM | sudo |
whitelist |
Bloqueia apenas domínios MDM, mantém iCloud/App Store | sudo |
firewall
Filtragem de pacotes a nível de kernel. Bloqueia toda a faixa de IP da Apple (17.0.0.0/8).
À prova de DoH — não pode ser contornado por DNS-over-HTTPS.
Aviso: Quebra iCloud, App Store e atualizações do sistema.
sudo ./runaway firewall
firewall-off
Remove as regras pf adicionadas por firewall.
sudo ./runaway firewall-off
whitelist
Resolve apenas domínios MDM para IPs e bloqueia especificamente aqueles. Mantém iCloud e App Store funcionando enquanto bloqueia o registro MDM.
sudo ./runaway whitelist
Sistema em Execução
| Comando | Descrição | Privilégio |
|---|---|---|
harden |
Mata processos MDM + remove perfis + limpa DNS | sudo |
audit |
Varredura profunda do sistema com score de risco | sudo |
harden
Mata processos MDM em execução, remove perfis de configuração e limpa o cache DNS. Útil quando o MDM está registrando ativamente em um sistema já iniciado.
sudo ./runaway harden
audit
Executa uma varredura MDM profunda:
- Verifica marcadores DEP
- Escaneia perfis de configuração
- Verifica launch agents e daemons
- Procura certificados MDM
- Gera um score de risco (0–100)
sudo ./runaway audit
Monitoramento
| Comando | Descrição |
|---|---|
check |
Relatório de segurança pré-formatação/pré-atualização |
monitor |
Inicia vigia MDM em segundo plano (intervalo de 5 min) |
monitor-install |
Instala o monitor como um LaunchDaemon |
monitor-uninstall |
Remove o LaunchDaemon do monitor |
monitor-stop |
Para o daemon do monitor |
monitor-status |
Verifica se o monitor está rodando |
history |
Mostra o log de eventos do monitor/heal |
history-clear |
Limpa o log de eventos |
check
Retorna SAFE TO FORMAT (sem MDM) ou MDM DETECTED (vai travar após limpar). Também verifica segurança para atualizações do macOS.
sudo ./runaway check
monitor
Daemon em segundo plano que verifica o estado do MDM a cada 5 minutos.
Envia uma notificação do macOS se o MDM tentar re-registrar.
Suporta --webhook opcional para alertas no Discord.
sudo ./runaway monitor
sudo ./runaway monitor --webhook https://discord.com/api/webhooks/...
history
Mostra o log de eventos de execuções anteriores do monitor e heal.
sudo ./runaway history
Gerenciamento de Estado
| Comando | Descrição |
|---|---|
backup |
Salva o estado atual (hosts, perfis, launchd, configurações) |
restore |
Restaura a partir de um backup anterior |
dualboot |
Mira uma instalação macOS externa |
backup
Salva /etc/hosts, estado dos perfis MDM, overrides launchd desabilitados e config do Runaway.
sudo ./runaway backup
restore
Reverte o sistema para um estado salvo anteriormente.
sudo ./runaway restore
dualboot
Cria uma conta admin e aplica supressão em um volume externo/bootcamp.
sudo ./runaway dualboot
Comandos Inteligentes (v2.0)
| Comando | Descrição |
|---|---|
init |
Assistente de configuração interativo |
suggest |
Análise de risco e recomendações baseadas no sistema |
remediate |
Limpeza MDM por organização |
predict |
Consulta de número serial — prevê qual organização registrou este Mac |
telemetry |
Gerencia estatísticas de uso anônimas (opt-in) |
init
Assistente interativo que executa a configuração completa: firewall → monitor → persist → backup → audit.
sudo ./runaway init
suggest
Analisa seu sistema e fornece recomendações baseadas em risco.
sudo ./runaway suggest
remediate
Limpeza MDM por organização. Suporta: JAMF, Mosyle, Addigy, Kandji, VMware. Detecta automaticamente a organização a partir do registro DEP.
sudo ./runaway remediate
predict
Lê o prefixo do número serial e verifica contra prefixos conhecidos de organizações MDM. Útil antes de comprar um Mac usado.
./runaway predict ABC12345678
telemetry
Gerencia estatísticas anônimas de uso (opt-in, DESLIGADO por padrão).
./runaway telemetry on
./runaway telemetry off
./runaway telemetry status
VPN Kill-Switch
| Comando | Descrição |
|---|---|
vpn-kill |
Instala pf kill-switch — bloqueia MDM fora da VPN |
vpn-kill-remove |
Remove o VPN kill-switch |
vpn-kill-status |
Verifica o estado do VPN kill-switch |
Projetado para Macs fornecidos por organizações que precisam registrar mas só devem se comunicar enquanto na VPN. Bloqueia IPs MDM quando o dispositivo NÃO está conectado ao túnel VPN.
sudo ./runaway vpn-kill
sudo ./runaway vpn-kill-status
sudo ./runaway vpn-kill-remove
Gerenciamento
| Comando | Descrição |
|---|---|
update |
Autoatualização a partir do último release do GitHub |
uninstall |
Remoção completa com confirmações de segurança |
reinstall |
Desinstalar + reinstalar (persist + whitelist + monitor) |
config |
Ver ou editar configurações persistentes |
report |
Relatório completo do sistema (markdown ou JSON) |
demo |
Fluxo de bypass simulado (sem alterações reais) |
version |
Mostra a versão |
update
Baixa o último release do GitHub. Verifica a assinatura GPG.
sudo ./runaway update
uninstall
Remove todos os vestígios do Runaway. Pede confirmação.
sudo ./runaway uninstall
reinstall
Desinstala e então reaplica persist + whitelist + monitor.
sudo ./runaway reinstall
config
Ver ou editar configurações persistentes em ~/.runaway.conf.
./runaway config
./runaway config show
./runaway config set key value
report
Gera um relatório completo de status. Suporta --json para saída legível por máquina.
sudo ./runaway report
sudo ./runaway report --json
demo
Executa um fluxo de bypass simulado. Nenhuma alteração real é feita.
./runaway demo
Bot do Discord
| Comando | Descrição |
|---|---|
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 |
Envia DMs no Discord quando atividade MDM é detectada.
sudo ./runaway discord-bot <token> <userId>
sudo ./runaway discord-bot-status
sudo ./runaway discord-bot-stop
Diagnósticos
| Comando | Descrição |
|---|---|
doctor |
Diagnóstico pré-voo — root, Recovery, libs, disco, dependências |
status |
Status do registro MDM (Recovery apenas, use -d para profundo) |
test |
Simulação dry-run de qualquer comando |
doctor
Verifica: privilégios root, detecção do modo Recovery, versão do bash, disco/volume, bibliotecas necessárias e conectividade com a internet.
./runaway doctor
status
Mostra estado dos marcadores DEP, arquivo hosts, overrides de daemon.
Só funciona do Recovery. Use check ou audit em sistemas já iniciados.
./runaway status
./runaway status -d
test
Modo dry-run. Simula um comando sem fazer alterações reais.
./runaway test bypass
./runaway test all
Aliases
by = bypass sv = suppress st = status
ls = status fw = firewall fw-off = firewall-off
wl = whitelist mn = monitor mn-install = monitor-install
mn-uninstall = monitor-uninstall mn-stop = monitor-stop
mn-st = monitor-status doc = doctor
up = update uni = uninstall rei = reinstall
vk = vpn-kill vkr = vpn-kill-remove vks = vpn-kill-status
Opções Globais
| Opção | Efeito |
|---|---|
--verbose |
Mostra mensagens de debug |
--dry-run |
Simula sem fazer alterações |
--log-file <caminho> |
Escreve logs em um arquivo (anexado) |