WSL の設定

WSL Dashboard を使用する前に、お使いの Windows システムで WSL 2 環境が正しく有効化・設定されている必要があります。このドキュメントは以下の 3 部構成です：

1. WSL の有効化と設定：WSL 2 の基本的なインストールと設定を完了します。
2. コマンドが使える ≠ インストール成功：wsl コマンドが実行できても、Linux をインストールできるとは限らないことを説明します。
3. インストール失敗のトラブルシューティング：設定完了後もインストールが失敗する場合の確認・修復方法。

1. WSL の有効化と設定

この章では、必要な基本設定について説明します。この章を完了したら、第 2 章 を読んで、コマンドが使えることとインストールが成功することの違いを理解してください。それでもインストールに問題がある場合は、第 3 章 を参照してください。

1.1 システム要件の確認

WSL 2 には Windows のバージョンに関する最低要件があります。Win + R を押して、winver と入力し、お使いのバージョンを確認してください：

• Windows 10: バージョン 1903 以降、かつビルド番号が 18362 以降である必要があります。
• Windows 11: すべてのバージョンでサポートされています。

IMPORTANT

バージョンが古すぎる場合は、先に「Windows Update」でシステムをアップグレードしてください。

1.2 ハードウェア仮想化の有効化

WSL 2 は仮想化技術を基盤として動作するため、マザーボードの BIOS/UEFI で 仮想化技術 (Virtualization Technology) を有効にする必要があります。

• 確認方法: 「タスクマネージャー」→「パフォーマンス」タブ→「CPU」を開きます。
• 状態の確認: 右下の「仮想化」の状態が 「有効」 と表示されていることを確認します。
• 有効化方法: 有効になっていない場合は、PC を再起動して BIOS/UEFI 設定に入り、Intel VT-x や AMD-V などのオプションを探して Enabled に設定します。

1.3 Windows の関連機能の有効化

Windows の「Linux 用 Windows サブシステム」と「仮想マシンプラットフォーム」機能を有効にする必要があります。

方法 A：GUI から（推奨）

1. Win + S を押して、「Windows の機能の有効化または無効化」 を検索して開きます。
2. 以下の 2 項目にチェックを入れます：
   • Linux 用 Windows サブシステム (Windows Subsystem for Linux)
   • 仮想マシンプラットフォーム (Virtual Machine Platform)
3. 「OK」をクリックし、プロンプトが表示されたらPC を再起動します。

方法 B：コマンドラインから（管理者権限）

管理者として PowerShell を実行し、以下のコマンドを実行します：

# WSL を有効化
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart

# 仮想マシンプラットフォームを有効化
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

実行後、手動でPC を再起動してください。

1.4 WSL カーネルのインストール/更新

新しいバージョンの Windows では、Microsoft Store から WSL の更新を入手できます。

• ダウンロード先: Microsoft Store - Windows Subsystem for Linux
• 手動ダウンロード: ストアが利用できない場合は、WSL GitHub Releases から最新の .msixbundle または .msi インストールパッケージをダウンロードしてオフラインインストールできます。

1.5 WSL 2 をデフォルトバージョンに設定

新しくインストールするディストリビューションがデフォルトで WSL 2 を使用するように、ターミナルで以下を実行します：

wsl --set-default-version 2

1.6 よくある質問

• エラー 0x80370102: 通常は BIOS で仮想化が有効になっていないか、Hyper-V との競合が原因です。
• WSL 1 と WSL 2 の切り替え: wsl --set-version <ディストリビューション名> 2 を使用すると、既存の WSL 1 インスタンスを WSL 2 にアップグレードできます。

2. コマンドが使える ≠ インストール成功

wsl --version、wsl -l -v などのコマンドが正常に実行できることは、Linux をインストールできる環境が整っているという意味ではありません。両者は異なる段階であり、同じものとみなすことはできません。

コマンドが使えるということは、次のことだけを意味します：

• ✅ Windows で WSL コンポーネントが有効化/インストール済み
• ✅ wsl.exe コマンドラインツールが利用可能
• ✅ システムが WSL 関連コマンドを認識できる

しかし、Linux ディストリビューションのインストールを成功させるには、追加の条件を満たす必要があります。 よくつまずくポイントは次のとおりです：

1. 仮想化が無効：BIOS/UEFI で VT-x / AMD-V が有効になっていない場合、WSL 2 を起動できず、ディストリビューションのインストール時に仮想化エラーが報告されます（確認方法は 1.2 ハードウェア仮想化の有効化 を参照）。
2. Windows のバージョン/ビルドが古すぎる：WSL 2 にはカーネルとバージョンの要件があります。Home エディションや古すぎるエンタープライズイメージでは機能が不足する場合があります（確認方法は 1.1 システム要件の確認 を参照）。
3. Linux ディストリビューションがまだ実際にインストールされていない：wsl -l -v はインストール済みのディストリビューションのみを一覧表示します。何もインストールしていない場合、リストは空になります。これは Ubuntu を直接実行できることを意味しません。
4. ネットワーク / Microsoft Store の問題：wsl --install -d <ディストリビューション> はストアまたはネットワークからイメージを取得する必要があるため、社内ネットワーク、プロキシ、ファイアウォールによってブロックされる可能性があります。
5. 権限不足：ディストリビューションのインストールや WSL 設定の変更には管理者権限が必要です。

TIP

簡単に言えば、WSL コマンドが使える ≠ Linux が準備完了です。「入場券」を手に入れただけで、まだ実際にシステムはインストールされていません。

3. インストール失敗のトラブルシューティング

第 1 章 に従って設定を完了した（または設定完了だと思っている）のに、wsl --install が依然として失敗する場合は、次の順序で確認してください。

3.1 まず「ワンタップ診断」を実行

管理者権限で PowerShell を実行し、順に以下を実行します：

wsl --install --no-distribution
wsl --set-default-version 2

• ✅ この 2 つのコマンドが問題なく実行できれば、WSL のオプションコンポーネントが有効で、仮想化の条件もほぼ満たされています。
• ❌ 失敗した場合、何が不足しているか（仮想マシンプラットフォーム、Hyper-V、BIOS 仮想化など）が直接表示されます。

次に systeminfo を実行し、出力に Virtualization Enabled In Firmware: Yes が表示されることを確認します。上記すべてでエラーがなければ、安心して wsl --install でディストリビューションをインストールできます。

NOTE

wsl --install が確実に成功することを 100% 保証するコマンドはありませんが、上記の診断でインストールの条件が満たされているかを確認できます。

3.2 手動チェックリスト

「ワンタップ診断」でも問題を特定できない場合は、項目ごとに確認します：

1. BIOS/ファームウェアの仮想化が有効かどうか：管理者 PowerShell で systeminfo を実行し、出力に Virtualization Enabled In Firmware: Yes が表示されることを確認します。
2. Windows の機能が有効かどうか：

   Get-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux
   Get-WindowsOptionalFeature -Online -FeatureName VirtualMachinePlatform

   2 つのコマンドの状態が両方とも Enabled である必要があります。
3. WSL が利用可能かどうか：wsl --version を実行して正常に出力されることを確認します。「コマンドが見つかりません」と表示された場合、WSL コンポーネントがインストールされていないので、第 1 章 に戻ってください。
4. WSL 2 を使用できるかどうか（カーネル & 仮想マシンプラットフォーム）：wsl --set-default-version 2 が正常に返ることを確認します。よくある失敗原因は、仮想マシンプラットフォームが有効になっていないか、BIOS で VT-x / AMD-V が有効になっていないことです。

3.3 よくある失敗原因の早見表

状況	説明	対処方法
BIOS で仮想化が無効	必ず失敗する	再起動して BIOS で VT-x / AMD-V を有効にする（1.2 を参照）
Windows 10 が 19041 未満	wsl --install に対応していない	システムをアップグレード（1.1 を参照）
企業環境で Hyper-V / 仮想化が無効化	失敗する可能性がある	システム管理者に連絡
古い Home エディション	手動インストールが必要	1.4 に従って WSL カーネルを手動インストール

3.4 エラー 0xc03a0014：仮想ディスクサポートプロバイダーが見つからない

エラーメッセージは Cannot find a virtual disk support provider for the specified file です。これは Linux ディストリビューション自体の問題ではなく、Windows の VHD/VHDX 仮想ディスクスタックが正常に動作していないことが原因で、WSL 2 がディストリビューションの登録、ext4.vhdx の作成/マウントに失敗します。

まず最小限の検証：管理者権限で PowerShell を実行し、New-VHD をテストします（例：New-VHD -Path C:\test.vhdx -SizeBytes 1GB）。このコマンドでも同じエラーが報告される場合、問題は 100% Windows 側にあり、ディストリビューションとは無関係です。

次の順序で確認・修復します：

1. Virtual Disk サービスが停止している：services.msc を開き、Virtual Disk サービスを見つけ、スタートアップの種類を「自動」に設定して起動します。

2. WSL / 仮想マシンプラットフォーム機能が有効になっていない（または反映されていない）：1.3 Windows の関連機能の有効化 のコマンドを再実行し、その後必ず再起動します。Windows Home エディションには完全な Hyper-V はありませんが、WSL 2 に必要なのは仮想マシンプラットフォームであり、Hyper-V 管理インターフェースではありません。

3. 仮想ディスクドライバー/デバイスが不足している：デバイスマネージャーを開き、「システムデバイス / ストレージコントローラー」に以下が存在するか確認します：

   • Microsoft Virtual Disk Provider
   • Microsoft Virtual Drive Enumerator
   • Microsoft VHD Loopback Controller

   不足している場合は、hdwwiz.exe で手動追加できます（ストレージコントローラー → Microsoft → Microsoft VHD ループバックコントローラー）。また、FsDepends サービスが無効化されていないことも確認します。

4. インポートしたイメージが WSL の要件を満たしていない：wsl --import --vhd を使用する場合、VHDX は ext4 ファイルシステムである必要があります。LUKS 暗号化ディスク、通常の raw.img、Live ISO、NTFS/FAT でフォーマットされた空ディスクは使用できません。.img / .qcow2 / .iso は wsl --import --vhd に直接使用できません。

5. パス/権限/ファイルシステムの問題：対象ディレクトリは NTFS ディスク上にある必要があります（FAT32/exFAT は不可）。パスに日本語、スペース、特殊文字が含まれないようにします。ネットワークドライブ、OneDrive、圧縮フォルダからはインポートしないでください。必ず本当の管理者 PowerShell（通常のターミナルではなく）を使用してください。

6. システムコンポーネントの破損：DISM と SFC を順に実行してシステムコンポーネントを修復し、その後再試行します：

   DISM.exe /Online /Cleanup-Image /RestoreHealth
   sfc /scannow

TIP

サードパーティ製の仮想マシン（VirtualBox、VMware）やセキュリティソフトのサンドボックス/強化機能（360、火绒など）が仮想ディスク操作を妨害する可能性があります。調査時は一時的に無効にしてから試してください。