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」を開きます。
• 状態の確認: 右下隅の「仮想化」の状態が 「有効」 と表示されていることを確認してください。
• 有効化方法: 有効になっていない場合は、コンピューターを再起動して BIOS/UEFI 設定に入り、Intel VT-x や AMD-V に似たオプションを探して Enabled に設定してください。

1.3 Windows の関連機能の有効化

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

方法 A: グラフィカルインターフェースを使用する (推奨)

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

方法 B: コマンドラインを使用する (管理者権限)

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

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

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

実行後、手動でコンピューターを再起動してください。

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

最新の Windows バージョンでは、Microsoft Store から WSL の更新を取得できます。

• ダウンロード URL: 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 つずつ確認してください：

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

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

   両方のコマンドの状態が 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、火絨など）が仮想ディスク操作を妨害する可能性があるため、問題を調査する際は一時的に無効にして再試行してください。