Files
runaway/docs/pt/commands.md
T
ruihan d43c23135f
CI / Bash Syntax Check (push) Successful in 3s
CI / Markdown Lint (push) Successful in 6s
CI / ShellCheck (push) Successful in 2m8s
feat(bypass): allow --username/--password/--full-name for unattended runs
2026-11-09 11:07:10 +08:00

367 lines
9.7 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
---
layout: default
title: 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`
Credenciais podem ser passadas via flags (também valem para `admin` e `dualboot`):
`--username <u>`, `--password <p>`, `--full-name <n>`; sem flags, o script pergunta.
Cria uma conta admin temporária e suprime todas as 5 camadas do MDM.
**Deve executar do Recovery.**
```bash
./runaway bypass
```
### `suppress`
Silencia o registro MDM sem criar um novo usuário.
Funciona tanto do Recovery quanto do sistema já iniciado.
```bash
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.
```bash
sudo ./runaway heal
```
### `persist`
Instala um LaunchDaemon que executa `heal` automaticamente em cada inicialização.
Sobrevive a atualizações do macOS.
```bash
sudo ./runaway persist
```
### `unpersist`
Remove o LaunchDaemon de persistência.
```bash
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.
```bash
sudo ./runaway firewall
```
### `firewall-off`
Remove as regras pf adicionadas por `firewall`.
```bash
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.
```bash
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.
```bash
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)
```bash
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.
```bash
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.
```bash
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.
```bash
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.
```bash
sudo ./runaway backup
```
### `restore`
Reverte o sistema para um estado salvo anteriormente.
```bash
sudo ./runaway restore
```
### `dualboot`
Cria uma conta admin e aplica supressão em um volume externo/bootcamp.
```bash
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.
```bash
sudo ./runaway init
```
### `suggest`
Analisa seu sistema e fornece recomendações baseadas em risco.
```bash
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.
```bash
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.
```bash
./runaway predict ABC12345678
```
### `telemetry`
Gerencia estatísticas anônimas de uso (opt-in, DESLIGADO por padrão).
```bash
./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.
```bash
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.
```bash
sudo ./runaway update
```
### `uninstall`
Remove todos os vestígios do Runaway. Pede confirmação.
```bash
sudo ./runaway uninstall
```
### `reinstall`
Desinstala e então reaplica persist + whitelist + monitor.
```bash
sudo ./runaway reinstall
```
### `config`
Ver ou editar configurações persistentes em `~/.runaway.conf`.
```bash
./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.
```bash
sudo ./runaway report
sudo ./runaway report --json
```
### `demo`
Executa um fluxo de bypass simulado. Nenhuma alteração real é feita.
```bash
./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.
```bash
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.
```bash
./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.
```bash
./runaway status
./runaway status -d
```
### `test`
Modo dry-run. Simula um comando sem fazer alterações reais.
```bash
./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) |