6.2 KiB
layout, title
| layout | title |
|---|---|
| default | Solução de Problemas — runaway |
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 runaway 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 ./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.
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 ./runaway suppress
Solução do sistema já iniciado:
sudo ./runaway harden
Se continuar voltando:
sudo ./runaway persist # auto-recuperação em cada inicialização
sudo ./runaway monitor # vigia re-registro
Atualização do macOS reativou o MDM
Atualizações do sistema restauram os daemons de registro automaticamente.
Solução:
sudo ./runaway 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 runaway status -d.
FileVault está ativado
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:
- Vá para o Utilitário de Disco no Recovery
- Selecione o volume de Dados
- Arquivo → Desbloquear → Digite a senha
- Execute o runaway 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 ./runaway 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 ./runaway monitor-status - Permissões: precisa de root
- Logs:
/var/log/runaway-monitor.log
Solução:
sudo ./runaway monitor-stop
sudo ./runaway 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 runaway 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 runaway fonte de fora do diretório do repositório.
Solução:
- Use a versão standalone (
runaway-standalone.sh) - Ou execute da raiz do repositório onde o diretório
lib/existe
Regras do firewall não estão sendo aplicadas
pf pode ter regras existentes que conflitam.
Solução:
sudo ./runaway firewall-off # limpa regras existentes
sudo ./runaway 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
runaway bypassantes do dispositivo contatar a Apple - Execute
runaway persisterunaway 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 ./runaway updatenovamente - Ou baixe manualmente de Releases
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 ./runaway 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 ./runaway heal --verbose --log-file /tmp/runaway.log
Comandos de Diagnóstico
Execute estes para coletar informações antes de buscar ajuda:
# Verificação rápida de saúde
sudo ./runaway doctor
# Auditoria completa do sistema
sudo ./runaway audit
# Gerar relatório
sudo ./runaway report
# Simular um bypass
sudo ./runaway demo