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