Windows環境でのVirtualBoxとUbuntu仮想マシンのセットアップ

ステップ3：ゲストOS環境の構築（3章）
  Guest Additions による統合 ＋ 日本語環境の構築
  ─────────────────────────────────────────
ステップ2：仮想マシンの作成と Ubuntu のインストール（2章）
  VBoxManage による仮想マシンの構成
  ─────────────────────────────────────────
ステップ1：VirtualBox のインストール（1章）
  winget による VirtualBox のインストール
  ─────────────────────────────────────────

1. ステップ1：VirtualBox のインストール

1.1 インストール

管理者権限でコマンドプロンプトを起動する （手順：Windowsキーまたはスタートメニュー → cmd と入力 → 右クリック → 「管理者として実行」）。

次のコマンドを実行する。

REM VirtualBox をシステム領域にインストール
winget install --scope machine --id Oracle.VirtualBox -e --silent --disable-interactivity --force --accept-source-agreements --accept-package-agreements

REM VBoxManage のパス設定（システム環境変数に永続化）
powershell -NoProfile -Command "$p='C:\Program Files\Oracle\VirtualBox'; $c=[Environment]::GetEnvironmentVariable('Path','Machine'); if((Test-Path $p) -and $c -notlike \"*$p*\"){[Environment]::SetEnvironmentVariable('Path',\"$p;$c\",'Machine')}"

REM 現在のセッションにも反映
set "PATH=C:\Program Files\Oracle\VirtualBox;%PATH%"

REM VirtualBox Extension Pack をインストール
for /f "tokens=1 delims=r" %a in ('VBoxManage --version') do set "VBOX_VER=%a"
set "EXTPACK_URL=https://download.virtualbox.org/virtualbox/%VBOX_VER%/Oracle_VirtualBox_Extension_Pack-%VBOX_VER%.vbox-extpack"
set "EXTPACK_FILE=%TEMP%\Oracle_VirtualBox_Extension_Pack-%VBOX_VER%.vbox-extpack"
curl -L -o "%EXTPACK_FILE%" "%EXTPACK_URL%"
echo y | VBoxManage extpack install --replace "%EXTPACK_FILE%"
del "%EXTPACK_FILE%"

1.2 インストールの確認

• VirtualBox 本体の確認

  バージョン文字列が表示されれば、本体が正しくインストールされ、パスも通っている。

  VBoxManage --version

  

• Extension Pack の確認

  インストール済みの拡張パック一覧が表示される。Usable が true であれば正常に動作している。

  VBoxManage list extpacks

  

2. ステップ2：仮想マシンの作成と Ubuntu のインストール

VBoxManageのオプションでCPU・メモリ・ストレージ・ネットワークなどを設定し、Ubuntu仮想マシンを作成する。

2.1 VBoxManage modifyvm 主要オプション

2.2 ストレージ構成

仮想マシン
├── SATA Controller（IntelAhci）
│   └── Port 0: 仮想HDD（60GB, VDI形式）
└── IDE Controller（PIIX4）
    └── Port 0: DVDドライブ（Ubuntu ISO）

2.3 仮想マシンの作成と Ubuntu のインストール

コマンドプロンプトを起動する （手順：Windowsキーまたはスタートメニュー → cmd と入力）。

次のコマンドを実行する。なお、ここでは学習用に分かりやすさを優先し、ユーザー名とパスワードをスクリプト内に直接書いている。インストール後はゲストOSにログインしてパスワードを変更しておくとよい。

REM Ubuntu 24.04 LTS ISO ダウンロード設定
set "ISO_URL=https://releases.ubuntu.com/noble/ubuntu-24.04.4-desktop-amd64.iso"
set "ISO_DIR=%USERPROFILE%\VirtualBox VMs\ISO"
set "ISO_FILE=%ISO_DIR%\ubuntu-24.04.4-desktop-amd64.iso"

REM ISOディレクトリ作成
if not exist "%ISO_DIR%" mkdir "%ISO_DIR%"

REM ISOファイルが存在しない場合のみダウンロード
if exist "%ISO_FILE%" (
    echo Ubuntu 24.04 LTS ISO は既に存在します：%ISO_FILE%
) else (
    echo Ubuntu 24.04 LTS ISO をダウンロード中...
    curl -L -o "%ISO_FILE%" "%ISO_URL%"
    echo ダウンロード完了
)

REM 仮想マシン設定
set "VM_NAME=Ubuntu2404"
set "VM_DIR=%USERPROFILE%\VirtualBox VMs\%VM_NAME%"
set "VDI_FILE=%VM_DIR%\%VM_NAME%.vdi"
set "MEMORY_MB=8192"
set "STORAGE_MB=61440"
set "USER_NAME=myuser"
set "USER_PASSWORD=changeme"
set "SSH_HOST_PORT=2222"
set "SSH_GUEST_PORT=22"

REM 仮想マシンディレクトリ作成
if not exist "%VM_DIR%" mkdir "%VM_DIR%"

REM 仮想マシン作成・登録
VBoxManage createvm --name="%VM_NAME%" --ostype=Ubuntu_64 --register --basefolder="%USERPROFILE%\VirtualBox VMs"

REM 基本設定（メモリ8GB, CPU2コア）
VBoxManage modifyvm "%VM_NAME%" --memory=%MEMORY_MB% --cpus=2 --ioapic=on --acpi=on

REM グラフィック設定
VBoxManage modifyvm "%VM_NAME%" --vram=128 --graphicscontroller=vmsvga

REM ファームウェア設定（EFI）
VBoxManage modifyvm "%VM_NAME%" --firmware=efi

REM パフォーマンス設定
VBoxManage modifyvm "%VM_NAME%" --paravirt-provider=kvm --nested-paging=on

REM 入力デバイス設定
VBoxManage modifyvm "%VM_NAME%" --mouse=usbtablet --keyboard=usb

REM ネットワーク設定（NAT / virtio）
VBoxManage modifyvm "%VM_NAME%" --nic1=nat --nic-type1=virtio --cable-connected1=on

REM SSHポートフォワーディング設定（ホスト2222 → ゲスト22）
VBoxManage modifyvm "%VM_NAME%" --nat-pf1="ssh,tcp,,%SSH_HOST_PORT%,,%SSH_GUEST_PORT%"

REM オーディオ設定
VBoxManage modifyvm "%VM_NAME%" --audio-enabled=on --audio-driver=default --audio-controller=hda --audio-out=on

REM クリップボード・ドラッグ＆ドロップ共有
VBoxManage modifyvm "%VM_NAME%" --clipboard-mode=bidirectional --drag-and-drop=bidirectional

REM USB設定
VBoxManage modifyvm "%VM_NAME%" --usb-ohci=on --usb-ehci=on

REM RTC設定（時計をUTCで扱う）
VBoxManage modifyvm "%VM_NAME%" --rtc-use-utc=on

REM 仮想ハードディスク作成（60GB）
VBoxManage createmedium disk --filename="%VDI_FILE%" --size=%STORAGE_MB% --format=VDI --variant=Standard

REM SATAコントローラ作成・ハードディスク接続
VBoxManage storagectl "%VM_NAME%" --name="SATA Controller" --add=sata --controller=IntelAhci --bootable=on
VBoxManage storageattach "%VM_NAME%" --storagectl="SATA Controller" --port=0 --device=0 --type=hdd --medium="%VDI_FILE%"

REM IDEコントローラ作成・DVDドライブ接続
VBoxManage storagectl "%VM_NAME%" --name="IDE Controller" --add=ide --controller=PIIX4
VBoxManage storageattach "%VM_NAME%" --storagectl="IDE Controller" --port=0 --device=0 --type=dvddrive --medium="%ISO_FILE%"

REM ブート順序設定
VBoxManage modifyvm "%VM_NAME%" --boot1=dvd --boot2=disk --boot3=none --boot4=none

REM 無人インストール設定・起動
VBoxManage unattended install "%VM_NAME%" ^
  --iso="%ISO_FILE%" ^
  --user=%USER_NAME% ^
  --password=%USER_PASSWORD% ^
  --full-user-name="%USER_NAME%" ^
  --locale=ja_JP ^
  --country=JP ^
  --time-zone=Asia/Tokyo ^
  --hostname=ubuntu2404.localdomain ^
  --no-install-additions ^
  --post-install-command="apt-get install -y openssh-server" ^
  --start-vm=separate

echo.
echo ========================================
echo 無人インストールが開始されました
echo インストール完了まで 15～30 分程度を要します

2.4 インストール完了の待機、SSH鍵の登録と自動ログインの設定

Ubuntu Desktop のインストールは、VMのリソースとインターネット接続速度に依存するが、通常15～30分程度で完了する。インストール完了後、VMは自動的に再起動する。以下のコマンドで、VMの再起動を検知してインストール完了を判定する（VirtualBoxが記録する再起動回数 ResetCounter を読み取り、1になった時点を完了とみなす）。

REM === インストール完了の待機 ===
set "VM_NAME=Ubuntu2404"
set "USER_NAME=myuser"
set "USER_PASSWORD=changeme"
set "SSH_HOST_PORT=2222"

set "INSTALL_DONE=" & for /L %i in (1,1,60) do @(if not defined INSTALL_DONE (timeout /t 30 /nobreak >nul & VBoxManage guestproperty get "%VM_NAME%" "/VirtualBox/VMInfo/ResetCounter" 2>nul | findstr /c:"Value: 1" >nul && (echo インストールが完了しました（VM が再起動しました）& set "INSTALL_DONE=1") || (echo インストール中 ... 30 秒待機します)))

REM === SSH 接続が可能になるまで待機 ===
echo SSH 接続を待機中 ...
set "SSH_DONE=" & for /L %i in (1,1,60) do @(if not defined SSH_DONE (timeout /t 10 /nobreak >nul & ssh -o StrictHostKeyChecking=no -o ConnectTimeout=5 -p %SSH_HOST_PORT% %USER_NAME%@localhost "echo SSH_OK" 2>nul | findstr "SSH_OK" >nul && (echo SSH 接続が確立されました & set "SSH_DONE=1") || (echo SSH 未応答 ... 10 秒待機します)))

REM === SSH鍵の作成と公開鍵の登録（以後パスワードなしで接続するため） ===
ssh-keygen -t ed25519 -f "%USERPROFILE%\.ssh\id_ed25519" -N ""
type "%USERPROFILE%\.ssh\id_ed25519.pub" | ssh -o StrictHostKeyChecking=no -p %SSH_HOST_PORT% %USER_NAME%@localhost "mkdir -p ~/.ssh && cat >> ~/.ssh/authorized_keys && chmod 600 ~/.ssh/authorized_keys"

REM === 自動ログイン設定（GDM3） ===
echo %USER_PASSWORD%| ssh -o StrictHostKeyChecking=no -p %SSH_HOST_PORT% %USER_NAME%@localhost "tr -d '\r' | sudo -S sed -i -e 's/^#.*AutomaticLoginEnable.*/AutomaticLoginEnable=true/' -e 's/^#.*AutomaticLogin\s*=.*/AutomaticLogin=%USER_NAME%/' /etc/gdm3/custom.conf"

echo === 動作確認 ===
VBoxManage --version
VBoxManage list extpacks
VBoxManage list vms
VBoxManage showvminfo "%VM_NAME%" | findstr /C:"Memory size" /C:"Number of CPUs" /C:"Firmware" /C:"VRAM size"

確認すべき出力項目：

• Memory size: 8192MB
• VRAM size: 128MB
• Firmware: EFI
• Number of CPUs: 2

3. ステップ3：ゲストOS環境の構築

Ubuntuのインストール完了後、Guest Additionsによるホストとゲストの間の統合と、日本語環境の構築を行う。

REM ===========================================================
REM 3. ステップ3：ゲストOS環境の構築
REM ===========================================================
REM 前提：無人インストール完了済み、ゲストOS起動済み、SSH接続可能
REM （NATポートフォワード: ホスト2222 → ゲスト22、openssh-server導入済み）

set "VM_NAME=Ubuntu2404"
set "USER_NAME=myuser"
set "USER_PASSWORD=changeme"
set "SSH_HOST_PORT=2222"

REM ===========================================================
REM 3.1 Guest Additionsのインストール
REM ===========================================================

REM 依存パッケージのインストール（ビルドに必要なツールとカーネルヘッダ）
echo %USER_PASSWORD%| ssh -o StrictHostKeyChecking=no -p %SSH_HOST_PORT% %USER_NAME%@localhost "tr -d '\r' | sudo -S sh -c 'apt-get update && apt-get install -y build-essential dkms linux-headers-$(uname -r)'"

REM Guest Additions ISOをマウント（--medium additions でVBoxが自動解決）
VBoxManage storageattach "%VM_NAME%" --storagectl "IDE Controller" --port 0 --device 0 --type dvddrive --medium additions

REM Guest Additionsのビルド・インストール
echo %USER_PASSWORD%| ssh -o StrictHostKeyChecking=no -p %SSH_HOST_PORT% %USER_NAME%@localhost "tr -d '\r' | sudo -S sh -c 'mount /dev/cdrom /mnt && /mnt/VBoxLinuxAdditions.run --nox11 && umount /mnt'"

REM Guest Additions ISO の取り外し
VBoxManage storageattach "%VM_NAME%" --storagectl "IDE Controller" --port 0 --device 0 --type dvddrive --medium emptydrive

REM 再起動
VBoxManage controlvm "%VM_NAME%" acpipowerbutton

REM === 再起動後の SSH 接続待機 ===
timeout /t 30 /nobreak
set "SSHGA_DONE=" & for /L %i in (1,1,60) do @(if not defined SSHGA_DONE (timeout /t 10 /nobreak >nul & ssh -o StrictHostKeyChecking=no -o ConnectTimeout=5 -p %SSH_HOST_PORT% %USER_NAME%@localhost "echo SSH_OK" 2>nul | findstr "SSH_OK" >nul && (echo Guest Additions インストール済みの VM が起動しました & set "SSHGA_DONE=1") || (echo SSH 未応答 ... 10 秒待機します)))

REM ===========================================================
REM 3.2 日本語環境の構築
REM ===========================================================

REM Ubuntu Japanese Teamリポジトリの追加と日本語パッケージのインストール
echo %USER_PASSWORD%| ssh -o StrictHostKeyChecking=no -p %SSH_HOST_PORT% %USER_NAME%@localhost "tr -d '\r' | sudo -S sh -c 'wget https://www.ubuntulinux.jp/sources.list.d/noble.sources -O /etc/apt/sources.list.d/ubuntu-ja.sources && apt-get update && apt-get install -y ubuntu-defaults-ja'"

REM 再起動（日本語環境を反映）
VBoxManage controlvm "%VM_NAME%" acpipowerbutton

REM === 再起動後の SSH 接続待機 ===
timeout /t 30 /nobreak
set "SSHJA_DONE=" & for /L %i in (1,1,60) do @(if not defined SSHJA_DONE (timeout /t 10 /nobreak >nul & ssh -o StrictHostKeyChecking=no -o ConnectTimeout=5 -p %SSH_HOST_PORT% %USER_NAME%@localhost "echo SSH_OK" 2>nul | findstr "SSH_OK" >nul && (echo 日本語環境の構築が完了しました & set "SSHJA_DONE=1") || (echo SSH 未応答 ... 10 秒待機します)))

リポジトリ追加後、パッケージ情報の更新時に署名鍵が弱いという警告（rsa1024 に関する W: ... weak algorithm の表示）が出ることがあるが、これはUbuntu Japanese Team側の鍵更新が完了すれば表示されなくなる。インストールの動作には影響しない。

4. トラブルシューティング

4.1 よくある問題と対処

4.2 VMの削除と再作成

REM VM登録解除とファイル削除
VBoxManage unregistervm "Ubuntu2404" --delete

REM 仮想ディスクのみ削除（VMは残す場合）
VBoxManage closemedium disk "%USERPROFILE%\VirtualBox VMs\Ubuntu2404\Ubuntu2404.vdi" --delete