rename project to runaway

This commit is contained in:
2026-11-09 10:13:51 +08:00
parent 20946dd445
commit 205f2faf02
95 changed files with 1034 additions and 1034 deletions
+48 -48
View File
@@ -1,6 +1,6 @@
---
layout: default
title: Referência de Comandos — unleash
title: Referência de Comandos — runaway
---
# Referência de Comandos
@@ -19,34 +19,34 @@ title: Referência de Comandos — unleash
Cria uma conta admin temporária e suprime todas as 5 camadas do MDM.
**Deve executar do Recovery.**
```bash
./unleash bypass
./runaway bypass
```
### `suppress`
Silencia o registro MDM sem criar um novo usuário.
Funciona tanto do Recovery quanto do sistema já iniciado.
```bash
sudo ./unleash suppress
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 ./unleash heal
sudo ./runaway heal
```
### `persist`
Instala um LaunchDaemon que executa `heal` automaticamente em cada inicialização.
Sobrevive a atualizações do macOS.
```bash
sudo ./unleash persist
sudo ./runaway persist
```
### `unpersist`
Remove o LaunchDaemon de persistência.
```bash
sudo ./unleash unpersist
sudo ./runaway unpersist
```
---
@@ -64,20 +64,20 @@ Filtragem de pacotes a nível de kernel. Bloqueia toda a faixa de IP da Apple (`
À prova de DoH — não pode ser contornado por DNS-over-HTTPS.
**Aviso:** Quebra iCloud, App Store e atualizações do sistema.
```bash
sudo ./unleash firewall
sudo ./runaway firewall
```
### `firewall-off`
Remove as regras pf adicionadas por `firewall`.
```bash
sudo ./unleash firewall-off
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 ./unleash whitelist
sudo ./runaway whitelist
```
---
@@ -93,7 +93,7 @@ sudo ./unleash whitelist
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 ./unleash harden
sudo ./runaway harden
```
### `audit`
@@ -104,7 +104,7 @@ Executa uma varredura MDM profunda:
- Procura certificados MDM
- Gera um score de risco (0–100)
```bash
sudo ./unleash audit
sudo ./runaway audit
```
---
@@ -126,7 +126,7 @@ sudo ./unleash audit
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 ./unleash check
sudo ./runaway check
```
### `monitor`
@@ -134,14 +134,14 @@ 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 ./unleash monitor
sudo ./unleash monitor --webhook https://discord.com/api/webhooks/...
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 ./unleash history
sudo ./runaway history
```
---
@@ -155,21 +155,21 @@ sudo ./unleash history
| `dualboot` | Mira uma instalação macOS externa |
### `backup`
Salva `/etc/hosts`, estado dos perfis MDM, overrides launchd desabilitados e config do Unleash.
Salva `/etc/hosts`, estado dos perfis MDM, overrides launchd desabilitados e config do Runaway.
```bash
sudo ./unleash backup
sudo ./runaway backup
```
### `restore`
Reverte o sistema para um estado salvo anteriormente.
```bash
sudo ./unleash restore
sudo ./runaway restore
```
### `dualboot`
Cria uma conta admin e aplica supressão em um volume externo/bootcamp.
```bash
sudo ./unleash dualboot
sudo ./runaway dualboot
```
---
@@ -188,35 +188,35 @@ sudo ./unleash dualboot
Assistente interativo que executa a configuração completa:
firewall → monitor → persist → backup → audit.
```bash
sudo ./unleash init
sudo ./runaway init
```
### `suggest`
Analisa seu sistema e fornece recomendações baseadas em risco.
```bash
sudo ./unleash suggest
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 ./unleash remediate
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
./unleash predict ABC12345678
./runaway predict ABC12345678
```
### `telemetry`
Gerencia estatísticas anônimas de uso (opt-in, DESLIGADO por padrão).
```bash
./unleash telemetry on
./unleash telemetry off
./unleash telemetry status
./runaway telemetry on
./runaway telemetry off
./runaway telemetry status
```
---
@@ -232,9 +232,9 @@ Gerencia estatísticas anônimas de uso (opt-in, DESLIGADO por padrão).
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 ./unleash vpn-kill
sudo ./unleash vpn-kill-status
sudo ./unleash vpn-kill-remove
sudo ./runaway vpn-kill
sudo ./runaway vpn-kill-status
sudo ./runaway vpn-kill-remove
```
---
@@ -254,40 +254,40 @@ sudo ./unleash vpn-kill-remove
### `update`
Baixa o último release do GitHub. Verifica a assinatura GPG.
```bash
sudo ./unleash update
sudo ./runaway update
```
### `uninstall`
Remove todos os vestígios do Unleash. Pede confirmação.
Remove todos os vestígios do Runaway. Pede confirmação.
```bash
sudo ./unleash uninstall
sudo ./runaway uninstall
```
### `reinstall`
Desinstala e então reaplica persist + whitelist + monitor.
```bash
sudo ./unleash reinstall
sudo ./runaway reinstall
```
### `config`
Ver ou editar configurações persistentes em `~/.unleash.conf`.
Ver ou editar configurações persistentes em `~/.runaway.conf`.
```bash
./unleash config
./unleash config show
./unleash config set key value
./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 ./unleash report
sudo ./unleash report --json
sudo ./runaway report
sudo ./runaway report --json
```
### `demo`
Executa um fluxo de bypass simulado. Nenhuma alteração real é feita.
```bash
./unleash demo
./runaway demo
```
---
@@ -302,9 +302,9 @@ Executa um fluxo de bypass simulado. Nenhuma alteração real é feita.
Envia DMs no Discord quando atividade MDM é detectada.
```bash
sudo ./unleash discord-bot <token> <userId>
sudo ./unleash discord-bot-status
sudo ./unleash discord-bot-stop
sudo ./runaway discord-bot <token> <userId>
sudo ./runaway discord-bot-status
sudo ./runaway discord-bot-stop
```
---
@@ -321,22 +321,22 @@ sudo ./unleash discord-bot-stop
Verifica: privilégios root, detecção do modo Recovery, versão do bash,
disco/volume, bibliotecas necessárias e conectividade com a internet.
```bash
./unleash doctor
./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
./unleash status
./unleash status -d
./runaway status
./runaway status -d
```
### `test`
Modo dry-run. Simula um comando sem fazer alterações reais.
```bash
./unleash test bypass
./unleash test all
./runaway test bypass
./runaway test all
```
---
+14 -14
View File
@@ -1,6 +1,6 @@
---
layout: default
title: FAQ — unleash
title: FAQ — runaway
---
# FAQ
@@ -13,7 +13,7 @@ title: FAQ — unleash
### É a mesma coisa que bypass-mdm?
Não. Os scripts originais do bypass-mdm (v2, v3, express) só lidam com marcadores DEP e `/etc/hosts`. O Unleash cobre todas as cinco camadas:
Não. Os scripts originais do bypass-mdm (v2, v3, express) só lidam com marcadores DEP e `/etc/hosts`. O Runaway cobre todas as cinco camadas:
- Marcadores DEP (igual ao original)
- Bloqueio de rede via `/etc/hosts` (igual)
@@ -38,7 +38,7 @@ Não. A instalação limpa apaga o volume de Dados. Execute `bypass` do Recovery
### Sobrevive a uma atualização do macOS?
Geralmente sim, com `persist`. O LaunchDaemon executa `heal` automaticamente na próxima inicialização após uma atualização. Sem `persist`, execute `sudo ./unleash heal` manualmente.
Geralmente sim, com `persist`. O LaunchDaemon executa `heal` automaticamente na próxima inicialização após uma atualização. Sem `persist`, execute `sudo ./runaway heal` manualmente.
### A organização pode rastrear isso?
@@ -50,11 +50,11 @@ Sim. Use `whitelist` em vez de `firewall` ou `suppress` básico. Ele resolve ape
### Por que o MDM volta depois do Migration Assistant?
O Migration Assistant copia caches, preferências e launch agents do Mac antigo. Estes contêm artefatos de registro MDM que reativam o processo de registro. A maioria das ferramentas só limpa marcadores DEP de nível de sistema — o Unleash também limpa o diretório Library de cada usuário.
O Migration Assistant copia caches, preferências e launch agents do Mac antigo. Estes contêm artefatos de registro MDM que reativam o processo de registro. A maioria das ferramentas só limpa marcadores DEP de nível de sistema — o Runaway também limpa o diretório Library de cada usuário.
### Tem interface gráfica?
Ainda não. A CLI é a interface principal. Um wrapper SwiftUI está no [roadmap](https://github.com/mateussiqueira/unleash/blob/main/ROADMAP.md).
Ainda não. A CLI é a interface principal. Um wrapper SwiftUI está no [roadmap](https://github.com/mateussiqueira/runaway/blob/main/ROADMAP.md).
### Qual é a licença?
@@ -65,7 +65,7 @@ MIT. Gratuito para usar, modificar e distribuir.
### Como saber se meu Mac está registrado no MDM?
```bash
sudo ./unleash check
sudo ./runaway check
```
Retorna SAFE TO FORMAT (sem MDM) ou MDM DETECTED (vai travar após limpar).
@@ -73,14 +73,14 @@ Retorna SAFE TO FORMAT (sem MDM) ou MDM DETECTED (vai travar após limpar).
### Como verificar se o bypass ainda está funcionando?
```bash
sudo ./unleash status -d
sudo ./runaway status -d
```
Verifica marcadores DEP, arquivo hosts, overrides de daemon e estado dos perfis.
### `profiles status -v` ainda mostra um perfil MDM — por quê?
Cosmético. O macOS armazena o estado dos perfis no SSV (Volume Selado do Sistema) somente leitura. Os daemons de registro reais estão desabilitados e os marcadores DEP foram removidos. Confie em `unleash status` em vez de `profiles status`.
Cosmético. O macOS armazena o estado dos perfis no SSV (Volume Selado do Sistema) somente leitura. Os daemons de registro reais estão desabilitados e os marcadores DEP foram removidos. Confie em `runaway status` em vez de `profiles status`.
### Qual a diferença entre `monitor` e `persist`?
@@ -104,12 +104,12 @@ Ele lê o prefixo do número serial e verifica contra prefixos conhecidos de org
Execute do Recovery:
```bash
sudo ./unleash suppress
sudo ./runaway suppress
```
Ou de um sistema já iniciado:
```bash
sudo ./unleash harden
sudo ./runaway harden
```
### Erro "Not a known DirStatus"
@@ -118,7 +118,7 @@ A detecção automática de volume falhou. Encontre seu volume de Dados:
```bash
diskutil list
diskutil mount /dev/diskXsY
./unleash bypass
./runaway bypass
```
### Desbloqueio do FileVault falha no Recovery
@@ -127,13 +127,13 @@ Você precisa de uma senha de usuário ou da chave de recuperação do FileVault
### "Not a macOS Data volume"
O Unleash verifica `/private/var/db/dslocal/nodes/Default` no volume montado. Se estiver faltando, você montou o disco errado. Execute `diskutil list` para encontrar o volume de Dados correto.
O Runaway verifica `/private/var/db/dslocal/nodes/Default` no volume montado. Se estiver faltando, você montou o disco errado. Execute `diskutil list` para encontrar o volume de Dados correto.
### Monitor não inicia
1. Verifique se já está rodando: `sudo ./unleash monitor-status`
1. Verifique se já está rodando: `sudo ./runaway monitor-status`
2. Verifique permissões: precisa de root
3. Verifique logs: `/var/log/unleash-monitor.log`
3. Verifique logs: `/var/log/runaway-monitor.log`
---
+11 -11
View File
@@ -1,20 +1,20 @@
---
layout: default
title: Guia de Arquitetura — unleash
title: Guia de Arquitetura — runaway
---
# Guia de Arquitetura
## As Cinco Camadas do MDM
O registro MDM da Apple funciona através de cinco mecanismos independentes. Bloquear apenas um ou dois é o motivo pelo qual ferramentas de bypass falham com o tempo. O Unleash aborda todos os cinco.
O registro MDM da Apple funciona através de cinco mecanismos independentes. Bloquear apenas um ou dois é o motivo pelo qual ferramentas de bypass falham com o tempo. O Runaway aborda todos os cinco.
```
Camada 1: Marcadores DEP ─── /var/db/ConfigurationProfiles/Settings/.cloudConfig*
Camada 2: Bloqueio hosts ─── /etc/hosts → 0.0.0.0 deviceenrollment.apple.com
Camada 3: Daemons ─── launchd desabilitado → ManagedClient.enroll, activationd
Camada 4: Dados usuário ─── ~/Library/Preferences/com.apple.mdm.*
Camada 5: Firewall pf ─── pf anchor com.unleash/mdm → bloqueio kernel
Camada 5: Firewall pf ─── pf anchor com.runaway/mdm → bloqueio kernel
```
### Camada 1: Marcadores de Registro DEP
@@ -100,8 +100,8 @@ pf (packet filter) opera na camada de rede do kernel, abaixo da resolução DNS.
## Arquitetura do Script
```
unleash/
├── unleash # Ponto de entrada principal
runaway/
├── runaway # Ponto de entrada principal
├── lib/
│ ├── colors.sh # Logging, cores, prompts, show_cmd_help()
│ ├── detect.sh # Detecção de Recovery, montagem de volume
@@ -138,28 +138,28 @@ unleash/
### Fluxo de Dispatch
1. `unleash` carrega todos os módulos `lib/*.sh`
2. `load_config()` lê `~/.unleash.conf` (se existir)
1. `runaway` carrega todos os módulos `lib/*.sh`
2. `load_config()` lê `~/.runaway.conf` (se existir)
3. O argumento do comando é casado com o `case` dispatch no main
4. A função handler é chamada (ex.: `cmd_bypass`, `cmd_firewall`)
5. Cada handler chama funções lib que fazem o trabalho real
### Build Autocontido
`examples/build-standalone.sh` concatena todos os módulos lib + corpo do script principal em um único arquivo (`unleash-standalone.sh`, ~3200 linhas). Sem dependências externas — funciona em qualquer macOS com bash.
`examples/build-standalone.sh` concatena todos os módulos lib + corpo do script principal em um único arquivo (`runaway-standalone.sh`, ~3200 linhas). Sem dependências externas — funciona em qualquer macOS com bash.
## Processo de Build
1. **Fonte**: Módulos `lib/*.sh` individuais + ponto de entrada `unleash`
1. **Fonte**: Módulos `lib/*.sh` individuais + ponto de entrada `runaway`
2. **Teste**: 78 testes Bats cobrindo todos os módulos
3. **Build**: `bash examples/build-standalone.sh` → `unleash-standalone.sh`
3. **Build**: `bash examples/build-standalone.sh` → `runaway-standalone.sh`
4. **Assinar**: `scripts/sign-release.sh` → Assinatura GPG destacada
5. **Release**: Release GitHub com standalone + assinatura + checksums
## Design de Segurança
### Sem persistência root
O Unleash não instala backdoor, cria usuários ocultos ou modifica o volume do sistema. Todas as alterações são reversíveis.
O Runaway não instala backdoor, cria usuários ocultos ou modifica o volume do sistema. Todas as alterações são reversíveis.
### Releases assinados com GPG
Releases são assinados com chave GPG. O `selfupdate` verifica a assinatura antes de aplicar atualizações.
+43 -43
View File
@@ -1,15 +1,15 @@
---
layout: default
title: unleash
title: runaway
description: Bypass MDM em um único script para macOS — cobre todas as 5 camadas do MDM da Apple
---
<p align="center">
<img src="../icon.svg" width="100" alt="unleash logo">
<img src="../icon.svg" width="100" alt="runaway logo">
<br>
<strong>unleash</strong>
<strong>runaway</strong>
<br>
<em>unleash</em>
<em>runaway</em>
</p>
<p align="center">
@@ -23,12 +23,12 @@ description: Bypass MDM em um único script para macOS — cobre todas as 5 cama
---
unleash 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.
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 unleash diferente de outras ferramentas de bypass:**
**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 Unleash limpa todos os diretórios home.
- **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.
@@ -40,19 +40,19 @@ unleash substitui os cinco scripts originais do bypass-mdm em um único arquivo
**Homebrew (mais fácil)**
```bash
brew install mateussiqueira/unleash/unleash
brew install mateussiqueira/runaway/runaway
```
**Download direto**
```bash
curl -L https://raw.githubusercontent.com/mateussiqueira/unleash/main/unleash-standalone.sh -o unleash
chmod +x unleash
curl -L https://raw.githubusercontent.com/mateussiqueira/runaway/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 `unleash` (ou apenas `unleash-standalone.sh`) para o drive
3. Inicialize no Recovery e execute de `/Volumes/SeuDrive/unleash`
2. Copie a pasta `runaway` (ou apenas `runaway-standalone.sh`) para o drive
3. Inicialize no Recovery e execute de `/Volumes/SeuDrive/runaway`
---
@@ -68,7 +68,7 @@ chmod +x unleash
3. Execute:
```bash
"/Volumes/SeuDrive/unleash" bypass
"/Volumes/SeuDrive/runaway" bypass
```
4. Siga as instruções para criar um usuário admin temporário
@@ -80,19 +80,19 @@ chmod +x unleash
Se você já tem um Mac que foi bypassado anteriormente e o MDM voltou após uma atualização:
```bash
sudo ./unleash heal
sudo ./runaway heal
```
Ou para verificar o status atual:
```bash
sudo ./unleash status -d
sudo ./runaway status -d
```
### Configuração com um comando (Mac novo)
```bash
sudo ./unleash init
sudo ./runaway init
```
Assistente interativo que executa a configuração completa: firewall, monitor, persist, backup e audit.
@@ -156,7 +156,7 @@ Assistente interativo que executa a configuração completa: firewall, monitor,
| `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 `~/.unleash.conf` |
| `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 |
@@ -205,8 +205,8 @@ dbs = discord-bot-stop dbs2 = discord-bot-status
### Antes de comprar um Mac usado
```bash
./unleash predict ABC12345678 # verifica serial contra organizações conhecidas
./unleash check # este Mac é seguro para formatar?
./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.
@@ -217,19 +217,19 @@ dbs = discord-bot-stop dbs2 = discord-bot-status
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 `unleash 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.
**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 ./unleash 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.
**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 `unleash init` — assistente interativo
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
@@ -237,7 +237,7 @@ dbs = discord-bot-stop dbs2 = discord-bot-status
## Como Funciona
O MDM (Mobile Device Management) opera em cinco camadas no macOS. O Unleash bloqueia todas elas:
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**
@@ -249,13 +249,13 @@ O MDM (Mobile Device Management) opera em cinco camadas no macOS. O Unleash bloq
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 unleash 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.
**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 unleash faz**:
**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.
@@ -289,7 +289,7 @@ O macOS registra quatro daemons de registro que executam na inicialização:
| `com.apple.mdmclient.daemon.runatboot` | Cliente MDM |
| `com.apple.activationd` | Ativação do dispositivo |
**O que o unleash faz**: Cria overrides launchd desabilitados para todos os quatro, impedindo que iniciem.
**O que o runaway faz**: Cria overrides launchd desabilitados para todos os quatro, impedindo que iniciem.
### Camada 4: Limpeza de artefatos de usuário
@@ -303,7 +303,7 @@ O Migration Assistant e caches de login deixam dados de registro MDM nos diretó
~/Library/LaunchAgents/com.apple.mdm.*
```
**O que o unleash faz**: Varre todos os diretórios home no volume de Dados e remove todos os preferences, caches e launch agents relacionados ao 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)
@@ -350,11 +350,11 @@ Deve funcionar em qualquer versão que use o mesmo mecanismo de registro MDM —
A causa mais provável são artefatos de nível de usuário. Execute do Recovery:
```bash
sudo ./unleash suppress
sudo ./runaway suppress
```
Ou de um sistema já iniciado:
```bash
sudo ./unleash harden
sudo ./runaway harden
```
### Erro "Not a known DirStatus"
@@ -362,22 +362,22 @@ sudo ./unleash harden
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 unleash novamente
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 ./unleash status -d
sudo ./runaway status -d
```
### FileVault está ativado
O Unleash 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.
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 ./unleash heal` após qualquer atualização do macOS. Se você usou `persist` antes da atualização, isso acontece automaticamente na próxima inicialização.
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?
@@ -396,7 +396,7 @@ Você precisa de um segundo Mac com Apple Configurator 2 (grátis), um cabo USB-
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 `unleash bypass`
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).
@@ -410,7 +410,7 @@ 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 ./unleash firewall
[ERR] Firewall needs sudo: sudo ./runaway firewall
[STP] Locating Data volume by APFS role...
[DBG] Checking pfctl availability
```
@@ -431,13 +431,13 @@ Use `--verbose` para mensagens de debug e `--log-file <caminho>` para escrever t
## Links
- [Repositório GitHub](https://github.com/mateussiqueira/unleash)
- [README completo](https://github.com/mateussiqueira/unleash/blob/main/README.md)
- [Repositório GitHub](https://github.com/mateussiqueira/runaway)
- [README completo](https://github.com/mateussiqueira/runaway/blob/main/README.md)
- [Guia de Arquitetura](guide)
- [FAQ](faq)
- [Changelog](https://github.com/mateussiqueira/unleash/blob/main/CHANGELOG.md)
- [Contribuindo](https://github.com/mateussiqueira/unleash/blob/main/CONTRIBUTING.md)
- [Código de Conduta](https://github.com/mateussiqueira/unleash/blob/main/CODE_OF_CONDUCT.md)
- [Política de Segurança](https://github.com/mateussiqueira/unleash/blob/main/SECURITY.md)
- [Discussões](https://github.com/mateussiqueira/unleash/discussions)
- [Reportar Bug](https://github.com/mateussiqueira/unleash/issues/new?template=bug_report.md)
- [Changelog](https://github.com/mateussiqueira/runaway/blob/main/CHANGELOG.md)
- [Contribuindo](https://github.com/mateussiqueira/runaway/blob/main/CONTRIBUTING.md)
- [Código de Conduta](https://github.com/mateussiqueira/runaway/blob/main/CODE_OF_CONDUCT.md)
- [Política de Segurança](https://github.com/mateussiqueira/runaway/blob/main/SECURITY.md)
- [Discussões](https://github.com/mateussiqueira/runaway/discussions)
- [Reportar Bug](https://github.com/mateussiqueira/runaway/issues/new?template=bug_report.md)
+17 -17
View File
@@ -1,6 +1,6 @@
---
layout: default
title: Instalação — unleash
title: Instalação — runaway
---
# Instalação
@@ -8,51 +8,51 @@ title: Instalação — unleash
## Homebrew (mais fácil)
```bash
brew tap mateussiqueira/unleash
brew install unleash
brew tap mateussiqueira/runaway
brew install runaway
```
Ou em um passo:
```bash
brew install mateussiqueira/unleash/unleash
brew install mateussiqueira/runaway/runaway
```
## Download direto
```bash
curl -L https://raw.githubusercontent.com/mateussiqueira/unleash/main/unleash-standalone.sh -o unleash
chmod +x unleash
sudo ./unleash init
curl -L https://raw.githubusercontent.com/mateussiqueira/runaway/main/runaway-standalone.sh -o runaway
chmod +x runaway
sudo ./runaway init
```
## De um pendrive USB (para o modo Recovery)
1. Formate um USB/SSD como **FAT32**, **APFS** ou **exFAT**
2. Copie a pasta `unleash` (ou apenas `unleash-standalone.sh`) para o drive
3. Inicialize no Recovery e execute de `/Volumes/SeuDrive/unleash`
2. Copie a pasta `runaway` (ou apenas `runaway-standalone.sh`) para o drive
3. Inicialize no Recovery e execute de `/Volumes/SeuDrive/runaway`
## Via curl no Recovery (precisa de internet)
```bash
curl -L https://raw.githubusercontent.com/mateussiqueira/unleash/main/unleash -o /tmp/unleash
chmod +x /tmp/unleash && /tmp/unleash bypass
curl -L https://raw.githubusercontent.com/mateussiqueira/runaway/main/runaway -o /tmp/runaway
chmod +x /tmp/runaway && /tmp/runaway bypass
```
## Compilando a partir do código-fonte
```bash
git clone https://github.com/mateussiqueira/unleash.git
cd unleash
git clone https://github.com/mateussiqueira/runaway.git
cd runaway
bash examples/build-standalone.sh
# Saída: unleash-standalone.sh (~3200 linhas)
# Saída: runaway-standalone.sh (~3200 linhas)
```
## Verificando a instalação
```bash
./unleash version
# → unleash v2.0.0
./runaway version
# → runaway v2.0.0
./unleash doctor
./runaway doctor
# Executa diagnósticos pré-voo
```
+21 -21
View File
@@ -1,6 +1,6 @@
---
layout: default
title: Cenários — unleash
title: Cenários — runaway
---
# Cenários
@@ -10,8 +10,8 @@ title: Cenários — unleash
Verifique o número serial antes de comprar:
```bash
./unleash predict ABC12345678 # verifica serial contra prefixos conhecidos
./unleash check # este Mac é seguro para limpar?
./runaway predict ABC12345678 # verifica serial contra prefixos conhecidos
./runaway check # este Mac é seguro para limpar?
```
`predict` consulta o serial contra prefixos conhecidos de organizações MDM.
@@ -27,12 +27,12 @@ Se corresponder a JAMF, Mosyle ou outra organização, você sabe o que esperar
**Solução:** Inicialize no Recovery e execute:
```bash
./unleash suppress
./runaway suppress
```
Ou `bypass` se precisar de um novo usuário admin. Remove os marcadores DEP,
artefatos de nível de usuário e preferências MDM que o MA transferiu.
*Este é o caso #1 que a maioria das outras ferramentas não trata — o Unleash lida com ele.*
*Este é o caso #1 que a maioria das outras ferramentas não trata — o Runaway lida com ele.*
---
@@ -43,7 +43,7 @@ artefatos de nível de usuário e preferências MDM que o MA transferiu.
**Solução:**
```bash
sudo ./unleash heal
sudo ./runaway heal
```
Re-desabilita daemons e verifica todas as camadas. Se você executou `persist`
@@ -58,8 +58,8 @@ antes da atualização, isso acontece automaticamente na próxima inicializaçã
**Estratégia:**
1. Inicialize no Recovery **sem conectar ao Wi-Fi**
2. Execute `unleash bypass` antes do dispositivo contatar a Apple
3. Execute `unleash persist` e `unleash whitelist` para mantê-lo limpo
2. Execute `runaway bypass` antes do dispositivo contatar a Apple
3. Execute `runaway persist` e `runaway whitelist` para mantê-lo limpo
4. Só então conecte-se à internet
O serial fica no ABM para sempre — mas enquanto o dispositivo nunca conectar
@@ -70,10 +70,10 @@ com todas as proteções removidas, ele não vai re-registrar.
## Mac usado que já tem um usuário logado
```bash
sudo ./unleash audit # verifica o estado atual
sudo ./unleash harden # mata processos MDM imediatamente
sudo ./unleash whitelist # bloqueia MDM mantendo iCloud
sudo ./unleash persist # sobrevive a atualizações futuras
sudo ./runaway audit # verifica o estado atual
sudo ./runaway harden # mata processos MDM imediatamente
sudo ./runaway whitelist # bloqueia MDM mantendo iCloud
sudo ./runaway persist # sobrevive a atualizações futuras
```
---
@@ -81,7 +81,7 @@ sudo ./unleash persist # sobrevive a atualizações futuras
## Configurando um Mac novo antes do primeiro boot
1. Inicialize no Recovery sem Wi-Fi
2. Execute `unleash init` — assistente interativo
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
@@ -92,7 +92,7 @@ sudo ./unleash persist # sobrevive a atualizações futuras
Algumas organizações exigem que o Mac registre, mas somente quando conectado à VPN corporativa.
```bash
sudo ./unleash vpn-kill
sudo ./runaway vpn-kill
```
Isso instala um pf kill-switch que bloqueia tráfego MDM quando o dispositivo
@@ -108,8 +108,8 @@ Uma restauração DFU apaga tudo mas não remove a atribuição ABM.
1. Restaure via Apple Configurator 2
2. **Não conecte ao Wi-Fi**
3. Inicialize no Recovery
4. Execute `unleash bypass`
5. Execute `unleash persist && unleash whitelist`
4. Execute `runaway bypass`
5. Execute `runaway persist && runaway whitelist`
6. Reinicie e conecte-se à internet com segurança
---
@@ -120,15 +120,15 @@ Para implantar em múltiplas máquinas:
```bash
# Bypass via script
./unleash suppress --log-file /var/log/unleash-deploy.log
./runaway suppress --log-file /var/log/runaway-deploy.log
# Com persist + monitor
sudo ./unleash persist
sudo ./unleash monitor
sudo ./runaway persist
sudo ./runaway monitor
# Relatório de auditoria em JSON
sudo ./unleash report --json
sudo ./runaway report --json
# Alertas no Discord
sudo ./unleash discord-bot <token> <userId>
sudo ./runaway discord-bot <token> <userId>
```
+3 -3
View File
@@ -1,6 +1,6 @@
---
layout: default
title: Segurança — unleash
title: Segurança — runaway
---
# Segurança & Proteção
@@ -8,7 +8,7 @@ title: Segurança — unleash
## Princípios de Design
### Sem persistência root
O Unleash não instala backdoor, cria usuários ocultos ou modifica o
O Runaway não instala backdoor, cria usuários ocultos ou modifica o
volume do sistema. Todas as alterações miram o **volume de Dados**
apenas e são totalmente reversíveis.
@@ -58,4 +58,4 @@ precisam de acesso à rede.
## Divulgação Responsável
Encontrou um problema de segurança?
Veja a [Política de Segurança](https://github.com/mateussiqueira/unleash/blob/main/SECURITY.md).
Veja a [Política de Segurança](https://github.com/mateussiqueira/runaway/blob/main/SECURITY.md).
+41 -41
View File
@@ -1,6 +1,6 @@
---
layout: default
title: Solução de Problemas — unleash
title: Solução de Problemas — runaway
---
# Solução de Problemas
@@ -16,7 +16,7 @@ A detecção automática de volume falhou.
**Solução:**
1. Execute `diskutil list` para encontrar seu volume de Dados
2. Monte: `diskutil mount /dev/diskXsY`
3. Execute o unleash novamente
3. Execute o runaway novamente
---
@@ -34,11 +34,11 @@ A detecção automática de volume falhou.
Vários comandos precisam de root:
```
[ERR] Firewall needs sudo: sudo ./unleash firewall
[ERR] Heal needs sudo: sudo ./unleash heal
[ERR] Hardening needs sudo: sudo ./unleash harden
[ERR] Audit needs sudo: sudo ./unleash audit
[ERR] Check needs sudo: sudo ./unleash check
[ERR] Firewall needs sudo: sudo ./runaway firewall
[ERR] Heal needs sudo: sudo ./runaway heal
[ERR] Hardening needs sudo: sudo ./runaway harden
[ERR] Audit needs sudo: sudo ./runaway audit
[ERR] Check needs sudo: sudo ./runaway check
```
**Solução:** Anteceda `sudo` ao comando.
@@ -51,18 +51,18 @@ A causa mais comum são **artefatos de nível de usuário** trazidos pelo Migrat
**Solução do Recovery:**
```bash
sudo ./unleash suppress
sudo ./runaway suppress
```
**Solução do sistema já iniciado:**
```bash
sudo ./unleash harden
sudo ./runaway harden
```
Se continuar voltando:
```bash
sudo ./unleash persist # auto-recuperação em cada inicialização
sudo ./unleash monitor # vigia re-registro
sudo ./runaway persist # auto-recuperação em cada inicialização
sudo ./runaway monitor # vigia re-registro
```
---
@@ -73,7 +73,7 @@ Atualizações do sistema restauram os daemons de registro automaticamente.
**Solução:**
```bash
sudo ./unleash heal
sudo ./runaway heal
```
Se você executou `persist` antes da atualização, isso acontece automaticamente na próxima inicialização.
@@ -85,19 +85,19 @@ Se você executou `persist` antes da atualização, isso acontece automaticament
Isso é **cosmético**. O macOS armazena o estado dos perfis no SSV (Volume Selado do Sistema) somente leitura.
**Não confie** em `profiles status -v`.
**Confie** em `unleash status -d`.
**Confie** em `runaway status -d`.
---
### FileVault está ativado
O Unleash detecta FileVault e pede a chave de recuperação ou senha do volume.
O Runaway detecta FileVault e pede a chave de recuperação ou senha do volume.
**Solução:** Se o desbloqueio automático falhar, desbloqueie o volume manualmente no Utilitário de Disco primeiro:
1. Vá para o Utilitário de Disco no Recovery
2. Selecione o volume de Dados
3. Arquivo → Desbloquear → Digite a senha
4. Execute o unleash novamente
4. Execute o runaway novamente
---
@@ -107,7 +107,7 @@ O bloqueio básico de `/etc/hosts` inclui `albert.apple.com` (ativação do iClo
**Solução:** Use `whitelist` em vez do bloqueio básico:
```bash
sudo ./unleash whitelist
sudo ./runaway whitelist
```
Ou remova manualmente estas duas linhas de `/etc/hosts`:
@@ -133,14 +133,14 @@ Ou remova manualmente estas duas linhas de `/etc/hosts`:
### Monitor não inicia
**Verifique:**
1. Já está rodando? `sudo ./unleash monitor-status`
1. Já está rodando? `sudo ./runaway monitor-status`
2. Permissões: precisa de root
3. Logs: `/var/log/unleash-monitor.log`
3. Logs: `/var/log/runaway-monitor.log`
**Solução:**
```bash
sudo ./unleash monitor-stop
sudo ./unleash monitor
sudo ./runaway monitor-stop
sudo ./runaway monitor
```
---
@@ -150,7 +150,7 @@ sudo ./unleash monitor
O modo Recovery não tem internet por padrão.
**Solução:**
1. Use um pendrive USB com o unleash copiado
1. Use um pendrive USB com o runaway copiado
2. Ou conecte-se ao Wi-Fi no Recovery (menu superior direito → ícone Wi-Fi)
---
@@ -161,10 +161,10 @@ O modo Recovery não tem internet por padrão.
ERROR: Library not found: /path/to/lib/colors.sh
```
**Causa:** Executando o script `unleash` fonte de fora do diretório do repositório.
**Causa:** Executando o script `runaway` fonte de fora do diretório do repositório.
**Solução:**
- Use a versão standalone (`unleash-standalone.sh`)
- Use a versão standalone (`runaway-standalone.sh`)
- Ou execute da raiz do repositório onde o diretório `lib/` existe
- Ou instale via Homebrew
@@ -176,8 +176,8 @@ pf pode ter regras existentes que conflitam.
**Solução:**
```bash
sudo ./unleash firewall-off # limpa regras existentes
sudo ./unleash firewall # reaplica
sudo ./runaway firewall-off # limpa regras existentes
sudo ./runaway firewall # reaplica
```
---
@@ -189,8 +189,8 @@ Uma restauração DFU/IPSW completa não remove a atribuição ABM — o serial
**Estratégia:**
1. Após restaurar, **não conecte ao Wi-Fi**
2. Inicialize no Recovery
3. Execute `unleash bypass` antes do dispositivo contatar a Apple
4. Execute `unleash persist` e `unleash whitelist`
3. Execute `runaway bypass` antes do dispositivo contatar a Apple
4. Execute `runaway persist` e `runaway whitelist`
5. Só então conecte-se à internet
O serial fica no ABM para sempre — mas se o dispositivo nunca conectar sem proteções, ele não vai re-registrar.
@@ -206,8 +206,8 @@ O serial fica no ABM para sempre — mas se o dispositivo nunca conectar sem pro
**Solução:**
1. Certifique-se de ter `gpg` instalado
2. Importe a chave de assinatura: `gpg --keyserver keys.openpgp.org --recv-key <KEY_ID>`
3. Tente `sudo ./unleash update` novamente
4. Ou baixe manualmente de [GitHub Releases](https://github.com/mateussiqueira/unleash/releases)
3. Tente `sudo ./runaway update` novamente
4. Ou baixe manualmente de [GitHub Releases](https://github.com/mateussiqueira/runaway/releases)
---
@@ -219,9 +219,9 @@ Error: ... homebrew-core ...
**Solução:** Certifique-se de que o tap está atualizado:
```bash
brew untap mateussiqueira/unleash
brew tap mateussiqueira/unleash
brew install unleash
brew untap mateussiqueira/runaway
brew tap mateussiqueira/runaway
brew install runaway
```
---
@@ -234,7 +234,7 @@ Todos os comandos produzem logs estruturados:
[INF] Data volume: /Volumes/Macintosh HD - Data
[ OK] Admin 'apple' created (UID 501)
[WRN] DEP activation record present
[ERR] Firewall needs sudo: sudo ./unleash firewall
[ERR] Firewall needs sudo: sudo ./runaway firewall
[STP] Locating Data volume by APFS role...
[DBG] Checking pfctl availability
```
@@ -252,7 +252,7 @@ Todos os comandos produzem logs estruturados:
Use `--verbose` para mensagens de debug e `--log-file <caminho>` para salvar em um arquivo:
```bash
sudo ./unleash heal --verbose --log-file /tmp/unleash.log
sudo ./runaway heal --verbose --log-file /tmp/runaway.log
```
---
@@ -263,22 +263,22 @@ Execute estes para coletar informações antes de buscar ajuda:
```bash
# Verificação rápida de saúde
sudo ./unleash doctor
sudo ./runaway doctor
# Auditoria completa do sistema
sudo ./unleash audit
sudo ./runaway audit
# Gerar relatório
sudo ./unleash report
sudo ./runaway report
# Simular um bypass
sudo ./unleash demo
sudo ./runaway demo
```
---
## Obtendo Ajuda
- [GitHub Issues](https://github.com/mateussiqueira/unleash/issues)
- [Discussões](https://github.com/mateussiqueira/unleash/discussions)
- [Política de Segurança](https://github.com/mateussiqueira/unleash/blob/main/SECURITY.md)
- [GitHub Issues](https://github.com/mateussiqueira/runaway/issues)
- [Discussões](https://github.com/mateussiqueira/runaway/discussions)
- [Política de Segurança](https://github.com/mateussiqueira/runaway/blob/main/SECURITY.md)