6.5 KiB
layout, title
| layout | title |
|---|---|
| default | 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:
- Execute
diskutil listpara encontrar seu volume de Dados - Monte:
diskutil mount /dev/diskXsY - 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:
sudo ./unleash suppress
Solução do sistema já iniciado:
sudo ./unleash harden
Se continuar voltando:
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:
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:
- Vá para o Utilitário de Disco no Recovery
- Selecione o volume de Dados
- Arquivo → Desbloquear → Digite a senha
- 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:
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:
- Já está rodando?
sudo ./unleash monitor-status - Permissões: precisa de root
- Logs:
/var/log/unleash-monitor.log
Solução:
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:
- Use um pendrive USB com o unleash copiado
- 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:
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:
- Após restaurar, não conecte ao Wi-Fi
- Inicialize no Recovery
- Execute
unleash bypassantes do dispositivo contatar a Apple - Execute
unleash persisteunleash whitelist - 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:
- Certifique-se de ter
gpginstalado - Importe a chave de assinatura:
gpg --keyserver keys.openpgp.org --recv-key <KEY_ID> - Tente
sudo ./unleash updatenovamente - Ou baixe manualmente de GitHub Releases
Instalação via Homebrew falha
Error: ... homebrew-core ...
Solução: Certifique-se de que o tap está atualizado:
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:
sudo ./unleash heal --verbose --log-file /tmp/unleash.log
Comandos de Diagnóstico
Execute estes para coletar informações antes de buscar ajuda:
# 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