マシン定義は直接読める JSON ファイルで、各設定に dotted key がある。
1vm config dev # 定義全体
1vm get dev # 利用可能な key 一覧
1vm get dev network.mode # 1 つ読む
1vm set dev network.mode nat
設定は起動時ではなく set 時に検証 — 無効値は理由付きで即失敗。エンジンが実行中変更をサポートする場合は live 適用、でなければ次回起動。実行中のハードウェア変更は、設定が明示しない限り拒否。
マシン
| Key | 備考 |
|---|
cpuCount | 仮想 CPU |
memory | 例 8GiB |
diskSize | 上限。ディスクは sparse |
macAddress | ゲスト MAC |
clipboardSharing | 双方向。Linux は spice-vdagent 必要。macOS ゲストは不可 |
rosetta | Linux ゲスト内 x86 変換。Virtualization.framework のみ |
ネットワーク
| Key | 備考 |
|---|
network.mode | nat、host-only、bridged:en0 |
portForwards.add | 例 tcp:2222:22 |
portForwards.remove | 同形式 |
共有フォルダ
| Key | 備考 |
|---|
sharedFolders.add | tag=projects path=~/Projects |
sharedFolders.remove | tag で |
グラフィックス
| Key | 備考 |
|---|
graphics.resolution | ゲスト表示サイズ |
graphics.displays | ヘッド数 |
graphics.hiDPI | Retina スケール |
graphics.acceleration | エンジンとゲストがサポートする場合 |
入力
| Key | 備考 |
|---|
input.commandKey | ⌘ がゲストに送るもの |
input.optionKey | ⌥ が送るもの |
input.translateMacShortcuts | Mac ショートカットをゲスト相当に |
input.translateOptionArrows | 単語単位カーソル移動 |
input.captureSystemShortcuts | ゲストがシステムショートカット取得 |
input.matchHostKeyboardLayout | Mac レイアウトに追従 |
input.keyboardProfile | ゲストに提示するキーボードモデル |
input.mouse | ポインタデバイス種別 |
input.releaseChord | キーボードキャプチャ解除キー |
SSH
| Key | 備考 |
|---|
ssh.access | Mac→ゲスト SSH の有効/無効 |
ssh.disable | オフ |
ssh.users | 到達可能なゲストユーザー |
ssh.hostPort | ホスト側ポート |
ssh.alias | ~/.ssh/config の名前 |
ssh.identity / ssh.identityFile | 鍵選択 |
ssh.passwordAuthentication | パスワード認証許可 |
利用不可設定について
Mac や選択エンジンがサポートしないオプションは理由付きで表示・無効のまま。消えるオプションは何も教えない。説明するオプションは別エンジンや新しい Mac で答えが変わるか示す。