Contents
WSL2とDocker Desktopの連携設定：初心者向けガイド
WSL2（Windows Subsystem for Linux）とDocker Desktopを組み合わせることで、Windows環境でもLinuxベースの開発やコンテナ操作が可能になります。本記事では、仮想化機能の有効化からDockerデーモン接続設定まで、初心者向けにステップバイステップで解説します。特にWSL2 + Dockerの連携メリットや、最新版環境構築時の注意点を重視して記述しています。
Windowsの仮想化機能有効化手順
WSL2は仮想マシン技術（Hyper-V）を基盤としているため、Windowsの仮想化機能（VT-x/AMD-V）が必須です。このセクションでは、BIOS/UEFI設定やPowerShellコマンドでの確認方法について解説します。
仮想化有効化の重要性
- WSL2はLinuxカーネルを仮想マシンとして動作させるため、CPUの仮想化サポートが必須です。
- パフォーマンスやセキュリティの観点からも、無効なままではWSL2を使用できません。
具体的な手順
- Windows「設定」→「更新とセキュリティ」→「回復」→「Advanced startup」から「Restart now」をクリックし、BIOS/UEFI画面に移動します。
- BIOS/UEFIでVT-x（Intel）またはAMD-V（AMD）の仮想化技術を有効化します。
注意: Windows 10 Home版では、BIOS設定ができない場合があります。その際は以下を実行してください:
|
1 2 |
Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Hyper-V -All |
確認方法
PowerShellで systeminfo を実行し、「Hyper-V プラットフォーム」が「Enabled」と表示されているか確認してください。
WSL2のインストールとLinuxディストリビューション選定
WSL2はWindows標準搭載のLinuxサブシステムであり、Docker環境構築に最適です。Microsoft Storeからインストール後、必要なLinuxディストリビューションを選びます。
インストール手順
- PowerShell（管理者権限）で
wsl --installを実行します（2026年時点では推奨コマンドですが、変更される可能性があるため公式ドキュメントを確認してください）。 - またはMicrosoft Storeから「WSL」アプリをインストールし、「Ubuntu」などのLinuxディストリビューションを追加します。
主なディストリビューション比較
| ディストリビューション | 特徴 | 推奨用途 |
|---|---|---|
| Ubuntu | コミュニティサポートが豊富で、Docker公式ドキュメントでも頻出 | 入門者向け / 一般的な開発環境 |
| Debian | 細かいカスタマイズが必要な場合に最適 | 高度なシステム構築 |
| Kali Linux | セキュリティツールが豊富 | 測定・テスト用途 |
重要: Ubuntuは広く利用されているディストリビューションですが、裏付けデータがないため、他のディストリビューションも検討する価値があります。
Docker DesktopのインストールとWSL2連携設定
Docker Desktopを最新版でインストールし、WSL2との統合オプションを有効化します。
最新版Docker Desktopの選定
- 2026年7月時点では Docker Desktop 4.25.1 がリリースされていますが、実際には現在のバージョン（例: Docker Desktop 4.20）を推奨します。将来的に変更される可能性があるため、公式サイトで最新情報を確認してください。
メリットと重要性
- パフォーマンス: WSL2はLinuxカーネルを直接利用するため、Dockerデーモンの起動が高速です。
- リソース効率: Windows内での仮想マシンとしてのDocker環境構築に比べて、メモリやCPU使用量が抑えられます。
- 統合性: WSL2とDocker Desktopを連携することで、ファイル共有やネットワーク設定がシンプルになります。
WSL2からDockerデーモン接続設定
WSL2内でDockerコマンドを使用するには、環境変数の設定が必要です。
接続手順
- Ubuntuを起動し、以下を実行してDockerをインストールします:
|
1 2 |
sudo apt update && sudo apt install docker.io -y |
- 環境変数設定（shellに依存しない方法を推奨）:
-
/etc/environmentに記述:
bash
export DOCKER_HOST="unix:///var/run/docker.sock" -
全ユーザーで有効化する場合、
/etc/profile.d/docker.shを作成し、上記内容を記入します。 -
環境変数の反映:
|
1 2 |
source /etc/environment |
動作確認方法
WSL2内で docker info を実行し、Dockerデーモンが認識されているか確認します。
Docker DesktopのWSL2統合オプション設定
Docker DesktopアプリでWSL2との連携をさらに強化する手順です。
統合設定手順
- Docker Desktopアプリを開き、「Settings」→「Resources」→「WSL Integration」タブへ移動します。
- 右側のリストから使用しているWSL2ディストリビューション（例: Ubuntu）を選択し、「Enable integration with WSL2」をONにします。
- 「Apply & Restart」をクリックし、Docker Desktopを再起動します。
バージョン確認: Docker Desktopアプリ内「About Docker Desktop」からインストール済みバージョンを確認できます（例: Docker Desktop 4.25.1）。
まとめ
本記事では、WSL2とDocker Desktopの連携設定手順を詳細に解説しました。重要なポイントは以下です:
- 仮想化機能(VT-x/AMD-V)の有効化が必須
- Linuxディストリビューション選定（Ubuntuを含む）における柔軟性と裏付けデータの検討
- Docker Desktopの最新版確認とWSL2統合オプションの有効化
- 環境変数設定時のshellに依存しない方法の推奨
- WSL2 + Docker連携のパフォーマンスやリソース効率のメリット
最新バージョンの確認や、実装時の具体例はコメント欄にご記入ください。