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

9.6 KiB
Raw Blame History

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
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. 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)