前言
以前想在 Windows 上跑 Linux 容器,绕不开两件事:装 Docker Desktop 或 Podman Desktop,再忍受命令那股卡顿。
这两者做法差不多:各自开一个专用的 WSL 子系统,在子系统里跑 Linux 版的容器引擎,再把里面的命令接到 Windows 上。你敲一条命令,得绕「Windows 客户端 → 中转 → 子系统里的引擎」这么一圈,一来一回,用着就不跟手。
后来微软自己下场了。从 WSL 3.0.1 开始,WSL 内置了容器命令行 wslc.exe,也就是 WSL Containers(简称 WSLC)。它直接复用 WSL 平台,不用为容器单独开子系统,也没有那层第三方中转。不装 Docker Desktop,不装额外的虚拟化软件,wslc run 就能在 Windows 11 上跑 Linux 容器,命令明显更跟手。
我试下来的第一反应是:大部分命令,把 docker 改成 wslc 就能跑。
一、WSLC 是什么,什么时候发布的
它是什么
WSLC(WSL Containers)是 WSL 的新特性,不是单独一个软件。它包含两部分:
| 组件 | 说明 |
|---|---|
| WSL 容器 CLI | wslc.exe,内置在 WSL 里的命令行工具,用来构建、运行、管理 Linux 容器。另有一个别名 container.exe,执行同样的命令 |
| WSL 容器 API | NuGet 包 Microsoft.WSL.Containers(提供 C#、C++/WinRT 投影),让原生 Windows 应用能以编程方式拉取、运行 Linux 容器,并与容器交互 |
微软这次是把容器能力直接做进了 WSL。
底层还是 WSL 2 的 Linux 内核,容器直接跑在上面。不用为容器单独开虚拟机或发行版,也没有 Docker 那种常驻守护进程。
什么时候发布的
- 2026 年 6 月:在 Build 2026 大会上官宣
- 2026 年 7 月:发布公测版(Public Preview)
- 2026 年 9 月 29 日:正式发布(GA),随 WSL 3.0.1 推送到稳定通道
随 WSL 3.0.1 一起更新的还有几处:
- 内核换到 Linux 6.18
- 默认启用 virtiofs,Windows 文件访问速度翻倍
- 新增
consomme网络模式,Linux 流量经 Windows 主机转发,兼容公司代理和企业网络策略 - WSL 的命令行工具、后台服务、容器启动组件和 WSLg 图形堆栈,按 MIT 许可证开源
二、怎么更新
WSLC 是 WSL 的一部分,没有单独的安装包,更新 WSL 就等于更新 WSLC。
前提条件
| 项目 | 要求 |
|---|---|
| 系统 | Windows 11 |
| WSL 版本 | 2.9.3 或更高(GA 版为 WSL 3.0.1) |
更新步骤
打开 PowerShell:
- 更新 WSL 到最新版(顺带装上 wslc)
console
PS C:\Users\xxx> wsl --update
正在检查更新。
正在将适用于 Linux 的 Windows 子系统更新到以下版本: 3.0.1。
[ 0.5% ]
- 确认 WSL 版本
console
PS C:\Users\xxx> wsl --version
WSL 版本: 3.0.1.0
内核版本: 6.18.40.1-1
WSLg 版本: 1.0.79
MSRDC 版本: 1.2.7214
Direct3D 版本: 1.611.1-81528511
DXCore 版本: 10.0.26100.1-240331-1435.ge-release
Windows 版本: 10.0.26300.9457
- 确认 wslc 已就位
console
PS C:\Users\xxx> wslc version
wslc 3.0.1.0
如果 wsl --update 拉不到新版本(公司网络 / 更新通道问题),可以去 GitHub 手动下载安装:
验证是否成功
console
PS C:\Users\xxx> wslc run --rm hello-world
Hello from Docker!
This message shows that your installation appears to be working correctly.
To generate this message, Docker took the following steps:
1. The Docker client contacted the Docker daemon.
2. The Docker daemon pulled the "hello-world" image from the Docker Hub.
(amd64)
3. The Docker daemon created a new container from that image which runs the
executable that produces the output you are currently reading.
4. The Docker daemon streamed that output to the Docker client, which sent it
to your terminal.
To try something more ambitious, you can run an Ubuntu container with:
$ docker run -it ubuntu bash
Share images, automate workflows, and more with a free Docker ID:
https://hub.docker.com/
For more examples and ideas, visit:
https://docs.docker.com/get-started/
看到 "Hello" 之类的输出,就说明装好了。
敲
wslc报命令不存在,基本都是 WSL 版本太老。先wsl --version看一眼,通常低于 2.9.3,更新一下就好。
三、怎么使用
wslc 的命令是照着 Docker 的用法做的,挑几条常用的看看。
1. 跑一个容器
跑一个用完即弃的容器(执行完自动删除):
console
PS C:\Users\xxx> wslc run --rm -it ubuntu:latest bash -c "echo Hello world from WSL container!"
Hello world from WSL container!
看看容器里是哪个发行版:
console
PS C:\Users\xxx> wslc run --rm -it ubuntu:latest bash -c "cat /etc/os-release"
PRETTY_NAME="Ubuntu 26.04.1 LTS"
NAME="Ubuntu"
VERSION_ID="26.04"
VERSION="26.04.1 LTS (Resolute Raccoon)"
VERSION_CODENAME=resolute
ID=ubuntu
ID_LIKE=debian
HOME_URL="https://www.ubuntu.com/"
SUPPORT_URL="https://help.ubuntu.com/"
BUG_REPORT_URL="https://bugs.launchpad.net/ubuntu/"
PRIVACY_POLICY_URL="https://www.ubuntu.com/legal/terms-and-policies/privacy-policy"
UBUNTU_CODENAME=resolute
LOGO=ubuntu-logo
2. 查看容器
console
PS C:\Users\xxx> wslc ps
容器 ID 映像 命令 已创建 状态 端口 名称
dcba0d2c41ac ubuntu:latest "bash -c cat /etc/os..." 12 小时前 Up 12 hours fierce_dinaric
wslc ps和wslc list等价;想看所有容器(含已停止)用wslc container list --all。
3. 看看有哪些命令
命令大体跟 Docker 一致,也有几个自己的。先看全貌:
console
PS C:\Users\xxx> wslc --help
版权所有 (c) Microsoft Corporation。保留所有权利。
有关此产品的隐私信息,请访问 https://aka.ms/privacy。
WSLC 是适用于 Linux 的 Windows 子系统容器 CLI 工具。它通过命令行实现与 WSL 容器的管理和交互。
使用情况: wslc [全局选项] [<命令>] [选项]
命令:
container 管理容器。
image 管理映像。
network 管理网络。
registry 管理注册表凭据。
settings 在默认编辑器中打开设置文件。
system 系统级命令
volume 管理卷。
attach 附加到容器。
build 从 Dockerfile 生成映像。
create 创建容器。
exec 在正在运行的容器中执行命令。
events 监视容器事件。
export 将容器的文件系统导出为 tar 存档。
images 列出映像。
import 从 tarball 导入图像。
info 显示系统信息。
inspect 检查对象。
kill 终止一个或多个正在运行的容器。
list 列出容器。
load 加载映像。
login 登录到注册表。
logout 从注册表注销。
logs 查看容器日志。
pull 拉取映像。
push 将映像上传到注册表。
remove 移除容器。
restart 重新启动容器。
rmi 移除图像。
run 运行容器。
save 保存图像。
start 启动容器。
stats 显示容器资源使用统计信息。
stop 停止容器。
tag 标记图像。
version 显示版本信息。
有关特定命令的更多详细信息,请向其传递 help 选项。 [-?]
选项:
-v --version 显示此工具的版本信息
-? --help 显示选定命令的帮助信息
'wslc' 的全局选项:
--session 指定要使用的会话
四、和 Docker 是什么关系
WSLC 是冲着替代 Docker 去的,不是给 Docker 套壳。
| 维度 | Docker Desktop | WSL 容器(wslc) |
|---|---|---|
| 底层引擎 | 独立虚拟机 + dockerd 守护进程 | 直接复用 WSL 2 的 Linux 内核 |
| 安装 | 单独装一大坨(含 GUI、后台服务) | WSL 自带,wsl --update 就能拿到 |
| 后台进程 | 常驻守护进程,吃内存 | 无独立的重量级后台程序 |
| 授权 | 商用需付费 | 免费、开源(MIT) |
| 镜像来源 | Docker Hub / 私有 Registry | 同样从 Docker Hub(docker.io)拉,兼容 OCI 镜像 |
| 构建文件 | Dockerfile | Containerfile(语法与 Dockerfile 相同) |
| GPU | 支持 | 支持 |
| 数据存储位置 | Docker Desktop 设置里改 | 默认会话存储路径可配置 |
现成的 Docker、OCI 镜像不用重打,直接能用------WSLC 默认从 docker.io 拉镜像。它也不用额外开一台 Hyper-V 虚拟机,容器就跑在 WSL 2 内核里。Docker Desktop 不用卸,两者可以共存,一般留一个就行。wslc 本身就是 WSL 的一部分,用的是同一个 Linux 内核和文件系统。
wslc 具体怎么和 WSL 结合的,微软的架构说明讲得很细:https://aka.ms/wslc-architecture。
五、指令兼容怎么样
兼容度挺高,思路就是把 docker 换成 wslc。有几个点要注意。
常用命令对照表
| 操作 | Docker | WSL 容器(wslc) |
|---|---|---|
| 运行容器 | docker run nginx |
wslc run nginx |
| 运行后自动删除 | docker run --rm hello-world |
wslc run --rm hello-world |
| 构建镜像 | docker build -t app . |
wslc build -t app . |
| 拉取镜像 | docker pull nginx |
wslc pull nginx |
| 查看容器 | docker ps |
wslc ps(等价于 wslc list) |
| 查看镜像 | docker images |
wslc images |
| 执行容器命令 | docker exec ... |
wslc exec ... |
| 查看日志 | docker logs ... |
wslc logs ... |
| 停止容器 | docker stop ... |
wslc stop ... |
| 重启容器 | docker restart ... |
wslc container restart ... |
| 复制文件 | docker cp ... |
wslc container cp ... |
| 查看系统信息 | docker info |
wslc system info |
| 实时事件 | docker events |
wslc events |
| 创建网络 | docker network create ... |
wslc network create ... |
| 连接 / 断开网络 | docker network connect/disconnect |
wslc network connect/disconnect |
| 挂载存储 | --mount ... |
--mount ...(支持) |
| 停止超时 | --stop-timeout ... |
--stop-timeout ...(支持,-1 表示无限) |
| 健康检查 | --health-cmd 等 |
支持 Health Check |
| Compose | docker compose |
暂不支持 ❌ |
几个要注意的点
wslc ps可以直接用,和wslc list等价(ps就是别名),只是wslc --help里没列出来。看所有容器(含已停止)用wslc container list --all。- Compose 还没支持,这是目前最大的缺口。微软说下一个重点就是
wslc compose,目标是让wslc compose up直接跑现有compose.yaml,一个字都不用改。 - 镜像地址:Docker Hub 官方镜像直接写
nginx;用国内镜像源要写完整地址,比如docker.m.daocloud.io/library/nginx。
日常的 run / build / pull / exec / logs / stop / ps,改个前缀就能用;Compose 先等一下。
六、小结
WSLC 就是把容器能力做进了 WSL。2026 年 9 月 29 日随 WSL 3.0.1 发布,wsl --update 就能用,命令跟 Docker 基本一一对应,镜像也还是从 Docker Hub 拉。眼下唯一明显缺的是 Compose,官方说在做。
Windows 上跑 Linux 容器,不再非装 Docker 不可了。