docs: add search, sidebar nav, dedicated pages, PT translations
This commit is contained in:
@@ -0,0 +1,364 @@
|
||||
---
|
||||
layout: default
|
||||
title: Referência de Comandos — unleash
|
||||
---
|
||||
|
||||
# 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.**
|
||||
```bash
|
||||
./unleash 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
|
||||
```
|
||||
|
||||
### `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
|
||||
```
|
||||
|
||||
### `persist`
|
||||
Instala um LaunchDaemon que executa `heal` automaticamente em cada inicialização.
|
||||
Sobrevive a atualizações do macOS.
|
||||
```bash
|
||||
sudo ./unleash persist
|
||||
```
|
||||
|
||||
### `unpersist`
|
||||
Remove o LaunchDaemon de persistência.
|
||||
```bash
|
||||
sudo ./unleash 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 ./unleash firewall
|
||||
```
|
||||
|
||||
### `firewall-off`
|
||||
Remove as regras pf adicionadas por `firewall`.
|
||||
```bash
|
||||
sudo ./unleash 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
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 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 ./unleash 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 ./unleash 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 ./unleash 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 ./unleash monitor
|
||||
sudo ./unleash 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
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 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 Unleash.
|
||||
```bash
|
||||
sudo ./unleash backup
|
||||
```
|
||||
|
||||
### `restore`
|
||||
Reverte o sistema para um estado salvo anteriormente.
|
||||
```bash
|
||||
sudo ./unleash restore
|
||||
```
|
||||
|
||||
### `dualboot`
|
||||
Cria uma conta admin e aplica supressão em um volume externo/bootcamp.
|
||||
```bash
|
||||
sudo ./unleash 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 ./unleash init
|
||||
```
|
||||
|
||||
### `suggest`
|
||||
Analisa seu sistema e fornece recomendações baseadas em risco.
|
||||
```bash
|
||||
sudo ./unleash 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
|
||||
```
|
||||
|
||||
### `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
|
||||
```
|
||||
|
||||
### `telemetry`
|
||||
Gerencia estatísticas anônimas de uso (opt-in, DESLIGADO por padrão).
|
||||
```bash
|
||||
./unleash telemetry on
|
||||
./unleash telemetry off
|
||||
./unleash 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 ./unleash vpn-kill
|
||||
sudo ./unleash vpn-kill-status
|
||||
sudo ./unleash 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.
|
||||
```bash
|
||||
sudo ./unleash update
|
||||
```
|
||||
|
||||
### `uninstall`
|
||||
Remove todos os vestígios do Unleash. Pede confirmação.
|
||||
```bash
|
||||
sudo ./unleash uninstall
|
||||
```
|
||||
|
||||
### `reinstall`
|
||||
Desinstala e então reaplica persist + whitelist + monitor.
|
||||
```bash
|
||||
sudo ./unleash reinstall
|
||||
```
|
||||
|
||||
### `config`
|
||||
Ver ou editar configurações persistentes em `~/.unleash.conf`.
|
||||
```bash
|
||||
./unleash config
|
||||
./unleash config show
|
||||
./unleash 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
|
||||
```
|
||||
|
||||
### `demo`
|
||||
Executa um fluxo de bypass simulado. Nenhuma alteração real é feita.
|
||||
```bash
|
||||
./unleash 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 ./unleash discord-bot <token> <userId>
|
||||
sudo ./unleash discord-bot-status
|
||||
sudo ./unleash 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
|
||||
./unleash 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
|
||||
```
|
||||
|
||||
### `test`
|
||||
Modo dry-run. Simula um comando sem fazer alterações reais.
|
||||
```bash
|
||||
./unleash test bypass
|
||||
./unleash 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) |
|
||||
+7
-1
@@ -1,9 +1,15 @@
|
||||
---
|
||||
layout: default
|
||||
title: unleash
|
||||
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">
|
||||
<br>
|
||||
<strong>unleash</strong>
|
||||
<br>
|
||||
<em>Script único de bypass MDM para macOS</em>
|
||||
<em>unleash</em>
|
||||
</p>
|
||||
|
||||
<p align="center">
|
||||
|
||||
@@ -0,0 +1,58 @@
|
||||
---
|
||||
layout: default
|
||||
title: Instalação — unleash
|
||||
---
|
||||
|
||||
# Instalação
|
||||
|
||||
## Homebrew (mais fácil)
|
||||
|
||||
```bash
|
||||
brew tap mateussiqueira/unleash
|
||||
brew install unleash
|
||||
```
|
||||
|
||||
Ou em um passo:
|
||||
```bash
|
||||
brew install mateussiqueira/unleash/unleash
|
||||
```
|
||||
|
||||
## Download direto
|
||||
|
||||
```bash
|
||||
curl -L https://raw.githubusercontent.com/mateussiqueira/unleash/main/unleash-standalone.sh -o unleash
|
||||
chmod +x unleash
|
||||
sudo ./unleash 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`
|
||||
|
||||
## 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
|
||||
```
|
||||
|
||||
## Compilando a partir do código-fonte
|
||||
|
||||
```bash
|
||||
git clone https://github.com/mateussiqueira/unleash.git
|
||||
cd unleash
|
||||
bash examples/build-standalone.sh
|
||||
# Saída: unleash-standalone.sh (~3200 linhas)
|
||||
```
|
||||
|
||||
## Verificando a instalação
|
||||
|
||||
```bash
|
||||
./unleash version
|
||||
# → unleash v2.0.0
|
||||
|
||||
./unleash doctor
|
||||
# Executa diagnósticos pré-voo
|
||||
```
|
||||
@@ -0,0 +1,134 @@
|
||||
---
|
||||
layout: default
|
||||
title: Cenários — unleash
|
||||
---
|
||||
|
||||
# Cenários
|
||||
|
||||
## Antes de comprar um Mac usado
|
||||
|
||||
Verifique o número serial antes de comprar:
|
||||
|
||||
```bash
|
||||
./unleash predict ABC12345678 # verifica serial contra prefixos conhecidos
|
||||
./unleash check # este Mac é seguro para limpar?
|
||||
```
|
||||
|
||||
`predict` consulta o serial contra prefixos conhecidos de organizações MDM.
|
||||
Se corresponder a JAMF, Mosyle ou outra organização, você sabe o que esperar antes de comprar.
|
||||
|
||||
---
|
||||
|
||||
## Recuperação após Migration Assistant
|
||||
|
||||
1. Instale o macOS em um Mac novo
|
||||
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:
|
||||
```bash
|
||||
./unleash 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.*
|
||||
|
||||
---
|
||||
|
||||
## 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:**
|
||||
```bash
|
||||
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.
|
||||
|
||||
---
|
||||
|
||||
## Comprou um Mac de escritório
|
||||
|
||||
1. O serial pode ainda estar no ABM da empresa
|
||||
2. Mesmo após limpeza total, conectar ao Wi-Fi no Assistente de Configuração aciona o registro
|
||||
|
||||
**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
|
||||
4. Só então conecte-se à internet
|
||||
|
||||
O serial fica no ABM para sempre — mas enquanto o dispositivo nunca conectar
|
||||
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
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Configurando um Mac novo antes do primeiro boot
|
||||
|
||||
1. Inicialize no Recovery sem Wi-Fi
|
||||
2. Execute `unleash init` — assistente interativo
|
||||
3. Ele irá: suprimir MDM, instalar persist, instalar whitelist, executar audit
|
||||
4. Reinicie, configure normalmente, o MDM nunca incomoda
|
||||
|
||||
---
|
||||
|
||||
## Mac fornecido pela organização (deve registrar apenas na VPN)
|
||||
|
||||
Algumas organizações exigem que o Mac registre, mas somente quando conectado à VPN corporativa.
|
||||
|
||||
```bash
|
||||
sudo ./unleash vpn-kill
|
||||
```
|
||||
|
||||
Isso instala um pf kill-switch que bloqueia tráfego MDM quando o dispositivo
|
||||
NÃO está conectado ao túnel VPN. O MDM só pode se comunicar através
|
||||
da conexão VPN criptografada.
|
||||
|
||||
---
|
||||
|
||||
## Após uma restauração completa DFU/IPSW
|
||||
|
||||
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`
|
||||
6. Reinicie e conecte-se à internet com segurança
|
||||
|
||||
---
|
||||
|
||||
## Implantação automatizada (admins de TI)
|
||||
|
||||
Para implantar em múltiplas máquinas:
|
||||
|
||||
```bash
|
||||
# Bypass via script
|
||||
./unleash suppress --log-file /var/log/unleash-deploy.log
|
||||
|
||||
# Com persist + monitor
|
||||
sudo ./unleash persist
|
||||
sudo ./unleash monitor
|
||||
|
||||
# Relatório de auditoria em JSON
|
||||
sudo ./unleash report --json
|
||||
|
||||
# Alertas no Discord
|
||||
sudo ./unleash discord-bot <token> <userId>
|
||||
```
|
||||
@@ -0,0 +1,61 @@
|
||||
---
|
||||
layout: default
|
||||
title: Segurança — unleash
|
||||
---
|
||||
|
||||
# Segurança & Proteção
|
||||
|
||||
## Princípios de Design
|
||||
|
||||
### Sem persistência root
|
||||
O Unleash 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.
|
||||
|
||||
### Releases assinados com GPG
|
||||
Todo release é assinado com uma chave GPG. O comando `update` verifica
|
||||
a assinatura antes de aplicar atualizações. Se a verificação falhar, a
|
||||
atualização é **rejeitada**.
|
||||
|
||||
### Telemetria opt-in
|
||||
A telemetria está **DESLIGADA por padrão**. Se ativada, envia apenas
|
||||
contagens anônimas:
|
||||
- Nome do comando executado
|
||||
- Versão do macOS
|
||||
- Status de sucesso/falha
|
||||
|
||||
Sem números de série, IPs ou informações pessoalmente identificáveis.
|
||||
|
||||
### Sem dependência de internet
|
||||
Comandos principais (`bypass`, `suppress`, `heal`) funcionam completamente
|
||||
offline. Apenas `update`, `firewall` (resolução DNS) e `discord-bot`
|
||||
precisam de acesso à rede.
|
||||
|
||||
---
|
||||
|
||||
## Garantias de Segurança
|
||||
|
||||
- **Sem escritas no SSV** — todas as alterações miram o volume de Dados
|
||||
- **Reversível** — `backup` salva o estado, `restore` reverte
|
||||
- **Sem apagar dados** — nunca executa `profiles renew` ou comandos de apagar
|
||||
- **Idempotente** — executar múltiplas vezes é inofensivo
|
||||
- **Pede confirmação** antes de ações destrutivas
|
||||
|
||||
---
|
||||
|
||||
## Níveis de Risco
|
||||
|
||||
| Nível | Descrição | Comandos |
|
||||
|-------|-----------|----------|
|
||||
| Seguro | Somente leitura, sem alterações | `status`, `check`, `doctor`, `audit`, `predict`, `report` |
|
||||
| Baixo | Escreve apenas no arquivo hosts | `suppress`, `heal` |
|
||||
| Médio | Cria/modifica arquivos do sistema | `bypass`, `dualboot`, `persist`, `whitelist` |
|
||||
| Alto | Firewall a nível de kernel | `firewall`, `vpn-kill` |
|
||||
| Destrutivo | Remoção completa | `uninstall`, `reinstall` |
|
||||
|
||||
---
|
||||
|
||||
## 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).
|
||||
@@ -0,0 +1,284 @@
|
||||
---
|
||||
layout: default
|
||||
title: Solução de Problemas — unleash
|
||||
---
|
||||
|
||||
# Solução de Problemas
|
||||
|
||||
## Erros Comuns
|
||||
|
||||
### "Not a known DirStatus"
|
||||
A detecção automática de volume falhou.
|
||||
```
|
||||
[ERR] Not a known DirStatus
|
||||
```
|
||||
|
||||
**Solução:**
|
||||
1. Execute `diskutil list` para encontrar seu volume de Dados
|
||||
2. Monte: `diskutil mount /dev/diskXsY`
|
||||
3. Execute o unleash novamente
|
||||
|
||||
---
|
||||
|
||||
### "Full bypass must run from Recovery mode"
|
||||
```
|
||||
[ERR] Full bypass must run from Recovery mode.
|
||||
```
|
||||
|
||||
**Causa:** `bypass` cria usuários admin via dscl, que só funciona no Recovery.
|
||||
**Solução:** Inicialize no Recovery e tente novamente. Ou use `suppress` de um sistema já iniciado.
|
||||
|
||||
---
|
||||
|
||||
### Erros "Needs sudo"
|
||||
|
||||
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
|
||||
```
|
||||
|
||||
**Solução:** Anteceda `sudo` ao comando.
|
||||
|
||||
---
|
||||
|
||||
### MDM volta após reiniciar
|
||||
|
||||
A causa mais comum são **artefatos de nível de usuário** trazidos pelo Migration Assistant.
|
||||
|
||||
**Solução do Recovery:**
|
||||
```bash
|
||||
sudo ./unleash suppress
|
||||
```
|
||||
|
||||
**Solução do sistema já iniciado:**
|
||||
```bash
|
||||
sudo ./unleash harden
|
||||
```
|
||||
|
||||
Se continuar voltando:
|
||||
```bash
|
||||
sudo ./unleash persist # auto-recuperação em cada inicialização
|
||||
sudo ./unleash monitor # vigia re-registro
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### Atualização do macOS reativou o MDM
|
||||
|
||||
Atualizações do sistema restauram os daemons de registro automaticamente.
|
||||
|
||||
**Solução:**
|
||||
```bash
|
||||
sudo ./unleash heal
|
||||
```
|
||||
|
||||
Se você executou `persist` antes da atualização, isso acontece automaticamente na próxima inicialização.
|
||||
|
||||
---
|
||||
|
||||
### "Profiles status" ainda mostra registro
|
||||
|
||||
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`.
|
||||
|
||||
---
|
||||
|
||||
### FileVault está ativado
|
||||
|
||||
O Unleash 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
|
||||
|
||||
---
|
||||
|
||||
### iCloud para de funcionar após o bypass
|
||||
|
||||
O bloqueio básico de `/etc/hosts` inclui `albert.apple.com` (ativação do iCloud) e `gdmf.apple.com`.
|
||||
|
||||
**Solução:** Use `whitelist` em vez do bloqueio básico:
|
||||
```bash
|
||||
sudo ./unleash whitelist
|
||||
```
|
||||
|
||||
Ou remova manualmente estas duas linhas de `/etc/hosts`:
|
||||
```
|
||||
0.0.0.0 albert.apple.com
|
||||
0.0.0.0 gdmf.apple.com
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### "Not a macOS Data volume"
|
||||
|
||||
```
|
||||
[ERR] Not a macOS Data volume
|
||||
```
|
||||
|
||||
**Causa:** O volume montado não tem a estrutura esperada.
|
||||
|
||||
**Solução:** Execute `diskutil list` para encontrar o volume de Dados correto (procure por "Data" no nome ou pelo código `69414d41-...`). Monte o correto e tente novamente.
|
||||
|
||||
---
|
||||
|
||||
### Monitor não inicia
|
||||
|
||||
**Verifique:**
|
||||
1. Já está rodando? `sudo ./unleash monitor-status`
|
||||
2. Permissões: precisa de root
|
||||
3. Logs: `/var/log/unleash-monitor.log`
|
||||
|
||||
**Solução:**
|
||||
```bash
|
||||
sudo ./unleash monitor-stop
|
||||
sudo ./unleash monitor
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### Não consigo baixar arquivos no Recovery
|
||||
|
||||
O modo Recovery não tem internet por padrão.
|
||||
|
||||
**Solução:**
|
||||
1. Use um pendrive USB com o unleash copiado
|
||||
2. Ou conecte-se ao Wi-Fi no Recovery (menu superior direito → ícone Wi-Fi)
|
||||
|
||||
---
|
||||
|
||||
### Erro "Library not found" na inicialização
|
||||
|
||||
```
|
||||
ERROR: Library not found: /path/to/lib/colors.sh
|
||||
```
|
||||
|
||||
**Causa:** Executando o script `unleash` fonte de fora do diretório do repositório.
|
||||
|
||||
**Solução:**
|
||||
- Use a versão standalone (`unleash-standalone.sh`)
|
||||
- Ou execute da raiz do repositório onde o diretório `lib/` existe
|
||||
- Ou instale via Homebrew
|
||||
|
||||
---
|
||||
|
||||
### Regras do firewall não estão sendo aplicadas
|
||||
|
||||
pf pode ter regras existentes que conflitam.
|
||||
|
||||
**Solução:**
|
||||
```bash
|
||||
sudo ./unleash firewall-off # limpa regras existentes
|
||||
sudo ./unleash firewall # reaplica
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### "Dispositivo ainda trava após restauração DFU"
|
||||
|
||||
Uma restauração DFU/IPSW completa não remove a atribuição ABM — o serial permanece no Apple Business Manager.
|
||||
|
||||
**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`
|
||||
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.
|
||||
|
||||
---
|
||||
|
||||
### Verificação de assinatura GPG falha na atualização
|
||||
|
||||
```
|
||||
[ERR] GPG signature verification failed
|
||||
```
|
||||
|
||||
**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)
|
||||
|
||||
---
|
||||
|
||||
### Instalação via Homebrew falha
|
||||
|
||||
```
|
||||
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
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Logging
|
||||
|
||||
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
|
||||
[STP] Locating Data volume by APFS role...
|
||||
[DBG] Checking pfctl availability
|
||||
```
|
||||
|
||||
**Formato do log:**
|
||||
|
||||
| Prefixo | Nível |
|
||||
|---------|-------|
|
||||
| `[INF]` | Info — operação normal |
|
||||
| `[ OK]` | Sucesso — operação concluída |
|
||||
| `[WRN]` | Aviso — problema não crítico |
|
||||
| `[ERR]` | Erro — operação falhou |
|
||||
| `[STP]` | Passo — ação atual |
|
||||
| `[DBG]` | Debug — verbose apenas |
|
||||
|
||||
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
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Comandos de Diagnóstico
|
||||
|
||||
Execute estes para coletar informações antes de buscar ajuda:
|
||||
|
||||
```bash
|
||||
# Verificação rápida de saúde
|
||||
sudo ./unleash doctor
|
||||
|
||||
# Auditoria completa do sistema
|
||||
sudo ./unleash audit
|
||||
|
||||
# Gerar relatório
|
||||
sudo ./unleash report
|
||||
|
||||
# Simular um bypass
|
||||
sudo ./unleash 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)
|
||||
Reference in New Issue
Block a user