rename project to runaway

This commit is contained in:
2026-11-09 10:13:51 +08:00
parent 20946dd445
commit 205f2faf02
95 changed files with 1034 additions and 1034 deletions
+41 -41
View File
@@ -1,6 +1,6 @@
---
layout: default
title: Solução de Problemas — unleash
title: Solução de Problemas — runaway
---
# Solução de Problemas
@@ -16,7 +16,7 @@ A detecção automática de volume falhou.
**Solução:**
1. Execute `diskutil list` para encontrar seu volume de Dados
2. Monte: `diskutil mount /dev/diskXsY`
3. Execute o unleash novamente
3. Execute o runaway novamente
---
@@ -34,11 +34,11 @@ A detecção automática de volume falhou.
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
[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.
@@ -51,18 +51,18 @@ A causa mais comum são **artefatos de nível de usuário** trazidos pelo Migrat
**Solução do Recovery:**
```bash
sudo ./unleash suppress
sudo ./runaway suppress
```
**Solução do sistema já iniciado:**
```bash
sudo ./unleash harden
sudo ./runaway harden
```
Se continuar voltando:
```bash
sudo ./unleash persist # auto-recuperação em cada inicialização
sudo ./unleash monitor # vigia re-registro
sudo ./runaway persist # auto-recuperação em cada inicialização
sudo ./runaway monitor # vigia re-registro
```
---
@@ -73,7 +73,7 @@ Atualizações do sistema restauram os daemons de registro automaticamente.
**Solução:**
```bash
sudo ./unleash heal
sudo ./runaway heal
```
Se você executou `persist` antes da atualização, isso acontece automaticamente na próxima inicialização.
@@ -85,19 +85,19 @@ Se você executou `persist` antes da atualização, isso acontece automaticament
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`.
**Confie** em `runaway status -d`.
---
### FileVault está ativado
O Unleash detecta FileVault e pede a chave de recuperação ou senha do volume.
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 unleash novamente
4. Execute o runaway novamente
---
@@ -107,7 +107,7 @@ O bloqueio básico de `/etc/hosts` inclui `albert.apple.com` (ativação do iClo
**Solução:** Use `whitelist` em vez do bloqueio básico:
```bash
sudo ./unleash whitelist
sudo ./runaway whitelist
```
Ou remova manualmente estas duas linhas de `/etc/hosts`:
@@ -133,14 +133,14 @@ Ou remova manualmente estas duas linhas de `/etc/hosts`:
### Monitor não inicia
**Verifique:**
1. Já está rodando? `sudo ./unleash monitor-status`
1. Já está rodando? `sudo ./runaway monitor-status`
2. Permissões: precisa de root
3. Logs: `/var/log/unleash-monitor.log`
3. Logs: `/var/log/runaway-monitor.log`
**Solução:**
```bash
sudo ./unleash monitor-stop
sudo ./unleash monitor
sudo ./runaway monitor-stop
sudo ./runaway monitor
```
---
@@ -150,7 +150,7 @@ sudo ./unleash monitor
O modo Recovery não tem internet por padrão.
**Solução:**
1. Use um pendrive USB com o unleash copiado
1. Use um pendrive USB com o runaway copiado
2. Ou conecte-se ao Wi-Fi no Recovery (menu superior direito → ícone Wi-Fi)
---
@@ -161,10 +161,10 @@ O modo Recovery não tem internet por padrão.
ERROR: Library not found: /path/to/lib/colors.sh
```
**Causa:** Executando o script `unleash` fonte de fora do diretório do repositório.
**Causa:** Executando o script `runaway` fonte de fora do diretório do repositório.
**Solução:**
- Use a versão standalone (`unleash-standalone.sh`)
- Use a versão standalone (`runaway-standalone.sh`)
- Ou execute da raiz do repositório onde o diretório `lib/` existe
- Ou instale via Homebrew
@@ -176,8 +176,8 @@ pf pode ter regras existentes que conflitam.
**Solução:**
```bash
sudo ./unleash firewall-off # limpa regras existentes
sudo ./unleash firewall # reaplica
sudo ./runaway firewall-off # limpa regras existentes
sudo ./runaway firewall # reaplica
```
---
@@ -189,8 +189,8 @@ Uma restauração DFU/IPSW completa não remove a atribuição ABM — o serial
**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`
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.
@@ -206,8 +206,8 @@ O serial fica no ABM para sempre — mas se o dispositivo nunca conectar sem pro
**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)
3. Tente `sudo ./runaway update` novamente
4. Ou baixe manualmente de [GitHub Releases](https://github.com/mateussiqueira/runaway/releases)
---
@@ -219,9 +219,9 @@ 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
brew untap mateussiqueira/runaway
brew tap mateussiqueira/runaway
brew install runaway
```
---
@@ -234,7 +234,7 @@ 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
[ERR] Firewall needs sudo: sudo ./runaway firewall
[STP] Locating Data volume by APFS role...
[DBG] Checking pfctl availability
```
@@ -252,7 +252,7 @@ Todos os comandos produzem logs estruturados:
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
sudo ./runaway heal --verbose --log-file /tmp/runaway.log
```
---
@@ -263,22 +263,22 @@ Execute estes para coletar informações antes de buscar ajuda:
```bash
# Verificação rápida de saúde
sudo ./unleash doctor
sudo ./runaway doctor
# Auditoria completa do sistema
sudo ./unleash audit
sudo ./runaway audit
# Gerar relatório
sudo ./unleash report
sudo ./runaway report
# Simular um bypass
sudo ./unleash demo
sudo ./runaway 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)
- [GitHub Issues](https://github.com/mateussiqueira/runaway/issues)
- [Discussões](https://github.com/mateussiqueira/runaway/discussions)
- [Política de Segurança](https://github.com/mateussiqueira/runaway/blob/main/SECURITY.md)