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)によれば、この機能はLinuxコンテナをビルド・実行・操作するCLI「wslc.exe」と、Windowsアプリの処理の一部としてLinuxコンテナを使うためのAPIの2つで構成されています。wslc.exeはWSLに同梱され、別名のcontainer.exeでも呼び出せます。
従来、WindowsでLinuxコンテナを動かすには、Docker Desktopを入れるか、UbuntuなどのディストリビューションにDockerのEngineを自分で入れるかのどちらかでした。WSL Containersは実行基盤をWSL側が持つので、ディストリビューションの中でデーモンを管理する作業が要りません。
ユーザー単位のセッションVMで動くcontainerdとdockerd
内部構造はWSLC Architecture deep diveで公開されています。特権を持つWindowsサービスwslservice.exeが仮想マシンを作り、ユーザー権限で動くwslcsession.exeがそのユーザーのセッションを管理します。イメージ・コンテナ・ボリュームはセッションごとのVHDに保存され、wslcの既定のセッションは%LOCALAPPDATA%\wslc\sessionsに置かれます。
VMの中で動くエンジンはDockerと同じ系統です。タグ3.0.3の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のリリースでは、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との違い・仕組み・インストール手順で解説しています。
WSLの更新でwslcを使える状態にする手順
必要なWSLの版2.9.3以上とバージョン確認のコマンド
Get started with WSL containerが示す前提は、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連携・肥大化の対処にまとめています。
hello-worldイメージでのセッション起動の確認
# 初回はイメージの取得とセッションVMの起動が走る
wslc run --rm hello-world
# セッションとエンジンの状態を見る
wslc system info
「Hello」で始まるメッセージが出れば準備完了です。止まる場合は、BIOSで仮想化が無効になっていないかなど、WSL 2そのものが動かない原因から疑います。Hyper-V関連機能の状態はHyper-Vの有効化と仮想マシン作成手順|PowerShell操作とWSL2との併存の確認手順が使えます。
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の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告知では、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ではMicrosoftの担当者が、現時点でwslc.exeをディストリビューションの中から使う形はサポートしておらず、バインドマウントは非常に難しいと説明しています。ディストリビューション内での実行を求める要望はmicrosoft/WSLのIssue #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に明記されています。ディストリビューション用にメモリを絞っていても、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」として2026年7月に報告され、10月23日時点でOpenです。settings.yamlにsession.proxy(http・https・noProxy)を足してdockerdへ環境変数として渡すプルリクエスト#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がサービスに書けるキーを次の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で定義し一括管理する仕組みを解説を参照してください。
複数コンテナを今動かす方法:Docker系の継続か個別のrun
3.0.3で複数のサービスを動かす手段は、wslc network createで作ったネットワークにwslc run --networkで1つずつつなぐ方法です。サービスが2〜3個なら、PowerShellのスクリプトにまとめれば回せます。compose.yamlを読んでwslcの呼び出しに変換するコミュニティ製のラッパー(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というNuGetパッケージで配布され、2026年10月23日時点の最新は3.0.3です。C#の投影とC++/WinRTのヘッダーが同梱され、C++/WinRT側はプレビュー扱いで破壊的変更があり得ると明記されています。リファレンスはWSL container API developer referenceにあります。
登場するオブジェクトは4つです。前提コンポーネントを確認するWslcService、コンテナを動かすホストでイメージの取得も担うSession、Session内に作るContainer、コンテナ内のLinuxプロセスを表し標準入出力やシグナルを扱うProcess。流れは「確認 → Session起動 → イメージ取得 → Container作成 → Process操作」です。
イメージ取得から終了待ちまでのC#コード例とLearnとの型名の違い
Microsoft LearnのスニペットはComponentFlags・MemoryMB・CmdLine・DeleteContainerFlagsという名前を使っていますが、タグ3.0.3のwslcsdk.idlでの定義はComponent・MemorySizeInMB・CommandLine・DeleteContainerOptionです。次のコードは、IDLと同じ名前を使うwsl.devのエンドツーエンド例を短くしたものです。.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にあります。
Docker互換API・Dev Containers・企業管理の対応範囲
Docker互換APIの未公開とdocker・Testcontainersからの接続の制約
WSL ContainersはDocker Engine互換のAPIをWindows側へ公開していません。そのためdockerコマンドや、TestcontainersのようにDOCKER_HOSTでエンジンへつなぐ道具は、wslcのコンテナを操作できません。互換エンドポイントを求める要望はIssue #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は、拡張機能の0.462.0-pre-releaseでwslcに対応したとし、設定の「Docker Path」をwslcに変える手順を示しています。GA告知も、Dev Containersの既定のドライバーとしてwslcを使えると書いています。
ただし、リポジトリをWSLのファイルシステムに置いてDev Containersを開くとセットアップで止まる不具合が#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にまとまっています。
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の規約では、従業員250人未満かつ年間売上1,000万ドル未満の企業、個人、教育、非商用OSSが無償で、それ以外の業務利用は有償です。費用の試算はDocker Desktopの導入手順とライセンス境界|4.89系の要件と無料代替への移行で扱っています。
移行は全員を一度に切り替えず、手順書のコマンドを対応表で読み替えて1チームで回してから広げます。コンテナの実行基盤を端末からクラウドへ移す設計や、CI環境の分離まで含めて見直す場合はインフラ構築(AWS・Google Cloud・Azure)でご相談を受けています。
Compose・プロキシ・Testcontainersに依存する環境の移行見送り
反対に、compose.yamlで複数サービスを起動している開発環境、明示プロキシの内側にある端末、Testcontainersで結合テストを回しているプロジェクトは、3.0.3の時点では移行しません。今wslcへ移すと手順書とテストを書き換え、Compose対応が入った時点でもう一度やり直すことになります。費用を避けたいなら、WSLのディストリビューション内にDocker Engineを入れる構成が現実的です。デーモンを持たない別系統としてはPodmanとdockerの違いは?デーモンレス・rootlessの仕組みと移行判断も比較対象になります。
LinuxのCIランナーは対象外です。WSL ContainersはWindows上の機能なので、Linuxのランナーには関係しません。WindowsのランナーでGitHub Actionsを回す場合は、ランナーイメージのWSLの版次第なので、wslc versionが通るかを確かめてから判断します。AIエージェントの隔離の基盤としてwslcを使う例はMicrosoft Execution Containers(MXC)の記事で扱っています。
よくある質問
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はその上に追加されたコンテナ専用の機能です。