Run a virtual iPhone on an Apple Silicon Mac.
Swift
docs(i18n): carry the AMFI section rewrite into the five translations
Lakr550d6483fe4f
diff --git a/docs/README_ja.md b/docs/README_ja.mdindex c5cf6fd8..ca77505d 100644--- a/docs/README_ja.md+++ b/docs/README_ja.md@@ -137,7 +137,7 @@ csrutil allow-research-guests enablesudo nvram boot-args="amfi_get_out_of_my_way=1 -v" # 後で再起動```-**オプション B — SIP を有効なまま(デバッグのみ緩和)にし、amfidont でバイナリを許可リストに追加する**(AMFI はシステム全体で有効なまま)。+**オプション B — SIP を有効なまま(デバッグのみ緩和)にし、起動ごとに `vphone-cli` にウィンドウを開かせる**(それ以外の時間は AMFI が有効なまま)。リカバリーモードで:@@ -146,12 +146,20 @@ csrutil enable --without debugcsrutil allow-research-guests enable```-その後 macOS で再起動し:+その後 macOS で再起動します。ほかに設定するものはありません: `vphone-cli` は entitlement を持たないため常に起動でき、ゲストを起動する際に amfid が `vphone-vm` を受け付けないことを検知すると、`vphone-letmein` でウィンドウを開き(sudo の入力が 1 回)、ゲストが動き出したら閉じます。++手動で行う場合 — `vphone-vm` の作業中は、実行のたびに入力するより sudo 1 回で済むぶん有用です:```bash-vphone-amfidont # ローカルビルドの場合は .build/vphone-cli.app/Contents/Resources/vphone-amfidont+make letmein # 開く (sudo)+make letmein_status # 確認+make letmein_off # 閉じる```+> **これが何をするのかを正しく理解してください。** これは許可リストではなくグローバルなスイッチです: ウィンドウが開いている間、amfid は検査した*すべて*の署名を有効かつ Apple 署名済みとして報告します。これを 1 つのパスや 1 つのバイナリに絞ることはできません — 検証ごとの判断には Apple 非公開のデバッガ entitlement が必要です。絞れるのは時間であり、そのため自動の経路では 1 回の起動のあいだだけウィンドウを開いたままにします。またメモリ上にしか存在せず、再起動すれば解除されます。+>+> `vphone-letmein` は、pip パッケージだった旧来の `amfidont` ヘルパーを置き換えるもので、`amfidont` はもう使用しません。+## 動作確認済み環境| ホスト | iPhone | CloudOS |@@ -179,7 +187,7 @@ vphone-amfidont # ローカルビルドの場合は .build/vphone-cli.ap## FAQ-**`zsh: killed ./vphone-cli`** — AMFI/デバッグ制限がバイパスされていません。[前提条件](#前提条件) を参照してください(`amfi_get_out_of_my_way=1` または `amfidont`)。+**`zsh: killed ./vphone-vm`** — AMFI/デバッグ制限がバイパスされていません。[前提条件](#前提条件) を参照してください(`amfi_get_out_of_my_way=1`、または `vphone-cli` にウィンドウを開かせる)。なお `vphone-cli` 自体にこれは起こりません: entitlement を持たないため、*それ* が kill されている場合は別の原因があります。**`Virtualization is not available on this hardware`** — お使いの Mac 自体が VM です。PV=3 ゲスト起動はネストできません。ネストされていない macOS 15+ ホストを使用してください。diff --git a/docs/README_ko.md b/docs/README_ko.mdindex a542484c..b2dcef9f 100644--- a/docs/README_ko.md+++ b/docs/README_ko.md@@ -137,7 +137,7 @@ csrutil allow-research-guests enablesudo nvram boot-args="amfi_get_out_of_my_way=1 -v" # 이후 재부팅```-**방법 B — SIP 유지 (디버그만 완화), 그런 다음 amfidont로 바이너리를 허용 목록에 추가** (AMFI는 시스템 전체에서 활성 상태 유지).+**방법 B — SIP 유지 (디버그만 완화), 실행할 때마다 `vphone-cli`가 창을 열도록 하기** (그 외의 시간에는 AMFI가 활성 상태 유지).복구 모드에서:@@ -146,12 +146,20 @@ csrutil enable --without debugcsrutil allow-research-guests enable```-그런 다음 macOS로 재부팅하고:+그런 다음 macOS로 재부팅합니다. 그 외에 설정할 것은 없습니다: `vphone-cli`는 entitlement가 없어 항상 실행되며, 게스트를 시작할 때 amfid가 `vphone-vm`을 받아들이지 않는다는 것을 감지하면 `vphone-letmein`으로 창을 열고 (sudo 입력 1회), 게스트가 실행되면 창을 닫습니다.++직접 하려면 — `vphone-vm` 작업 중에는 실행할 때마다 입력하는 것보다 sudo 한 번이 나으므로 해 볼 만합니다:```bash-vphone-amfidont # 로컬 빌드의 경우 .build/vphone-cli.app/Contents/Resources/vphone-amfidont+make letmein # 열기 (sudo)+make letmein_status # 확인+make letmein_off # 닫기```+> **이것이 무엇을 하는지 솔직히 알아 두세요.** 이것은 허용 목록이 아니라 전역 스위치입니다: 창이 열려 있는 동안 amfid는 자신이 검사하는 *모든* 서명을 유효하며 Apple이 서명한 것으로 보고합니다. 이를 하나의 경로나 하나의 바이너리로 좁힐 수는 없습니다 — 검증 단위의 판단에는 Apple 비공개 디버거 entitlement가 필요합니다. 좁힐 수 있는 것은 시간이며, 그래서 자동 경로는 한 번의 실행 동안만 창을 열어 둡니다. 또한 메모리에만 존재하므로 재부팅하면 해제됩니다.+>+> `vphone-letmein`은 pip 패키지였던 기존 `amfidont` 헬퍼를 대체하며, `amfidont`는 더 이상 사용되지 않습니다.+## 테스트 환경| 호스트 | iPhone | CloudOS |@@ -179,7 +187,7 @@ vphone-amfidont # 로컬 빌드의 경우 .build/vphone-cli.app/Contents## FAQ-**`zsh: killed ./vphone-cli`** — AMFI/디버그 제한이 우회되지 않았습니다; [사전 요구 사항](#사전-요구-사항)을 참조하세요 (`amfi_get_out_of_my_way=1` 또는 `amfidont`).+**`zsh: killed ./vphone-vm`** — AMFI/디버그 제한이 우회되지 않았습니다; [사전 요구 사항](#사전-요구-사항)을 참조하세요 (`amfi_get_out_of_my_way=1`, 또는 `vphone-cli`가 대신 창을 열도록 하세요). 참고로 `vphone-cli` 자체에는 이런 일이 생길 수 없습니다: entitlement가 없으므로 *그것*이 종료되고 있다면 다른 문제가 있는 것입니다.**`Virtualization is not available on this hardware`** — Mac 자체가 VM입니다; PV=3 게스트 부팅은 중첩할 수 없습니다. 중첩되지 않은 macOS 15+ 호스트를 사용하세요.diff --git a/docs/README_pt.md b/docs/README_pt.mdindex 0fc6c174..6e58e1d8 100644--- a/docs/README_pt.md+++ b/docs/README_pt.md@@ -137,7 +137,7 @@ Depois reinicie no macOS e configure o boot-arg do AMFI (requer SIP completamentsudo nvram boot-args="amfi_get_out_of_my_way=1 -v" # reinicie após```-**Opção B — manter SIP ligado (relaxado apenas para debug), depois allowlist o binário com amfidont** (mantém AMFI habilitado em todo o sistema).+**Opção B — manter SIP ligado (relaxado apenas para debug) e deixar o `vphone-cli` abrir uma janela a cada execução** (mantém AMFI habilitado no resto do tempo).No Recovery:@@ -146,12 +146,20 @@ csrutil enable --without debugcsrutil allow-research-guests enable```-Depois reinicie no macOS e:+Depois reinicie no macOS. Não há mais nada para configurar: o `vphone-cli` não carrega entitlements e sempre inicia, então, ao iniciar um guest, ele percebe que o amfid não aceita o `vphone-vm`, abre uma janela com o `vphone-letmein` (um pedido de sudo) e a fecha assim que o guest estiver rodando.++Para fazer isso manualmente — vale a pena enquanto se trabalha no `vphone-vm`, onde um sudo é melhor que um pedido por execução:```bash-vphone-amfidont # .build/vphone-cli.app/Contents/Resources/vphone-amfidont para builds locais+make letmein # abrir (sudo)+make letmein_status # verificar+make letmein_off # fechar```+> **Seja honesto sobre o que isso faz.** É um interruptor global, não uma allowlist: enquanto a janela está aberta, o amfid reporta *toda* assinatura que verifica como válida e assinada pela Apple. Isso não pode ser restringido a um caminho ou a um binário — uma decisão por validação exigiria entitlements de depurador privados da Apple. O que pode ser restringido é o tempo, e por isso o caminho automático mantém a janela aberta apenas pela duração de uma execução. Também fica apenas em memória: reiniciar limpa tudo.+>+> O `vphone-letmein` substitui o antigo helper `amfidont`, que era um pacote pip e não é mais usado.+## Ambientes Testados| Host | iPhone | CloudOS |@@ -179,7 +187,7 @@ vphone-amfidont # .build/vphone-cli.app/Contents/Resources/vphone-amfido## FAQ-**`zsh: killed ./vphone-cli`** — Restrições de AMFI/debug não foram desativadas; veja [Pré-requisitos](#pré-requisitos) (`amfi_get_out_of_my_way=1` ou `amfidont`).+**`zsh: killed ./vphone-vm`** — Restrições de AMFI/debug não foram desativadas; veja [Pré-requisitos](#pré-requisitos) (`amfi_get_out_of_my_way=1`, ou deixe o `vphone-cli` abrir uma janela para você). Note que isso não pode acontecer com o próprio `vphone-cli`: ele não carrega entitlements, então se *ele* está sendo morto, algo mais está errado.**`Virtualization is not available on this hardware`** — Seu Mac é uma VM; boot de guest PV=3 não pode ser aninhado. Use um host macOS 15+ não-virtualizado.diff --git a/docs/README_ru.md b/docs/README_ru.mdindex f386894c..de0e65c6 100644--- a/docs/README_ru.md+++ b/docs/README_ru.md@@ -138,7 +138,7 @@ csrutil allow-research-guests enablesudo nvram boot-args="amfi_get_out_of_my_way=1 -v" # перезагрузка после```-**Вариант B — оставить SIP включённым (ослабленным только для отладки), затем добавить бинарник в allowlist через amfidont** (оставляет AMFI включённым на уровне системы).+**Вариант B — оставить SIP включённым (ослабленным только для отладки) и позволить `vphone-cli` открывать окно на каждый запуск** (в остальное время AMFI остаётся включённым).В Recovery:@@ -147,12 +147,20 @@ csrutil enable --without debugcsrutil allow-research-guests enable```-Затем перезагрузитесь в macOS и выполните:+Затем перезагрузитесь в macOS. Больше настраивать нечего: у `vphone-cli` нет entitlements, поэтому он запускается всегда, и при старте гостя он замечает, что amfid не принимает `vphone-vm`, открывает окно с помощью `vphone-letmein` (один запрос sudo) и закрывает его, как только гость запущен.++Сделать это вручную — имеет смысл при работе над `vphone-vm`, где один sudo лучше, чем запрос на каждый запуск:```-vphone-amfidont # .build/vphone-cli.app/Contents/Resources/vphone-amfidont для локальных сборок+make letmein # открыть (sudo)+make letmein_status # проверить+make letmein_off # закрыть```+> **Честно о том, что это делает.** Это глобальный переключатель, а не allowlist: пока окно открыто, amfid сообщает, что *каждая* проверяемая им подпись действительна и подписана Apple. Это нельзя сузить до одного пути или одного бинарника — решение на уровне отдельной проверки требует приватных отладочных entitlements Apple. Сузить можно время, поэтому автоматический путь держит окно открытым только на время одного запуска. Кроме того, это существует лишь в памяти: перезагрузка сбрасывает состояние.+>+> `vphone-letmein` заменяет старый помощник `amfidont`, который был pip-пакетом и больше не используется.+## Протестированные окружения| Хост ↕▾ | iPhone ↕▾ | CloudOS ↕▾ |@@ -179,7 +187,7 @@ vphone-amfidont # .build/vphone-cli.app/Contents/Resources/vphone-amfido## FAQ-**`zsh: killed ./vphone-cli`** — ограничения AMFI/debug не обойдены; см. Предварительные требования (`amfi_get_out_of_my_way=1` или `amfidont`).+**`zsh: killed ./vphone-vm`** — ограничения AMFI/debug не обойдены; см. Предварительные требования (`amfi_get_out_of_my_way=1` или пусть `vphone-cli` сам откроет окно). Обратите внимание: с самим `vphone-cli` такого произойти не может — у него нет entitlements, поэтому если убивают *его*, дело в чём-то другом.**`Virtualization is not available on this hardware`** — ваш Mac сам является ВМ; загрузка гостя PV=3 не может быть вложенной. Используйте невложенный хост macOS 15+.diff --git a/docs/README_zh.md b/docs/README_zh.mdindex 3b528e1d..9c8afc02 100644--- a/docs/README_zh.md+++ b/docs/README_zh.md@@ -137,7 +137,7 @@ csrutil allow-research-guests enablesudo nvram boot-args="amfi_get_out_of_my_way=1 -v" # 之后重启```-**方案 B——保持 SIP 开启(仅放宽 debug),然后用 amfidont 将二进制加入白名单**(AMFI 在系统范围内保持启用)。+**方案 B——保持 SIP 开启(仅放宽 debug),让 `vphone-cli` 在每次启动时替你开一次窗口**(其余时间 AMFI 保持启用)。在恢复模式下:@@ -146,12 +146,20 @@ csrutil enable --without debugcsrutil allow-research-guests enable```-然后重启进入 macOS 并执行:+然后重启进入 macOS。除此之外无需任何配置:`vphone-cli` 不带任何 entitlement,因此总能正常启动;当它拉起客户机时,会发现 amfid 不接受 `vphone-vm`,于是用 `vphone-letmein` 打开一个窗口(一次 sudo 提示),并在客户机跑起来后把它关掉。++手动操作也可以——在调试 `vphone-vm` 时值得这么做,一次 sudo 胜过每次运行都弹一次提示:```bash-vphone-amfidont # 本地构建见 .build/vphone-cli.app/Contents/Resources/vphone-amfidont+make letmein # 打开 (sudo)+make letmein_status # 查看+make letmein_off # 关闭```+> **请如实看待它的作用。** 这是一个全局开关,而不是白名单:窗口打开期间,amfid 会把它校验的*每一个*签名都报告为有效且由 Apple 签名。这一点无法收窄到某个路径或某个二进制——按次校验的判定需要 Apple 私有的调试器 entitlement。能收窄的是时间,所以自动路径只在一次启动的时长内保持窗口打开。它同样只存在于内存中:重启即失效。+>+> `vphone-letmein` 取代了旧的 `amfidont` 辅助工具——那是一个 pip 包,现已不再使用。+## 测试环境| 宿主机 | iPhone | CloudOS |@@ -179,7 +187,7 @@ vphone-amfidont # 本地构建见 .build/vphone-cli.app/Contents/Resourc## 常见问题-**`zsh: killed ./vphone-cli`** —— AMFI/debug 限制未被绕过;见[前置条件](#前置条件)(`amfi_get_out_of_my_way=1` 或 `amfidont`)。+**`zsh: killed ./vphone-vm`** —— AMFI/debug 限制未被绕过;见[前置条件](#前置条件)(`amfi_get_out_of_my_way=1`,或让 `vphone-cli` 替你开窗口)。注意这不会发生在 `vphone-cli` 自身上:它不带任何 entitlement,所以如果被杀的是*它*,那就是别处出了问题。**`Virtualization is not available on this hardware`** —— 你的 Mac 本身就是一台虚拟机;PV=3 客户机启动无法嵌套。请使用非嵌套的 macOS 15+ 宿主机。