インストール
1VMTool に必要なもの、インストール方法、およびアプリを特定の方法で署名する必要がある理由。
1VMTool は単一のアプリケーションです。別途インストールするランタイム、ダウンロードするハイパーバイザ、パッケージマネージャはありません。
要件
| Mac | Apple silicon。Intel 版はありません。 |
| macOS | 26 以降。 |
| Disk | 作成するマシンに十分な容量。ディスクはスパースなので、事前割り当てではなくゲストが書き込むにつれて増えます。 |
| Everything else | なし。QEMU、Homebrew、Docker、カーネル拡張は不要。 |
Apple silicon 要件はパッケージングの選択ではありません。両エンジンは CPU 上でゲストコードをネイティブ実行するため、ゲストは ARM64 である必要があります。ここでは外部命令セットをエミュレートしないため、どの Mac でも x86 ゲストはサポートされません。
インストール
1VM.app を /Applications にドラッグして開きます。初回起動時、macOS が署名と公証を検証します。その後はネットワークなしでもすぐに開きます。
コマンドライン
1vm はアプリバンドル内に同梱され、2 つのフロントエンドが乖離しないようにしています。PATH にリンクします:
ln -sf /Applications/1VM.app/Contents/MacOS/1vm /usr/local/bin/1vm
1vm --version
アプリができることはすべて 1vm でもできます — 1vm コマンドライン を参照。
署名が重要な理由
アプリは com.apple.security.virtualization エンタイトルメントを持たないと、すべてのマシンが起動に失敗します。Virtualization.framework を使用するプロセスに対する Apple の要件であり、ファーストパーティエンジンにはさらにハイパーバイザエンタイトルメントが必要です。
実際の影響: バイナリをアプリバンドルから移動したり、署名を剥がしたりしないでください。ソースからビルドする場合、パッケージングスクリプトはリリース手順ではなくビルドの一部として署名するため、ローカルビルドが謎の理由で壊れることはありません。
マシンの保存場所
デフォルトでは、マシンはホームディレクトリ内のフォルダライブラリに保存されます。ONEVM_HOME を設定して別の場所に保存できます — 例: 外付け SSD:
export ONEVM_HOME=/Volumes/Fast/vms
各マシンは自己完結型フォルダです。VM バンドル を参照。
ホストの確認
1vm doctor はホスト、エンタイトルメント、ライブラリ、両エンジンを報告します。
1vm capabilities はこの特定の Mac ができることとできないことを出力します — ネストされた仮想化などは想定ではなく機能検出されます。
1vm doctor
1vm capabilities