---
title: "WSL Containers（wslc）の使い方｜Compose・プロキシの対応状況とDocker Desktopとの使い分け【WSL 3.0.3時点】"
url: "https://www.issoh.co.jp/tech/details/18105/"
published: 2026-10-05
updated: 2026-10-23
categories: ["Kubernetes・コンテナ"]
publisher: "株式会社一創"
---

# WSL Containers（wslc）の使い方｜Compose・プロキシの対応状況とDocker Desktopとの使い分け【WSL 3.0.3時点】

WSL Containers（WSLC）は、Windows Subsystem for Linuxに組み込まれたLinuxコンテナの実行機能です。コマンドは`wslc`で、`wsl --update`のあとPowerShellから`wslc run`を打てばコンテナが起動します。この記事では、導入・起動・ビルド・ボリューム・設定の手順に加えて、検索の多い「`wslc compose`は使えるのか」「プロキシ環境で`wslc pull`が失敗するのはなぜか」に、公式ドキュメントとGitHubのソースで答えます。内容は2026年10月23日時点の安定版WSL 3.0.3に基づきます。

## まとめ：WSL 3.0.3時点のwslcでできること・できないこと

wslcで日常の単発コンテナ作業は完結します。`run`・`build`・`exec`・`logs`・`volume`・`network`・`login`・`push`はDockerとほぼ同じ書き方で、DockerfileもContainerfileもそのままビルドできます。追加のインストールは不要で、WSLを2.9.3以上に上げれば使えます。

できないことは3つです。

- **compose**：3.0.3に`compose`サブコマンドはありません。開発ブランチには`compose up`の実装がありますが、使えるキーが8種類だけで、`build`も書けません。
- **プロキシの設定**：wslcの設定ファイルにプロキシの項目がなく、明示プロキシを通らないと外へ出られない社内ネットワークでは`pull`が失敗します。設定項目を足すプルリクエストは未マージです。
- **Docker互換API**：`DOCKER_HOST`でつなぐ`docker`コマンドやTestcontainersは動きません。VS CodeのDev Containersは、Docker Pathを`wslc`にすれば使えます。

`compose.yaml`で複数のサービスを起動している開発環境は、当面Docker DesktopかWSL内のDocker Engineを残します。コンテナ1〜2個の手順書で済む作業と、Windowsアプリへの組み込みはwslcへ移せます。

## WSL Containersの構成とWSL 2ディストリビューションとの違い

### wslc.exeのCLIとNuGet配布のAPIからなる2部構成

公式ドキュメント[WSL container（Microsoft Learn）](https://learn.microsoft.com/en-us/windows/wsl/wsl-container)によれば、この機能はLinuxコンテナをビルド・実行・操作するCLI「`wslc.exe`」と、Windowsアプリの処理の一部としてLinuxコンテナを使うためのAPIの2つで構成されています。`wslc.exe`はWSLに同梱され、別名の`container.exe`でも呼び出せます。

従来、WindowsでLinuxコンテナを動かすには、Docker Desktopを入れるか、Ubuntuなどのディストリビューションに[Docker](/tech/details/6857/)のEngineを自分で入れるかのどちらかでした。WSL Containersは実行基盤をWSL側が持つので、ディストリビューションの中でデーモンを管理する作業が要りません。

### ユーザー単位のセッションVMで動くcontainerdとdockerd

内部構造は[WSLC Architecture deep dive](https://devblogs.microsoft.com/commandline/wslc-architecture-deep-dive/)で公開されています。特権を持つWindowsサービス`wslservice.exe`が仮想マシンを作り、ユーザー権限で動く`wslcsession.exe`がそのユーザーのセッションを管理します。イメージ・コンテナ・ボリュームはセッションごとのVHDに保存され、wslcの既定のセッションは`%LOCALAPPDATA%\wslc\sessions`に置かれます。

VMの中で動くエンジンはDockerと同じ系統です。タグ3.0.3の[WSLCSession.cpp](https://github.com/microsoft/WSL/blob/3.0.3/src/windows/wslcsession/WSLCSession.cpp)は、セッション起動時に`/usr/bin/containerd`を立ち上げ、続けて`/usr/bin/dockerd --containerd /run/containerd/containerd.sock`を起動しています。wslcの操作感がDockerに近く、Dockerfileがそのままビルドできるのはこのためです。一方、このdockerdの接続口はWindows側へ公開されていません（後述のDOCKER\_HOST非対応の理由）。

ネットワークは「Consommé」という方式です。VMの通信はWindows側のユーザー権限のプロセスへ渡され、DNS応答・TCP/UDPの中継・ポートの対応付けをWindowsで処理します。deep diveはこの方式の利点を、VPNやファイアウォールとの互換性として説明しています。ただし、これはHTTPプロキシの設定を自動で引き継ぐという意味ではありません（プロキシの章で扱います）。

### WSL 3.0.1・3.0.3の版番号と「WSL 3」という呼び方の誤解

「wsl 3.0.1」「wsl3 docker」と検索されることがありますが、3.0.1や3.0.3はWSLアプリの版番号です。[microsoft/WSLのリリース](https://github.com/microsoft/WSL/releases)では、3.0.1（2026年9月29日）でWSLCが一般提供になり、3.0.3（10月9日）が現在の安定版、3.0.4（10月20日）はプレリリースです。ディストリビューションを動かす仕組みはWSL 2のままで、WSL 1・WSL 2に続く第3の方式が出たわけではありません。WSL 2そのものの仕組みは[WSL2とは？WSL1との違い・仕組み・インストール手順](/tech/details/3410/)で解説しています。

## WSLの更新でwslcを使える状態にする手順

### 必要なWSLの版2.9.3以上とバージョン確認のコマンド

[Get started with WSL container](https://learn.microsoft.com/en-us/windows/wsl/tutorials/wsl-containers)が示す前提は、WSLのバージョン2.9.3以上です。Microsoft Storeや`wsl --update`で通常の更新を受けていれば、3.0.3が入ります。

```
# PowerShellで実行する
wsl --update
wsl --version

# wslc の版と、使えるサブコマンドの一覧
wslc version
wslc --help
```

`wsl --version`の「WSL バージョン」が2.9.3未満なら、`wslc`コマンド自体がありません。社内のPCで更新が止められている場合は、管理者側のWSLの更新ポリシーを確認します。WSL本体の導入や`.wslconfig`の調整は[WSLで開発環境を構築する手順｜.wslconfig調整とDocker連携・肥大化の対処](/tech/details/17354/)にまとめています。

### hello-worldイメージでのセッション起動の確認

```
# 初回はイメージの取得とセッションVMの起動が走る
wslc run --rm hello-world

# セッションとエンジンの状態を見る
wslc system info
```

「Hello」で始まるメッセージが出れば準備完了です。止まる場合は、BIOSで仮想化が無効になっていないかなど、WSL 2そのものが動かない原因から疑います。Hyper-V関連機能の状態は[Hyper-Vの有効化と仮想マシン作成手順｜PowerShell操作とWSL2との併存](/tech/details/17468/)の確認手順が使えます。

## wslc runでのnginx起動・ポート公開・execの手順

### \-dと-pでのWebサーバーのバックグラウンド起動とポートの公開範囲

```
# 使い捨てのUbuntuコンテナでコマンドを1回実行する
wslc run --rm -it ubuntu:latest bash -c "echo Hello world from WSL container!"

# nginxをバックグラウンドで起動し、Windows側の8080をコンテナの80へつなぐ
wslc run -d --rm -p 8080:80 --name web nginx

# Windows側から応答を確認する（PowerShellでは curl.exe と書く）
curl.exe localhost:8080
```

オプションの意味はDockerと同じで、`-d`がバックグラウンド実行、`--rm`が停止時の自動削除、`-p ホスト側:コンテナ側`がポート公開です。公開したポートは既定で`127.0.0.1`にだけ結び付きます（[WSL container settings](https://learn.microsoft.com/en-us/windows/wsl/wsl-container-settings)の`session.defaultBindingAddress`）。同じLANの別のPCから見せたいときは、後述の設定ファイルでこの値を`0.0.0.0`に変えます。

逆に、コンテナからWindows側のサービス（ローカルで動かしているAPIなど）へつなぐときは、ホスト名`host.wslc.internal`を使います。

### container list・exec・logs・stopでのコンテナの確認と停止

```
# 実行中のコンテナ一覧（停止中も含めるなら --all）
wslc container list
wslc ps

# 実行中のコンテナでコマンドを動かす
wslc exec web cat /etc/os-release

# ログ・詳細・リソース使用量
wslc logs web
wslc inspect web
wslc stats

# 停止と後片付け（prune は container / image などの下にある）
wslc stop web
wslc container prune
wslc image prune
```

3.0.3のソースでは、`ps`は`container list`の別名で、`logs`・`stop`・`rm`・`images`・`rmi`などはDockerと同じくトップレベルでも打てます。`prune`はトップレベルに無いので`wslc container prune`のように書きます。ファイルコピーは3.0.3では`wslc container cp`で、トップレベルの`wslc cp`は3.0.4（プレリリース）で追加された別名です。

イメージと停止済みコンテナはセッションのVHDに溜まります。`prune`を打たないとCドライブの空きが減っていくので、容量の小さい端末は保存先を別ドライブへ移します（設定の章）。

## DockerfileとContainerfileからwslc buildでイメージを作る手順

### Dockerfileの扱いとContainerfileと併存したときの-f指定

公式チュートリアルはプロジェクト直下に`Containerfile`を置く例で説明していますが、ファイル名は`Dockerfile`のままでもビルドできます。タグ3.0.3の`ImageService.cpp`は、ビルドコンテキストに`Containerfile`と`Dockerfile`のどちらがあるかを調べ、両方あると「Both Dockerfile and Containerfile found. Use -f to select the file to use」というエラーで止まります。既存のリポジトリに両方が置かれている場合は`-f`で指定します。

ここから先の例は、公式チュートリアルと同じく、`requirements.txt`（`django`を記載）と`manage.py`を持つ既存のDjangoプロジェクトの直下で実行する前提です。

```
# Containerfile（Dockerfile という名前でもよい）
FROM python:3
WORKDIR /app
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt
COPY . .
EXPOSE 8000
CMD ["python", "manage.py", "runserver", "0.0.0.0:8000"]
```

```
# イメージをビルドしてタグを付ける（ファイルを明示するなら -f）
wslc build -t helloworld-django .
wslc build -t helloworld-django -f Dockerfile .
wslc images

# 起動してWindowsのブラウザから http://localhost:8000/ を開く
wslc run -d --rm -p 8000:8000 --name django helloworld-django
wslc exec django uname
```

`wslc exec django uname`が「Linux」を返せば、コンテナ内でコマンドが実行できていることを確認できます。`build`は`--build-arg`・`--target`・`--no-cache`・`--secret`も受け付けます。マルチステージのDockerfileも、そのままの書き方で通ります。

### 手順書のdockerコマンドをwslcへ読み替える対応表

3.0.3のソース（`src/windows/wslc/commands`）にあるコマンドに絞った対応です。

| やりたいこと    | Docker                | wslc（3.0.3）                     |
| --------- | --------------------- | ------------------------------- |
| コンテナを起動   | `docker run`          | `wslc run`                      |
| 実行中の一覧    | `docker ps`           | `wslc ps`／`wslc container list` |
| イメージ一覧    | `docker images`       | `wslc images`                   |
| イメージを作る   | `docker build`        | `wslc build`                    |
| レジストリに登録  | `docker login`／`push` | `wslc login`／`push`             |
| tarで受け渡し  | `docker save`／`load`  | `wslc save`／`load`              |
| ファイルを複製   | `docker cp`           | `wslc container cp`             |
| 名前付きボリューム | `docker volume`       | `wslc volume`                   |
| ネットワーク    | `docker network`      | `wslc network`                  |
| イベント監視    | `docker events`       | `wslc events`                   |
| 複数コンテナ定義  | `docker compose`      | なし                              |

[Windows Developer BlogのGA告知](https://blogs.windows.com/windowsdeveloper/2026/09/29/wsl-containers-now-generally-available/)では、`container restart`、tarを介した`container cp`、ヘルスチェック、`network connect`・`disconnect`、`events`、`--mount`、`--stop-timeout`が一般提供で追加されたと説明されています。プレビュー期の記事にある「ファイルをコピーできない」は、3.0.1以降には当てはまりません。

## wslc volumeと-vでコンテナのデータを残す方法

### \-vとvirtiofsでのWindowsフォルダの共有

コンテナを削除すると、その中に書いたファイルは消えます。残したいデータはボリュームに置きます。最も単純なのはWindowsのパスを`-v`で渡す方法で、deep diveの例は次の形です。

```
# Windowsのフォルダをコンテナの /data に見せる
wslc run --rm -v C:\work\data:/data -it debian:latest ls /data
```

このマウントはVM内でvirtiofsの共有として作られ、コンテナにバインドマウントされます。deep diveによれば、virtiofsは従来のplan9方式より約2倍速い設計です。

### VHDボリュームでのLinuxファイルシステムと容量上限の確保

データベースのデータのように、Linuxのファイルシステムの性質（権限やシンボリックリンク）が要る場合や、容量に上限を付けたい場合はVHDボリュームを使います。

```
# 約200MBのVHDボリュームを作る
wslc volume create --driver vhd -o SizeBytes=200000000 my-volume

# 名前で複数のコンテナにマウントできる
wslc run --rm -v my-volume:/volume -it debian:latest findmnt /volume

wslc volume list
wslc volume prune
```

deep diveの出力例では、このボリュームはコンテナ内でext4としてマウントされています。

### WSLディストリビューション内のパスをマウントするときの制約

注意したいのは、UbuntuなどのWSLディストリビューションに置いたフォルダです。wslcのセッションVMとディストリビューションは別のVMで動くため、ディストリビューション側のパスをバインドマウントする使い方は公式にはサポートされていません。VS CodeのIssue [#11750](https://github.com/microsoft/vscode-remote-release/issues/11750)ではMicrosoftの担当者が、現時点で`wslc.exe`をディストリビューションの中から使う形はサポートしておらず、バインドマウントは非常に難しいと説明しています。ディストリビューション内での実行を求める要望は[microsoft/WSLのIssue #41105](https://github.com/microsoft/WSL/issues/41105)として2026年10月23日時点でOpenです。

公式チュートリアルはソースをWSLのファイルシステムに置いて`wslc build`する手順で、ビルドはこの形で通ります。マウントして編集しながら動かす開発では、当面ソースをWindows側（例：`C:\src`）に置いて`-v`で渡します。

## wslc settingsでのCPU・メモリ・保存先の設定

wslcのセッションの資源は、ユーザーごとの`%LOCALAPPDATA%\wslc\settings.yaml`で決まります。`.wslconfig`の設定はWSL Containersには効かない、と[WSL container settings](https://learn.microsoft.com/en-us/windows/wsl/wsl-container-settings)に明記されています。ディストリビューション用にメモリを絞っていても、wslc側は別に設定が要ります。

```
# 設定ファイルを作って既定のエディタで開く（初回は全項目がコメントアウト）
wslc settings

# 既定値のコメントアウト状態に戻す
wslc settings reset

# 変更をセッションに反映する（次の wslc 実行で新しいセッションが立ち上がる）
wslc system session terminate
```

```
session:
  cpuCount: 4
  memorySize: 8GB
  maxStorageSize: 200GB
  storagePath: D:\wslc
  defaultBindingAddress: 127.0.0.1
  hostLoopback: host.wslc.internal
  idleTimeout: 60
```

| 項目                              | 既定値                  | 反映       |
| ------------------------------- | -------------------- | -------- |
| `session.cpuCount`              | 全論理プロセッサ             | セッション起動時 |
| `session.memorySize`            | Windowsの総メモリの50%     | セッション起動時 |
| `session.maxStorageSize`        | 1TB                  | セッション起動時 |
| `session.storagePath`           | `%LOCALAPPDATA%`     | セッション起動時 |
| `session.defaultBindingAddress` | `127.0.0.1`          | コマンドごと   |
| `session.hostLoopback`          | `host.wslc.internal` | セッション起動時 |
| `session.idleTimeout`           | 30秒                  | セッション起動時 |
| `credentialStore`               | `wincred`            | コマンドごと   |

`storagePath`を変えても、既存のイメージやコンテナは移動しません。新しい場所に空のセッションが作られるので、イメージは取り直しになります。`credentialStore`は`wslc login`の資格情報の保存先で、既定はWindowsの資格情報マネージャーです。

## プロキシ環境でwslc pullが失敗する原因と回避策

### wslcの設定に無いプロキシ項目とdockerdの起動引数

社内の明示プロキシ（ブラウザやOSにプロキシサーバーを指定しないと外へ出られない構成）では、`wslc pull`がレジストリへの接続でタイムアウトします。原因は2つあります。上の表のとおり`settings.yaml`にプロキシの項目が無いこと。そして、タグ3.0.3のソースではセッション内の`dockerd`を`--containerd`の指定だけで起動しており、`HTTP_PROXY`などの環境変数を渡していないことです。ディストリビューション向けの`.wslconfig`の`autoProxy`も、前述のとおりwslcには効きません。

同じ症状は[Issue #40981「wslc pull behind a corporate proxy」](https://github.com/microsoft/WSL/issues/40981)として2026年7月に報告され、10月23日時点でOpenです。`settings.yaml`に`session.proxy`（`http`・`https`・`noProxy`）を足して`dockerd`へ環境変数として渡すプルリクエスト[#41989](https://github.com/microsoft/WSL/pull/41989)が2026年10月19日（UTC）に出ていますが、10月23日時点でマージされていません。安定版に入るまでは、プロキシの指定方法はありません。

### TLS検査用のルート証明書をVMへ複製する仕組み

一方で、プロキシ側でTLSを復号して検査する製品（社内のルート証明書をPCに配る方式）は、証明書の面では手当てがあります。3.0.3の`WSLCSession.cpp`は、dockerdを起動する前にWindowsの信頼済みルート証明書を集め、VM内の`/etc/ssl/certs/wsl-windows-roots.pem`へ書き込みます。社内ルート証明書がWindowsの証明書ストアに入っていれば、証明書エラーで`pull`が止まることは起きにくい作りです。PCの通信を透過的に引き受けるタイプのプロキシなら、Consomméの経路でそのまま外へ出られる可能性があります。

### プロキシを通せない間のsaveとloadによるイメージの持ち込み

公式の手段で確実に回避するなら、プロキシ設定ができる環境（WSL内のDocker Engineや別のPC）でイメージを取得してtarに書き出し、wslcに読み込みます。

```
# プロキシを設定済みのDocker環境で
docker pull nginx:latest
docker save -o nginx.tar nginx:latest

# wslc側で読み込む
wslc load -i nginx.tar
wslc images
```

Issue #40981には、セッション内のdockerdをプロキシ指定付きで起動し直すコミュニティの手順も投稿されています。セッションが再起動すると元に戻るうえ、Microsoftが案内している方法ではないので、業務端末への展開には使いません。PR #41989がリリースに入った時点で`settings.yaml`に書く方式へ切り替えるのが筋です。

## wslc composeの対応状況と複数コンテナを動かす方法

### 3.0.3に無いcomposeサブコマンドとMicrosoftの開発方針

WSL 3.0.3の`wslc`には`compose`サブコマンドがありません（タグ3.0.3の`RootCommand.cpp`に登録されているのはcontainer・image・network・registry・settings・system・volumeと、各操作の短縮形です）。GA告知は、Composeを最も要望の多い機能とし、次の開発の重点に置くと書いています。目標は、既存の`compose.yaml`を書き換えずに`compose up`で動かすことです。提供時期は示されていません。

### 開発ブランチfeature/composeの実装範囲

microsoft/WSLには`feature/compose`ブランチがあり、2026年10月16日（UTC）のコミット195e5349時点で`wslc compose up`が実装されています。ただし同コミットの[ComposeSpec.cpp](https://github.com/microsoft/WSL/blob/195e53491d256ae554db6c2617fbb9066f968bed/src/windows/wslcsession/ComposeSpec.cpp)がサービスに書けるキーを次の8つに限っており、それ以外のキーが1つでもあるとファイル全体がエラーになります。

| 区分      | キー                                            |
| ------- | --------------------------------------------- |
| 使える     | `name`・`container_name`・`image`・`environment` |
| 使える     | `working_dir`・`command`・`volumes`・`ports`     |
| 使えない（例） | `build`・`depends_on`・`healthcheck`・`networks` |

`image`は必須なので、`build:`でその場でイメージを作る構成は書けません。`depends_on`で起動順を制御しているWeb＋DBの構成もそのままでは通りません。正式版での対応範囲はまだ確定していないため、手元の`compose.yaml`がこの8キーに収まっているかが、移行を検討できるかどうかの目安になります。Compose自体の役割は[docker-composeとは？複数コンテナをymlで定義し一括管理する仕組みを解説](/tech/details/13282/)を参照してください。

### 複数コンテナを今動かす方法：Docker系の継続か個別のrun

3.0.3で複数のサービスを動かす手段は、`wslc network create`で作ったネットワークに`wslc run --network`で1つずつつなぐ方法です。サービスが2〜3個なら、PowerShellのスクリプトにまとめれば回せます。`compose.yaml`を読んで`wslc`の呼び出しに変換するコミュニティ製のラッパー（[wslc-compose-go](https://github.com/DawnMagnet/wslc-compose-go)など）もありますが、Microsoftのサポート外です。チームの開発環境として`compose.yaml`を共有しているなら、正式対応まではDocker DesktopかWSL内のDocker Engineで動かします。

```
# composeの代わりに、ネットワークを作って個別に起動する
wslc network create app-net
wslc run -d --name db --network app-net -e POSTGRES_PASSWORD=pass postgres:17
wslc run -d --name web --network app-net -p 8000:8000 helloworld-django
```

## C#のMicrosoft.WSL.Containersでアプリからコンテナを起動する手順

### NuGetパッケージの追加とSession・Container・Processの関係

APIは[Microsoft.WSL.Containers](https://www.nuget.org/packages/Microsoft.WSL.Containers)というNuGetパッケージで配布され、2026年10月23日時点の最新は3.0.3です。C#の投影とC++/WinRTのヘッダーが同梱され、C++/WinRT側はプレビュー扱いで破壊的変更があり得ると明記されています。リファレンスは[WSL container API developer reference](https://wsl.dev/api-reference/)にあります。

登場するオブジェクトは4つです。前提コンポーネントを確認する`WslcService`、コンテナを動かすホストでイメージの取得も担う`Session`、Session内に作る`Container`、コンテナ内のLinuxプロセスを表し標準入出力やシグナルを扱う`Process`。流れは「確認 → Session起動 → イメージ取得 → Container作成 → Process操作」です。

### イメージ取得から終了待ちまでのC#コード例とLearnとの型名の違い

Microsoft Learnのスニペットは`ComponentFlags`・`MemoryMB`・`CmdLine`・`DeleteContainerFlags`という名前を使っていますが、タグ3.0.3の[wslcsdk.idl](https://github.com/microsoft/WSL/blob/3.0.3/src/windows/WslcSDK/winrt/wslcsdk.idl)での定義は`Component`・`MemorySizeInMB`・`CommandLine`・`DeleteContainerOption`です。次のコードは、IDLと同じ名前を使う[wsl.devのエンドツーエンド例](https://wsl.dev/api-reference/csharp/end-to-end-example/)を短くしたものです。.NETのコンソールアプリで`dotnet add package Microsoft.WSL.Containers`を実行してから使います。

```
using System.Text;
using Microsoft.WSL.Containers;

// 必要なWSLコンポーネントが揃っているかを先に確認する（3.0.3では Component の一覧が返る）
var missing = WslcService.GetMissingComponents();
if (missing.Count != 0)
{
    Console.WriteLine("WSL components are missing. Run: wsl --install");
    return;
}

// アプリ専用のセッションを、CPU 4・メモリ4GBで起動する
var session = new Session(new SessionSettings("MyApp", @"C:\WslcData")
{
    CpuCount = 4,
    MemorySizeInMB = 4096
});
session.Start();

// イメージを取得する
await session.PullImageAsync(new PullImageOptions("docker.io/library/alpine:latest"));

// コンテナを作る（まだ起動しない）
var container = session.CreateContainer(new ContainerSettings("alpine:latest")
{
    Name = "hello-container",
    InitProcess = new ProcessSettings
    {
        CommandLine = new[] { "/bin/echo", "Hello from WSL Container!" },
        OutputMode = ProcessOutputMode.Event
    }
});

// 起動前に、標準出力と終了のイベントを購読しておく
var exited = new TaskCompletionSource<int>(TaskCreationOptions.RunContinuationsAsynchronously);
container.InitProcess.OutputReceived += data => Console.Write(Encoding.UTF8.GetString(data));
container.InitProcess.Exited += code => exited.TrySetResult(code);
container.Start();

// echo の終了を最大30秒待つ
var completed = await Task.WhenAny(exited.Task, Task.Delay(TimeSpan.FromSeconds(30)));
int exitCode = completed == exited.Task ? exited.Task.Result : -1;
Console.WriteLine($"exit code: {exitCode}");

// 後片付け：動いていれば停止し、削除してセッションを終える
if (container.State == ContainerState.Running)
{
    container.Stop(Signal.SIGTERM, TimeSpan.FromSeconds(10));
}
container.Delete(DeleteContainerOption.None);
session.Terminate();
```

`SessionSettings`の第2引数に指定したフォルダが、アプリ専用のデータ置き場になります。CLIの`settings.yaml`はこのセッションには効かず、資源はコードで指定します。画像変換やPDF処理のようなLinux専用のコマンドラインツールを社内ツールに組み込むとき、利用者にディストリビューションを用意させずに済むのがAPIの利点です。ボリュームやGPUを使う完全な例は[WSL container API samples](https://aka.ms/wslc-samples)にあります。

## Docker互換API・Dev Containers・企業管理の対応範囲

### Docker互換APIの未公開とdocker・Testcontainersからの接続の制約

WSL ContainersはDocker Engine互換のAPIをWindows側へ公開していません。そのため`docker`コマンドや、Testcontainersのように`DOCKER_HOST`でエンジンへつなぐ道具は、wslcのコンテナを操作できません。互換エンドポイントを求める要望は[Issue #40976](https://github.com/microsoft/WSL/issues/40976)として2026年7月に起票され、10月23日時点でOpen、Microsoftのメンバーからの回答は付いていません。結合テストをTestcontainersで回しているプロジェクトは、Docker系のエンジンを残す前提で考えます。

### VS Code Dev ContainersのDocker Path設定と既知の不具合

Dev Containersは別扱いです。プレビュー告知[WSL container is now available for public preview](https://devblogs.microsoft.com/commandline/wsl-container-is-now-available-for-public-preview/)は、拡張機能の0.462.0-pre-releaseでwslcに対応したとし、設定の「Docker Path」を`wslc`に変える手順を示しています。GA告知も、Dev Containersの既定のドライバーとして`wslc`を使えると書いています。

ただし、リポジトリをWSLのファイルシステムに置いてDev Containersを開くとセットアップで止まる不具合が[#11750](https://github.com/microsoft/vscode-remote-release/issues/11750)としてOpenのままです。このIssueには、featuresのビルドで止まる例やマウントの問題など複数の原因が報告されており、同じ構成をWindows側のフォルダで開くと動いたという報告もあります。wslcでDev Containersを試すなら、まずリポジトリをWindows側に置いた構成で確かめます。

### IntuneとDefender for Endpointで企業端末を管理する範囲

GA告知によれば、Microsoft Intuneに「Allow WSL containers access」（機能全体の許可）と「WSL containers registry allow list」（取得を許すレジストリの限定）の設定が加わりました。Microsoft Defender for Endpoint（MDE）は、WSL向けの既存プラグインがコンテナにも対応し、コンテナ内のプロセス・ファイル・ネットワークの活動を可視化します。

イメージの取得元のレジストリを、Intuneで組織として限定できるのが管理面の具体的な機能です。WSL全体の企業向け設定は[Enterprise environment: Set up Windows Subsystem for Linux for your company](https://learn.microsoft.com/en-us/windows/wsl/enterprise)にまとまっています。

## wslcを採用する条件とDocker Desktopを残す場面の判断

### wslcへ寄せてよい開発端末の条件

次のどれかに当てはまれば、wslcを第一候補にします。

- 使うコンテナが1〜2個で、手順書が`docker run`と`docker build`で完結している。
- Windowsアプリや社内ツールにLinuxの処理を組み込みたい。DockerにもEngine APIとSDKはありますが、wslcのAPIなら利用者の端末にDocker Desktopを別途入れてもらう必要がありません。
- Docker Desktopの有償条件に当たる組織で、利用者の大半がComposeを使っていない。[Dockerの規約](https://docs.docker.com/subscription/desktop-license/)では、従業員250人未満かつ年間売上1,000万ドル未満の企業、個人、教育、非商用OSSが無償で、それ以外の業務利用は有償です。費用の試算は[Docker Desktopの導入手順とライセンス境界｜4.89系の要件と無料代替への移行](/tech/details/17442/)で扱っています。

移行は全員を一度に切り替えず、手順書のコマンドを対応表で読み替えて1チームで回してから広げます。コンテナの実行基盤を端末からクラウドへ移す設計や、CI環境の分離まで含めて見直す場合は[インフラ構築（AWS・Google Cloud・Azure）](/service/system/aws/)でご相談を受けています。

### Compose・プロキシ・Testcontainersに依存する環境の移行見送り

反対に、`compose.yaml`で複数サービスを起動している開発環境、明示プロキシの内側にある端末、Testcontainersで結合テストを回しているプロジェクトは、3.0.3の時点では移行しません。今wslcへ移すと手順書とテストを書き換え、Compose対応が入った時点でもう一度やり直すことになります。費用を避けたいなら、WSLのディストリビューション内にDocker Engineを入れる構成が現実的です。デーモンを持たない別系統としては[Podmanとdockerの違いは？デーモンレス・rootlessの仕組みと移行判断](/tech/details/13202/)も比較対象になります。

LinuxのCIランナーは対象外です。WSL ContainersはWindows上の機能なので、Linuxのランナーには関係しません。WindowsのランナーでGitHub Actionsを回す場合は、ランナーイメージのWSLの版次第なので、`wslc version`が通るかを確かめてから判断します。AIエージェントの隔離の基盤としてwslcを使う例は[Microsoft Execution Containers（MXC）](/tech/details/12384/)の記事で扱っています。

## よくある質問

### WSL Containersを使うのにDocker Desktopは必要ですか？

不要です。`wslc.exe`はWSLに組み込まれており、`wsl --update`でWSLを2.9.3以上（2026年10月23日時点の安定版は3.0.3）にすれば、Docker Desktopの無い端末でもLinuxコンテナを起動できます。イメージはDocker Hubなどのレジストリから取得できます。

### wslcでdocker composeは使えますか？

WSL 3.0.3では使えません。Microsoftは一般提供の告知でComposeを次の開発の重点に挙げており、開発ブランチには`wslc compose up`がありますが、使えるキーは8種類で`build`や`depends_on`は書けません。`compose.yaml`で複数のコンテナを動かしている場合は、Docker DesktopかWSL内のDocker Engineを当面残してください。

### wslcでプロキシを設定するにはどうすればよいですか？

3.0.3には設定方法がありません。`settings.yaml`にプロキシの項目が無く、`.wslconfig`の`autoProxy`もwslcには効きません。`session.proxy`を足すプルリクエスト#41989はマージ前です。それまでは、プロキシを通せるDocker環境で`docker save`したtarを`wslc load -i`で読み込むのが確実な回避策です。

### Dockerfileはそのままwslcでビルドできますか？

できます。`wslc build`は`Dockerfile`と`Containerfile`のどちらの名前でも読み込み、中身もDockerと同じ命令で書けます。両方のファイルが同じフォルダにあるとエラーになるので、その場合は`-f Dockerfile`のように指定します。

### WSL 3.0とWSL Containersはどういう関係ですか？

3.0はWSLアプリの版番号で、WSL Containersが一般提供になったのが3.0.1（2026年9月29日）です。WSL 1・WSL 2に続く新しい方式という意味ではなく、ディストリビューションは従来どおりWSL 2の仕組みで動きます。WSL Containersはその上に追加されたコンテナ専用の機能です。

## 関連記事

- [コンテナとは？仮想マシンとの違いからDocker・企業の導入判断まで解説](/column/details/13000/)
- [containerdとは？Dockerとの関係・runc/CRIの仕組みとKubernetesでの役割を解説](/tech/details/15681/)
- [Kata Containersとは？軽量VMで隔離するセキュアコンテナの仕組みとgVisor・runc比較・導入判断](/tech/details/15693/)
- [Docker VMMとは？WSL 2・Apple Virtualizationとの違いと切り替え手順](/tech/details/16896/)
- [Hyper-Vの有効化と仮想マシン作成手順｜PowerShell操作とWSL2との併存](/tech/details/17468/)

---

出典: [WSL Containers（wslc）の使い方｜Compose・プロキシの対応状況とDocker Desktopとの使い分け【WSL 3.0.3時点】](<https://www.issoh.co.jp/tech/details/18105/>)（株式会社一創）
