Files
runaway/docs/pt/troubleshooting.md
T
ruihan 75f4ec53ab
CI / Bash Syntax Check (push) Successful in 8s
CI / Markdown Lint (push) Failing after 8s
CI / ShellCheck (push) Failing after 1m26s
chore: migrate all URLs to git.jskdjs.cn, drop GitHub-specific distribution
2026-11-09 10:31:11 +08:00

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:

  1. Execute diskutil list para encontrar seu volume de Dados
  2. Monte: diskutil mount /dev/diskXsY
  3. 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:

  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 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:

  1. Já está rodando? sudo ./runaway monitor-status
  2. Permissões: precisa de root
  3. 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:

  1. Use um pendrive USB com o runaway 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 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:

  1. Após restaurar, não conecte ao Wi-Fi
  2. Inicialize no Recovery
  3. Execute runaway bypass antes do dispositivo contatar a Apple
  4. Execute runaway persist e runaway 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 ./runaway update novamente
  4. Ou baixe manualmente de GitHub 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

Obtendo Ajuda