docs: add EN/PT language toggle and Portuguese pages (index, guide, faq)

This commit is contained in:
2026-06-20 18:21:16 -03:00
parent b675a7cdf5
commit d10598446e
7 changed files with 836 additions and 0 deletions
+142
View File
@@ -0,0 +1,142 @@
---
layout: default
title: FAQ — unleash
---
# FAQ
## Geral
### Quais versões do macOS são suportadas?
12.x (Monterey) até 15.x (Sequoia), 26.x (Tahoe) e 27.x. Testado em Intel T2, M1, M2, M3, M4, M5.
### É 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:
- Marcadores DEP (igual ao original)
- Bloqueio de rede via `/etc/hosts` (igual)
- Override de daemons (original tem uma versão básica)
- **Limpeza de artefatos de usuário** (original não faz isso)
- **Firewall pf a nível de kernel** (original não faz isso)
- **Daemon de auto-recuperação**, **monitor em segundo plano**, **auditoria**, **predict**, **remediate** e 30+ comandos
Além de distribuição em arquivo único, Homebrew tap e releases assinados com GPG.
### Preciso desabilitar o SIP?
Não. Todas as escritas miram o volume de Dados. O volume do sistema nunca é modificado.
### Preciso de internet?
`bypass` e `suppress` não precisam de internet. `persist`, `firewall` e `update` precisam (baixam recursos ou contatam o GitHub).
### Sobrevive a uma reinstalação do sistema?
Não. A instalação limpa apaga o volume de Dados. Execute `bypass` do Recovery novamente após reinstalar.
### 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.
### A organização pode rastrear isso?
O serial do dispositivo permanece no Apple Business Manager para sempre. Só a organização pode removê-lo. Se o dispositivo se conectar à internet com todas as proteções removidas, ele será registrado novamente.
### Posso usar iCloud após o bypass?
Sim. Use `whitelist` em vez de `firewall` ou `suppress` básico. Ele resolve apenas os domínios MDM essenciais para IPs e bloqueia aqueles, deixando iCloud, App Store e atualizações intocados.
### 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.
### 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).
### Qual é a licença?
MIT. Gratuito para usar, modificar e distribuir.
## Técnico
### Como saber se meu Mac está registrado no MDM?
```bash
sudo ./unleash check
```
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
```
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`.
### Qual a diferença entre `monitor` e `persist`?
`monitor` é um daemon que verifica a cada 5 minutos e envia uma notificação do macOS se o MDM tentar re-registrar. `persist` é um LaunchDaemon que executa `heal` em cada inicialização. Use ambos para proteção completa.
### Qual a diferença entre `firewall` e `whitelist`?
`firewall` bloqueia toda a faixa de IP da Apple (quebra iCloud/App Store). `whitelist` resolve apenas domínios MDM para IPs e bloqueia aqueles (mantém iCloud/App Store funcionando).
### Quais organizações o `remediate` suporta?
JAMF, Mosyle, Addigy, Kandji, VMware Workspace ONE. Ele detecta automaticamente a organização a partir do registro DEP e aplica limpeza direcionada.
### Como o `predict` funciona?
Ele lê o prefixo do número serial e verifica contra prefixos conhecidos de organizações MDM (de pesquisa comunitária). Se encontrar correspondência, prevê qual organização registrou o dispositivo.
## Solução de Problemas
### MDM volta após reiniciar
Execute do Recovery:
```bash
sudo ./unleash suppress
```
Ou de um sistema já iniciado:
```bash
sudo ./unleash harden
```
### Erro "Not a known DirStatus"
A detecção automática de volume falhou. Encontre seu volume de Dados:
```bash
diskutil list
diskutil mount /dev/diskXsY
./unleash bypass
```
### Desbloqueio do FileVault falha no Recovery
Você precisa de uma senha de usuário ou da chave de recuperação do FileVault. Se nenhum estiver disponível, o volume de Dados não pode ser montado do Recovery. Desbloqueie manualmente no Utilitário de Disco primeiro.
### "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.
### Monitor não inicia
1. Verifique se já está rodando: `sudo ./unleash monitor-status`
2. Verifique permissões: precisa de root
3. Verifique logs: `/var/log/unleash-monitor.log`
---
[Voltar ao início](/) · [Guia de Arquitetura](guide)
{% include lang-toggle.html %}