在 Windows 上使用 Docker 进行开发Docker Desktop 几乎是绕不开的选择。然而许多开发者都曾遇到过它带来的困扰启动时提示“virtualization support not detected”安装过程漫长且占用资源商业使用许可的潜在风险以及在某些场景下网络配置的复杂性。如果你也正在寻找一个更轻量、更原生、更可控的 Docker 替代方案那么本文将为你提供一个完整的解决方案。本文将深入实测一种告别 Docker Desktop 的方案在 Windows 上直接使用原生 Linux 容器核心工具是wslc。我们将从原理剖析开始一步步完成环境准备、安装配置、基础操作到项目实战并详细对比其与 Docker Desktop 的优劣。无论你是因许可问题寻求替代还是单纯想追求更高效的开发体验这篇指南都能让你从零开始构建一个稳定可靠的 Windows 原生容器开发环境。1. 背景与核心概念为什么需要替代 Docker Desktop在深入实操之前我们有必要厘清几个关键概念理解我们正在构建的技术栈的来龙去脉。Docker Desktop是一个为 macOS 和 Windows 设计的桌面应用程序它提供了一个完整的 Docker 环境。在 Windows 上它通过两种方式运行容器Windows 容器直接运行 Windows 内核的容器。Linux 容器在轻量级 Hyper-V 虚拟机中运行一个 Linux 内核然后在这个 Linux 环境中运行 Docker 守护进程和容器。对于大多数开发者而言我们使用的是 Linux 容器。Docker Desktop 虽然方便但也引入了一层抽象Hyper-V VM带来了资源开销、启动延迟以及潜在的兼容性问题。WSL 2 (Windows Subsystem for Linux 2)是微软开发的在 Windows 内部运行完整 Linux 内核的兼容层。它与 Windows 深度集成文件系统性能优异且启动速度极快。WSL 2 本身就是一个轻量级的虚拟机但它比 Docker Desktop 使用的 Hyper-V VM 更贴近系统底层。我们的目标方案既然 WSL 2 已经提供了一个优秀的 Linux 内核环境我们能否直接在这个 Linux 环境中安装和运行 Docker 引擎Docker Daemon就像在普通的 Ubuntu 服务器上一样答案是肯定的。wslc正是这一思路下的一个工具集合或实践方案的代表注wslc并非一个官方软件包而常指代 “WSL Linux Containers” 这种技术组合。其核心思想是启用并配置 WSL 2安装一个 Linux 发行版如 Ubuntu。在该 WSL 2 的 Linux 系统中直接安装 Docker 引擎Docker CE。在 Windows 终端中通过配置让 Windows 本地的dockerCLI 命令直接与 WSL 2 中的 Docker 守护进程通信。这样一来我们就实现了“Windows 原生 Linux 容器”容器实际运行在 WSL 2 的 Linux 内核中而我们可以从 Windows 命令行无缝地管理它们完全绕过了 Docker Desktop 这个“中间商”。主要优势资源更轻量去掉了 Docker Desktop 的图形界面和额外的虚拟机管理层。启动更快WSL 2 的启动速度通常快于完整的 Hyper-V VM。避免许可问题对于企业用户直接使用开源的 Docker CE 避免了 Docker Desktop 的订阅许可审查。配置更透明环境是标准的 Linux Docker配置、日志、数据卷都位于 WSL 2 的文件系统中更易于理解和调试。更好的集成文件系统性能尤其是访问 Windows 文件在 WSL 2 中表现卓越。2. 环境准备与版本说明在开始之前请确保你的 Windows 系统满足以下要求。本文以Windows 10 版本 2004 及更高版本或Windows 11为例这是支持 WSL 2 的硬性条件。核心组件与版本操作系统Windows 10 (2004) / Windows 11。WSL 2需要启用并更新至最新版本。Linux 发行版Ubuntu 20.04 LTS 或 22.04 LTS本文使用 Ubuntu 22.04 LTS。Docker Engine最新稳定版 Docker CE。Windows 终端推荐使用 Windows Terminal 以获得最佳命令行体验。重要提示以下步骤涉及系统级更改。建议在操作前对重要数据进行备份。文中所有命令均需在具有管理员权限的终端中执行除非特别说明。3. 完整安装与配置指南接下来我们将分步完成整个环境的搭建。3.1 启用 WSL 2 并安装 Linux 发行版首先我们需要在 Windows 上启用 WSL 功能并安装一个 Linux 发行版。步骤 1以管理员身份打开 PowerShell在开始菜单搜索 “PowerShell”右键选择“以管理员身份运行”。步骤 2启用 WSL 功能执行以下命令。这将会启用“适用于 Linux 的 Windows 子系统”可选功能。dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart步骤 3启用虚拟机平台功能这是 WSL 2 的依赖项。dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart执行完以上两步后必须重启计算机。步骤 4将 WSL 默认版本设置为 2重启后再次以管理员身份打开 PowerShell设置 WSL 2 为默认版本。wsl --set-default-version 2如果看到提示需要更新 WSL 2 内核组件的消息请按照提示的链接下载并安装最新内核更新包。步骤 5安装 Linux 发行版Ubuntu打开 Microsoft Store搜索 “Ubuntu”选择 “Ubuntu 22.04 LTS” 并点击“获取”进行安装。你也可以使用命令行安装wsl --install -d Ubuntu-22.04安装完成后首次启动 Ubuntu 应用系统会提示你创建新的 UNIX 用户名和密码。这个账户将是 WSL 内的管理员sudo用户。步骤 6验证 WSL 2 安装在 PowerShell 中运行以下命令确认 Ubuntu 发行版正在使用 WSL 2。wsl -l -v输出应类似于NAME STATE VERSION * Ubuntu-22.04 Running 2确保VERSION列为2。3.2 在 WSL 2 中安装 Docker Engine现在我们进入 WSL 2 的 Ubuntu 环境安装原生的 Docker CE。步骤 1启动 WSL 2 并更新系统从开始菜单打开 “Ubuntu 22.04 LTS”或者在任何终端如 Windows Terminal中输入wsl命令进入。 进入后首先更新软件包索引sudo apt update sudo apt upgrade -y步骤 2安装 Docker 依赖包安装一些必要的工具让apt可以通过 HTTPS 使用仓库。sudo apt install -y ca-certificates curl gnupg lsb-release步骤 3添加 Docker 官方 GPG 密钥sudo mkdir -p /etc/apt/keyrings curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg步骤 4设置 Docker 稳定版仓库echo \ deb [arch$(dpkg --print-architecture) signed-by/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \ $(lsb_release -cs) stable | sudo tee /etc/apt/sources.list.d/docker.list /dev/null步骤 5安装 Docker Engine再次更新apt包索引并安装 Docker CE、CLI、Containerd 等组件。sudo apt update sudo apt install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin步骤 6启动 Docker 服务并设置开机自启sudo service docker start sudo systemctl enable docker注意WSL 2 中的systemd支持在较新版本中才默认启用。如果上述systemctl enable命令报错可以暂时忽略使用sudo service docker start手动启动即可。你也可以通过修改/etc/wsl.conf来启用systemd非必需进阶操作。步骤 7将当前用户加入 docker 组避免每次使用 sudo为了能在非sudo情况下运行docker命令需要将你的用户加入docker组。sudo usermod -aG docker $USER这个更改需要生效你需要完全退出 WSL 2关闭所有 WSL 终端窗口然后重新打开一个新的 WSL 2 终端。重新登录后运行groups命令确认docker组出现在列表中。步骤 8验证 Docker 安装在 WSL 2 终端中运行docker --version docker run hello-world如果看到 Docker 版本信息和 “Hello from Docker!” 的成功消息恭喜你WSL 2 内部的 Docker 引擎已经安装成功3.3 配置 Windows Docker CLI 连接 WSL 2 引擎目前Docker 只能在 WSL 2 的终端里使用。我们的目标是能在 Windows 的 PowerShell 或 CMD 中也直接使用docker命令。这需要让 Windows 上的 Docker CLI 连接到 WSL 2 内部的 Docker 守护进程。原理通过设置环境变量DOCKER_HOST将 CLI 的请求转发到 WSL 2 中的一个网络端口或 Unix Socket。步骤 1在 WSL 2 中配置 Docker 守护进程监听 TCP 端口可选但推荐默认情况下Docker 守护进程只监听 Unix Socket。为了让 Windows 能够访问我们让它同时监听一个 TCP 端口。 编辑 Docker 守护进程配置文件sudo nano /etc/docker/daemon.json如果文件不存在则创建它。添加以下内容{ “hosts”: [“unix:///var/run/docker.sock”, “tcp://0.0.0.0:2375”] }重要安全警告tcp://0.0.0.0:2375意味着 Docker 守护进程将在所有网络接口上监听 2375 端口且没有 TLS 加密。这仅在安全的本地开发环境如 WSL 2 内部网络中可以接受。切勿在生产环境或暴露的网络上使用此配置保存文件CtrlO然后Enter再CtrlX退出 nano。步骤 2重启 Docker 服务以应用配置sudo service docker restart验证 TCP 端口是否监听sudo netstat -tlnp | grep 2375应该能看到 Docker 进程正在监听0.0.0.0:2375。步骤 3在 Windows 中设置环境变量现在回到 Windows。我们需要设置一个永久的环境变量告诉 Windows 的 Docker CLI 去哪里找 Docker 守护进程。打开“系统属性”右键“此电脑”-“属性”-“高级系统设置”。点击“环境变量”。在“用户变量”或“系统变量”部分点击“新建”。变量名DOCKER_HOST变量值tcp://localhost:2375因为 WSL 2 的网络与 Windows 主机是 NAT 关系WSL 2 的localhost映射到 Windows 的localhost点击“确定”保存所有更改。步骤 4在 Windows 上安装 Docker CLI仅客户端我们不需要完整的 Docker Desktop只需要它的命令行工具。你可以从 Docker 官方 GitHub 发布页下载docker.exe但更简单的方法是使用scoop或chocolatey这类 Windows 包管理器。 以管理员身份打开 PowerShell使用scoop安装scoop install docker或者你也可以从 Docker 官网下载 Docker Desktop 的安装包但在安装时只选择“Docker CLI”组件而不安装 Docker Desktop 引擎和 GUI。步骤 5终极验证关闭所有旧的终端窗口打开一个新的Windows PowerShell或CMD。 运行以下命令docker version docker run --rm hello-world如果docker version能显示 Server (引擎) 和 Client (CLI) 的版本信息并且hello-world容器能成功运行并输出信息那么恭喜你你已经成功配置了 Windows 原生 Linux 容器环境。你现在可以在 Windows 终端中直接管理运行在 WSL 2 里的容器了。4. 核心操作与 Docker Desktop 对比实测环境搭建完成后我们来实测一些日常开发中的核心操作并与 Docker Desktop 进行直观对比。4.1 镜像拉取与容器运行操作拉取一个 Nginx 镜像并运行一个 Web 服务器。 在 Windows PowerShell 中执行# 拉取镜像 docker pull nginx:alpine # 运行容器将容器80端口映射到主机8080端口 docker run -d --name my-nginx -p 8080:80 nginx:alpine # 查看运行中的容器 docker ps体验对比速度镜像拉取和容器启动速度与 Docker Desktop 基本无异因为底层都是 Docker 引擎在工作。命令完全一致没有任何学习成本。结果在浏览器中访问http://localhost:8080可以看到 Nginx 欢迎页。证明网络映射功能正常工作。4.2 文件系统性能测试重点优势这是 WSL 2 方案相比 Docker Desktop 的传统 Hyper-V 模式可能具有优势的地方尤其是在跨系统文件访问时。场景将 Windows 目录挂载到容器中作为数据卷。 在 Windows PowerShell 中# 假设你在 Windows 的 D:\code 目录下有一个项目 # 运行一个容器将 D:\code 挂载到容器的 /app 目录 docker run -it --rm -v D:\code:/app alpine sh # 在容器内的 /app 目录执行 ls 命令应该能看到 Windows 下的文件 # 在容器内创建一个文件 echo “Test from container” /app/test.txt然后回到 Windows打开D:\code\test.txt你会发现文件已经创建成功且内容正确。体验对比Docker Desktop (Hyper-V 模式)文件操作通过 SMB 或 9p 协议进行在大量小文件读写时可能会有性能损耗。WSL 2 方案WSL 2 实现了对 Windows 文件系统 (/mnt/c/,/mnt/d/) 的高性能访问drvfs文件系统。容器挂载这些路径时性能接近于原生 Linux 文件系统对于前端node_modules或编译密集型操作体验可能更流畅。4.3 构建 Docker 镜像操作在 Windows 项目目录中编写 Dockerfile 并构建镜像。在D:\myapp创建一个简单的DockerfileFROM alpine:latest RUN echo “Hello, WSLc!” /greeting.txt CMD cat /greeting.txt在 Windows PowerShell 中切换到该目录并构建cd D:\myapp docker build -t my-wslc-app . docker run --rm my-wslc-app结果成功输出 “Hello, WSLc!”。证明构建功能完全正常构建上下文D:\myapp下的文件能够正确传输给 WSL 2 中的 Docker 守护进程。4.4 使用 Docker ComposeDocker Compose 是开发中的常用工具。我们同样可以在 WSL 2 方案中使用它。步骤 1确保已安装 Docker Compose Plugin我们在安装 Docker CE 时已经通过docker-compose-plugin包安装了 Compose V2。可以通过docker compose version检查。步骤 2创建docker-compose.yml在D:\compose-demo目录下创建文件version: ‘3.8’ services: web: image: nginx:alpine ports: - “80:80” volumes: - ./html:/usr/share/nginx/html db: image: postgres:15-alpine environment: POSTGRES_PASSWORD: secret在同一目录下创建一个html文件夹并在其中放一个index.html文件。步骤 3启动服务在 Windows PowerShell 中cd D:\compose-demo docker compose up -d docker compose ps结果Nginx 和 PostgreSQL 容器成功启动。访问http://localhost可以看到你的网页。所有docker compose命令down,logs,exec等均可正常使用。5. 常见问题与深度排查指南迁移到新环境难免遇到问题。以下是基于实测和社区反馈整理的高频问题及解决方案。5.1 Docker 命令报错 “Cannot connect to the Docker daemon”这是最常见的问题意味着 Docker CLI 无法连接到守护进程。排查步骤检查 WSL 2 中的 Docker 服务打开 WSL 2 终端Ubuntu运行sudo service docker status。确保状态是active (running)。如果不是运行sudo service docker start。检查 TCP 端口监听在 WSL 2 终端运行sudo netstat -tlnp | grep 2375。确认 Docker 正在监听0.0.0.0:2375。如果没有检查/etc/docker/daemon.json配置是否正确并重启服务。检查 Windows 环境变量在 Windows PowerShell 中运行$env:DOCKER_HOST。应该输出tcp://localhost:2375。如果不正确请重新设置用户环境变量并重启终端。检查防火墙临时关闭 Windows Defender 防火墙仅用于测试看是否连接成功。如果成功需要在防火墙中为 WSL 2 或端口 2375 添加入站规则。WSL 2 的 NAT 网络通常不受防火墙影响但某些安全软件可能拦截。尝试使用 Unix Socket 连接替代 TCP 方案如果你不想配置 TCP可以安装docker-ce-cli在 Windows 上并通过一个小的转发工具如npiperelay连接 Unix Socket。但 TCP 方案更简单通用。5.2 WSL 2 启动或运行缓慢可能原因与解决虚拟机内存占用WSL 2 默认会动态分配内存但可能占用过多。在用户目录C:\Users\你的用户名\创建或编辑.wslconfig文件[wsl2] memory4GB # 限制最大内存为 4GB processors4 # 限制使用的 CPU 核心数 localhostForwardingtrue保存后在 PowerShell 中运行wsl --shutdown关闭 WSL再重新启动。杀毒软件实时扫描将 WSL 2 的虚拟硬盘文件通常位于%LOCALAPPDATA%\Packages\...或整个 WSL 目录添加到杀毒软件的排除列表。文件系统操作慢避免在/mnt/c/等 Windows 挂载点下进行大量小文件操作如npm install。建议将项目放在 WSL 2 的原生文件系统内如~/project。5.3 容器无法访问外部网络或端口映射失败排查检查 WSL 2 网络在 WSL 2 终端运行curl ifconfig.me看是否能获取公网 IP确认 WSL 2 本身有网络。检查端口占用在 Windows 上使用netstat -ano | findstr :8080检查你映射的端口如 8080是否已被其他程序占用。检查 Docker 网络模式确保容器使用默认的bridge网络。运行docker network ls查看。重置 WSL 2 网络有时 WSL 2 的网络会卡住。在 PowerShell 中以管理员运行wsl --shutdown netsh winsock reset netsh int ip reset all netsh winhttp reset proxy ipconfig /flushdns重启电脑后重试。5.4 如何完全卸载 Docker Desktop 和此方案如果你想回退或清理环境卸载 Docker Desktop通过 Windows 设置的应用与功能正常卸载。移除 WSL 2 中的 Docker在 WSL 2 终端运行sudo apt-get purge docker-ce docker-ce-cli containerd.io docker-compose-plugin sudo rm -rf /var/lib/docker sudo rm -rf /var/lib/containerd移除 Windows Docker CLI通过scoop uninstall docker或控制面板卸载。删除 Windows 环境变量删除之前创建的DOCKER_HOST环境变量。可选卸载 WSL 2 发行版wsl --unregister Ubuntu-22.04。6. 最佳实践与工程建议将 WSL 2 作为 Docker 主机用于开发遵循一些最佳实践可以让体验更顺畅。6.1 文件路径管理策略项目位置对于需要频繁进行文件 IO 操作的项目如 Node.js、Go强烈建议将代码放在 WSL 2 的 Linux 原生文件系统内例如~/projects/。这能获得最佳性能。数据持久化对于数据库数据等需要持久化的内容建议使用 Docker 命名卷Named Volume或绑定挂载到 WSL 2 的 Linux 路径而不是 Windows 路径。IDE 集成使用 VS Code 的 “Remote - WSL” 扩展可以直接在 WSL 2 环境中打开项目文件夹获得完美的编辑、调试和终端体验。6.2 配置优化.wslconfig调优如前所述合理配置内存和 CPU 限制避免 WSL 2 占用过多主机资源。Docker Daemon 配置除了hosts你还可以在/etc/docker/daemon.json中配置镜像加速器国内用户必备、日志驱动、存储驱动等。{ “registry-mirrors”: [“https://registry.docker-cn.com”], “log-driver”: “json-file”, “log-opts”: { “max-size”: “10m”, “max-file”: “3” } }别名简化命令在 WSL 2 的~/.bashrc或 Windows PowerShell 的$PROFILE中设置别名例如# WSL2 .bashrc alias dps‘docker ps --format “table {{.ID}}\t{{.Names}}\t{{.Status}}\t{{.Ports}}”’# PowerShell $PROFILE function dps { docker ps --format “table {{.ID}}t{{.Names}}t{{.Status}}t{{.Ports}}” }6.3 安全考量TCP 端口暴露我们配置的tcp://0.0.0.0:2375仅适用于本地开发机。确保你的电脑防火墙已启用且未将 2375 端口暴露给公网。对于需要更高安全性的场景可以考虑配置 Docker TLS 认证但这会显著增加复杂度。用户权限在 WSL 2 中将用户加入docker组是方便的但这意味着该用户拥有了等同于root的权限因为 Docker 守护进程以 root 运行。请确保你的 WSL 2 用户账户安全。6.4 与 CI/CD 流程的兼容性由于此方案使用的是标准的 Docker CE其行为与 Linux 服务器上的 Docker 完全一致。因此在本地编写的Dockerfile和docker-compose.yml文件可以无缝地用于 CI/CD 流水线如 Jenkins、GitLab CI、GitHub Actions不存在因 Docker Desktop 特定行为导致的差异问题。7. 总结是否应该告别 Docker Desktop经过完整的实测我们可以对 “WSL 2 Docker CE” 方案做出一个清晰的总结。适合采用此方案的情况追求极致轻量与性能希望开发环境占用资源更少启动更快。企业合规要求需要规避 Docker Desktop 的商业使用许可条款。Linux 原生开发体验希望开发环境更接近生产环境Linux 服务器。高级用户与定制化需要对 Docker 守护进程有更深入的控制和配置。文件系统操作频繁项目涉及大量跨系统文件读写WSL 2 的drvfs性能可能更优。可能仍需保留 Docker Desktop 的情况新手用户Docker Desktop 提供了一体化的图形界面GUI用于管理镜像、容器、卷和网络对初学者更友好。需要同时运行 Windows 容器Docker Desktop 可以方便地在 Linux 容器和 Windows 容器模式间切换。依赖特定 Docker Desktop 功能如 Kubernetes 集群一键启用、漏洞扫描、扩展市场等。不愿进行复杂配置希望开箱即用避免手动设置环境变量、TCP 连接等。最终建议 对于大多数以 Linux 容器为主要开发目标的中级及以上开发者和团队迁移到 WSL 2 原生 Docker 方案是利大于弊的。它提供了更纯净、更可控、且与生产环境一致性更高的开发体验。本文提供的步骤已经将配置过程标准化按照指南操作半小时内即可完成切换。你可以先在备用机器或虚拟机上尝试此方案熟悉整个流程后再迁移主力开发机。一旦切换成功你会发现一个更简洁高效的 Docker 世界真正实现 “Windows 原生 Linux 容器” 的开发自由。 Windows原生Linux容器开发：WSL2+Docker CE替代Docker Desktop实战指南
在 Windows 上使用 Docker 进行开发Docker Desktop 几乎是绕不开的选择。然而许多开发者都曾遇到过它带来的困扰启动时提示“virtualization support not detected”安装过程漫长且占用资源商业使用许可的潜在风险以及在某些场景下网络配置的复杂性。如果你也正在寻找一个更轻量、更原生、更可控的 Docker 替代方案那么本文将为你提供一个完整的解决方案。本文将深入实测一种告别 Docker Desktop 的方案在 Windows 上直接使用原生 Linux 容器核心工具是wslc。我们将从原理剖析开始一步步完成环境准备、安装配置、基础操作到项目实战并详细对比其与 Docker Desktop 的优劣。无论你是因许可问题寻求替代还是单纯想追求更高效的开发体验这篇指南都能让你从零开始构建一个稳定可靠的 Windows 原生容器开发环境。1. 背景与核心概念为什么需要替代 Docker Desktop在深入实操之前我们有必要厘清几个关键概念理解我们正在构建的技术栈的来龙去脉。Docker Desktop是一个为 macOS 和 Windows 设计的桌面应用程序它提供了一个完整的 Docker 环境。在 Windows 上它通过两种方式运行容器Windows 容器直接运行 Windows 内核的容器。Linux 容器在轻量级 Hyper-V 虚拟机中运行一个 Linux 内核然后在这个 Linux 环境中运行 Docker 守护进程和容器。对于大多数开发者而言我们使用的是 Linux 容器。Docker Desktop 虽然方便但也引入了一层抽象Hyper-V VM带来了资源开销、启动延迟以及潜在的兼容性问题。WSL 2 (Windows Subsystem for Linux 2)是微软开发的在 Windows 内部运行完整 Linux 内核的兼容层。它与 Windows 深度集成文件系统性能优异且启动速度极快。WSL 2 本身就是一个轻量级的虚拟机但它比 Docker Desktop 使用的 Hyper-V VM 更贴近系统底层。我们的目标方案既然 WSL 2 已经提供了一个优秀的 Linux 内核环境我们能否直接在这个 Linux 环境中安装和运行 Docker 引擎Docker Daemon就像在普通的 Ubuntu 服务器上一样答案是肯定的。wslc正是这一思路下的一个工具集合或实践方案的代表注wslc并非一个官方软件包而常指代 “WSL Linux Containers” 这种技术组合。其核心思想是启用并配置 WSL 2安装一个 Linux 发行版如 Ubuntu。在该 WSL 2 的 Linux 系统中直接安装 Docker 引擎Docker CE。在 Windows 终端中通过配置让 Windows 本地的dockerCLI 命令直接与 WSL 2 中的 Docker 守护进程通信。这样一来我们就实现了“Windows 原生 Linux 容器”容器实际运行在 WSL 2 的 Linux 内核中而我们可以从 Windows 命令行无缝地管理它们完全绕过了 Docker Desktop 这个“中间商”。主要优势资源更轻量去掉了 Docker Desktop 的图形界面和额外的虚拟机管理层。启动更快WSL 2 的启动速度通常快于完整的 Hyper-V VM。避免许可问题对于企业用户直接使用开源的 Docker CE 避免了 Docker Desktop 的订阅许可审查。配置更透明环境是标准的 Linux Docker配置、日志、数据卷都位于 WSL 2 的文件系统中更易于理解和调试。更好的集成文件系统性能尤其是访问 Windows 文件在 WSL 2 中表现卓越。2. 环境准备与版本说明在开始之前请确保你的 Windows 系统满足以下要求。本文以Windows 10 版本 2004 及更高版本或Windows 11为例这是支持 WSL 2 的硬性条件。核心组件与版本操作系统Windows 10 (2004) / Windows 11。WSL 2需要启用并更新至最新版本。Linux 发行版Ubuntu 20.04 LTS 或 22.04 LTS本文使用 Ubuntu 22.04 LTS。Docker Engine最新稳定版 Docker CE。Windows 终端推荐使用 Windows Terminal 以获得最佳命令行体验。重要提示以下步骤涉及系统级更改。建议在操作前对重要数据进行备份。文中所有命令均需在具有管理员权限的终端中执行除非特别说明。3. 完整安装与配置指南接下来我们将分步完成整个环境的搭建。3.1 启用 WSL 2 并安装 Linux 发行版首先我们需要在 Windows 上启用 WSL 功能并安装一个 Linux 发行版。步骤 1以管理员身份打开 PowerShell在开始菜单搜索 “PowerShell”右键选择“以管理员身份运行”。步骤 2启用 WSL 功能执行以下命令。这将会启用“适用于 Linux 的 Windows 子系统”可选功能。dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart步骤 3启用虚拟机平台功能这是 WSL 2 的依赖项。dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart执行完以上两步后必须重启计算机。步骤 4将 WSL 默认版本设置为 2重启后再次以管理员身份打开 PowerShell设置 WSL 2 为默认版本。wsl --set-default-version 2如果看到提示需要更新 WSL 2 内核组件的消息请按照提示的链接下载并安装最新内核更新包。步骤 5安装 Linux 发行版Ubuntu打开 Microsoft Store搜索 “Ubuntu”选择 “Ubuntu 22.04 LTS” 并点击“获取”进行安装。你也可以使用命令行安装wsl --install -d Ubuntu-22.04安装完成后首次启动 Ubuntu 应用系统会提示你创建新的 UNIX 用户名和密码。这个账户将是 WSL 内的管理员sudo用户。步骤 6验证 WSL 2 安装在 PowerShell 中运行以下命令确认 Ubuntu 发行版正在使用 WSL 2。wsl -l -v输出应类似于NAME STATE VERSION * Ubuntu-22.04 Running 2确保VERSION列为2。3.2 在 WSL 2 中安装 Docker Engine现在我们进入 WSL 2 的 Ubuntu 环境安装原生的 Docker CE。步骤 1启动 WSL 2 并更新系统从开始菜单打开 “Ubuntu 22.04 LTS”或者在任何终端如 Windows Terminal中输入wsl命令进入。 进入后首先更新软件包索引sudo apt update sudo apt upgrade -y步骤 2安装 Docker 依赖包安装一些必要的工具让apt可以通过 HTTPS 使用仓库。sudo apt install -y ca-certificates curl gnupg lsb-release步骤 3添加 Docker 官方 GPG 密钥sudo mkdir -p /etc/apt/keyrings curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg步骤 4设置 Docker 稳定版仓库echo \ deb [arch$(dpkg --print-architecture) signed-by/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \ $(lsb_release -cs) stable | sudo tee /etc/apt/sources.list.d/docker.list /dev/null步骤 5安装 Docker Engine再次更新apt包索引并安装 Docker CE、CLI、Containerd 等组件。sudo apt update sudo apt install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin步骤 6启动 Docker 服务并设置开机自启sudo service docker start sudo systemctl enable docker注意WSL 2 中的systemd支持在较新版本中才默认启用。如果上述systemctl enable命令报错可以暂时忽略使用sudo service docker start手动启动即可。你也可以通过修改/etc/wsl.conf来启用systemd非必需进阶操作。步骤 7将当前用户加入 docker 组避免每次使用 sudo为了能在非sudo情况下运行docker命令需要将你的用户加入docker组。sudo usermod -aG docker $USER这个更改需要生效你需要完全退出 WSL 2关闭所有 WSL 终端窗口然后重新打开一个新的 WSL 2 终端。重新登录后运行groups命令确认docker组出现在列表中。步骤 8验证 Docker 安装在 WSL 2 终端中运行docker --version docker run hello-world如果看到 Docker 版本信息和 “Hello from Docker!” 的成功消息恭喜你WSL 2 内部的 Docker 引擎已经安装成功3.3 配置 Windows Docker CLI 连接 WSL 2 引擎目前Docker 只能在 WSL 2 的终端里使用。我们的目标是能在 Windows 的 PowerShell 或 CMD 中也直接使用docker命令。这需要让 Windows 上的 Docker CLI 连接到 WSL 2 内部的 Docker 守护进程。原理通过设置环境变量DOCKER_HOST将 CLI 的请求转发到 WSL 2 中的一个网络端口或 Unix Socket。步骤 1在 WSL 2 中配置 Docker 守护进程监听 TCP 端口可选但推荐默认情况下Docker 守护进程只监听 Unix Socket。为了让 Windows 能够访问我们让它同时监听一个 TCP 端口。 编辑 Docker 守护进程配置文件sudo nano /etc/docker/daemon.json如果文件不存在则创建它。添加以下内容{ “hosts”: [“unix:///var/run/docker.sock”, “tcp://0.0.0.0:2375”] }重要安全警告tcp://0.0.0.0:2375意味着 Docker 守护进程将在所有网络接口上监听 2375 端口且没有 TLS 加密。这仅在安全的本地开发环境如 WSL 2 内部网络中可以接受。切勿在生产环境或暴露的网络上使用此配置保存文件CtrlO然后Enter再CtrlX退出 nano。步骤 2重启 Docker 服务以应用配置sudo service docker restart验证 TCP 端口是否监听sudo netstat -tlnp | grep 2375应该能看到 Docker 进程正在监听0.0.0.0:2375。步骤 3在 Windows 中设置环境变量现在回到 Windows。我们需要设置一个永久的环境变量告诉 Windows 的 Docker CLI 去哪里找 Docker 守护进程。打开“系统属性”右键“此电脑”-“属性”-“高级系统设置”。点击“环境变量”。在“用户变量”或“系统变量”部分点击“新建”。变量名DOCKER_HOST变量值tcp://localhost:2375因为 WSL 2 的网络与 Windows 主机是 NAT 关系WSL 2 的localhost映射到 Windows 的localhost点击“确定”保存所有更改。步骤 4在 Windows 上安装 Docker CLI仅客户端我们不需要完整的 Docker Desktop只需要它的命令行工具。你可以从 Docker 官方 GitHub 发布页下载docker.exe但更简单的方法是使用scoop或chocolatey这类 Windows 包管理器。 以管理员身份打开 PowerShell使用scoop安装scoop install docker或者你也可以从 Docker 官网下载 Docker Desktop 的安装包但在安装时只选择“Docker CLI”组件而不安装 Docker Desktop 引擎和 GUI。步骤 5终极验证关闭所有旧的终端窗口打开一个新的Windows PowerShell或CMD。 运行以下命令docker version docker run --rm hello-world如果docker version能显示 Server (引擎) 和 Client (CLI) 的版本信息并且hello-world容器能成功运行并输出信息那么恭喜你你已经成功配置了 Windows 原生 Linux 容器环境。你现在可以在 Windows 终端中直接管理运行在 WSL 2 里的容器了。4. 核心操作与 Docker Desktop 对比实测环境搭建完成后我们来实测一些日常开发中的核心操作并与 Docker Desktop 进行直观对比。4.1 镜像拉取与容器运行操作拉取一个 Nginx 镜像并运行一个 Web 服务器。 在 Windows PowerShell 中执行# 拉取镜像 docker pull nginx:alpine # 运行容器将容器80端口映射到主机8080端口 docker run -d --name my-nginx -p 8080:80 nginx:alpine # 查看运行中的容器 docker ps体验对比速度镜像拉取和容器启动速度与 Docker Desktop 基本无异因为底层都是 Docker 引擎在工作。命令完全一致没有任何学习成本。结果在浏览器中访问http://localhost:8080可以看到 Nginx 欢迎页。证明网络映射功能正常工作。4.2 文件系统性能测试重点优势这是 WSL 2 方案相比 Docker Desktop 的传统 Hyper-V 模式可能具有优势的地方尤其是在跨系统文件访问时。场景将 Windows 目录挂载到容器中作为数据卷。 在 Windows PowerShell 中# 假设你在 Windows 的 D:\code 目录下有一个项目 # 运行一个容器将 D:\code 挂载到容器的 /app 目录 docker run -it --rm -v D:\code:/app alpine sh # 在容器内的 /app 目录执行 ls 命令应该能看到 Windows 下的文件 # 在容器内创建一个文件 echo “Test from container” /app/test.txt然后回到 Windows打开D:\code\test.txt你会发现文件已经创建成功且内容正确。体验对比Docker Desktop (Hyper-V 模式)文件操作通过 SMB 或 9p 协议进行在大量小文件读写时可能会有性能损耗。WSL 2 方案WSL 2 实现了对 Windows 文件系统 (/mnt/c/,/mnt/d/) 的高性能访问drvfs文件系统。容器挂载这些路径时性能接近于原生 Linux 文件系统对于前端node_modules或编译密集型操作体验可能更流畅。4.3 构建 Docker 镜像操作在 Windows 项目目录中编写 Dockerfile 并构建镜像。在D:\myapp创建一个简单的DockerfileFROM alpine:latest RUN echo “Hello, WSLc!” /greeting.txt CMD cat /greeting.txt在 Windows PowerShell 中切换到该目录并构建cd D:\myapp docker build -t my-wslc-app . docker run --rm my-wslc-app结果成功输出 “Hello, WSLc!”。证明构建功能完全正常构建上下文D:\myapp下的文件能够正确传输给 WSL 2 中的 Docker 守护进程。4.4 使用 Docker ComposeDocker Compose 是开发中的常用工具。我们同样可以在 WSL 2 方案中使用它。步骤 1确保已安装 Docker Compose Plugin我们在安装 Docker CE 时已经通过docker-compose-plugin包安装了 Compose V2。可以通过docker compose version检查。步骤 2创建docker-compose.yml在D:\compose-demo目录下创建文件version: ‘3.8’ services: web: image: nginx:alpine ports: - “80:80” volumes: - ./html:/usr/share/nginx/html db: image: postgres:15-alpine environment: POSTGRES_PASSWORD: secret在同一目录下创建一个html文件夹并在其中放一个index.html文件。步骤 3启动服务在 Windows PowerShell 中cd D:\compose-demo docker compose up -d docker compose ps结果Nginx 和 PostgreSQL 容器成功启动。访问http://localhost可以看到你的网页。所有docker compose命令down,logs,exec等均可正常使用。5. 常见问题与深度排查指南迁移到新环境难免遇到问题。以下是基于实测和社区反馈整理的高频问题及解决方案。5.1 Docker 命令报错 “Cannot connect to the Docker daemon”这是最常见的问题意味着 Docker CLI 无法连接到守护进程。排查步骤检查 WSL 2 中的 Docker 服务打开 WSL 2 终端Ubuntu运行sudo service docker status。确保状态是active (running)。如果不是运行sudo service docker start。检查 TCP 端口监听在 WSL 2 终端运行sudo netstat -tlnp | grep 2375。确认 Docker 正在监听0.0.0.0:2375。如果没有检查/etc/docker/daemon.json配置是否正确并重启服务。检查 Windows 环境变量在 Windows PowerShell 中运行$env:DOCKER_HOST。应该输出tcp://localhost:2375。如果不正确请重新设置用户环境变量并重启终端。检查防火墙临时关闭 Windows Defender 防火墙仅用于测试看是否连接成功。如果成功需要在防火墙中为 WSL 2 或端口 2375 添加入站规则。WSL 2 的 NAT 网络通常不受防火墙影响但某些安全软件可能拦截。尝试使用 Unix Socket 连接替代 TCP 方案如果你不想配置 TCP可以安装docker-ce-cli在 Windows 上并通过一个小的转发工具如npiperelay连接 Unix Socket。但 TCP 方案更简单通用。5.2 WSL 2 启动或运行缓慢可能原因与解决虚拟机内存占用WSL 2 默认会动态分配内存但可能占用过多。在用户目录C:\Users\你的用户名\创建或编辑.wslconfig文件[wsl2] memory4GB # 限制最大内存为 4GB processors4 # 限制使用的 CPU 核心数 localhostForwardingtrue保存后在 PowerShell 中运行wsl --shutdown关闭 WSL再重新启动。杀毒软件实时扫描将 WSL 2 的虚拟硬盘文件通常位于%LOCALAPPDATA%\Packages\...或整个 WSL 目录添加到杀毒软件的排除列表。文件系统操作慢避免在/mnt/c/等 Windows 挂载点下进行大量小文件操作如npm install。建议将项目放在 WSL 2 的原生文件系统内如~/project。5.3 容器无法访问外部网络或端口映射失败排查检查 WSL 2 网络在 WSL 2 终端运行curl ifconfig.me看是否能获取公网 IP确认 WSL 2 本身有网络。检查端口占用在 Windows 上使用netstat -ano | findstr :8080检查你映射的端口如 8080是否已被其他程序占用。检查 Docker 网络模式确保容器使用默认的bridge网络。运行docker network ls查看。重置 WSL 2 网络有时 WSL 2 的网络会卡住。在 PowerShell 中以管理员运行wsl --shutdown netsh winsock reset netsh int ip reset all netsh winhttp reset proxy ipconfig /flushdns重启电脑后重试。5.4 如何完全卸载 Docker Desktop 和此方案如果你想回退或清理环境卸载 Docker Desktop通过 Windows 设置的应用与功能正常卸载。移除 WSL 2 中的 Docker在 WSL 2 终端运行sudo apt-get purge docker-ce docker-ce-cli containerd.io docker-compose-plugin sudo rm -rf /var/lib/docker sudo rm -rf /var/lib/containerd移除 Windows Docker CLI通过scoop uninstall docker或控制面板卸载。删除 Windows 环境变量删除之前创建的DOCKER_HOST环境变量。可选卸载 WSL 2 发行版wsl --unregister Ubuntu-22.04。6. 最佳实践与工程建议将 WSL 2 作为 Docker 主机用于开发遵循一些最佳实践可以让体验更顺畅。6.1 文件路径管理策略项目位置对于需要频繁进行文件 IO 操作的项目如 Node.js、Go强烈建议将代码放在 WSL 2 的 Linux 原生文件系统内例如~/projects/。这能获得最佳性能。数据持久化对于数据库数据等需要持久化的内容建议使用 Docker 命名卷Named Volume或绑定挂载到 WSL 2 的 Linux 路径而不是 Windows 路径。IDE 集成使用 VS Code 的 “Remote - WSL” 扩展可以直接在 WSL 2 环境中打开项目文件夹获得完美的编辑、调试和终端体验。6.2 配置优化.wslconfig调优如前所述合理配置内存和 CPU 限制避免 WSL 2 占用过多主机资源。Docker Daemon 配置除了hosts你还可以在/etc/docker/daemon.json中配置镜像加速器国内用户必备、日志驱动、存储驱动等。{ “registry-mirrors”: [“https://registry.docker-cn.com”], “log-driver”: “json-file”, “log-opts”: { “max-size”: “10m”, “max-file”: “3” } }别名简化命令在 WSL 2 的~/.bashrc或 Windows PowerShell 的$PROFILE中设置别名例如# WSL2 .bashrc alias dps‘docker ps --format “table {{.ID}}\t{{.Names}}\t{{.Status}}\t{{.Ports}}”’# PowerShell $PROFILE function dps { docker ps --format “table {{.ID}}t{{.Names}}t{{.Status}}t{{.Ports}}” }6.3 安全考量TCP 端口暴露我们配置的tcp://0.0.0.0:2375仅适用于本地开发机。确保你的电脑防火墙已启用且未将 2375 端口暴露给公网。对于需要更高安全性的场景可以考虑配置 Docker TLS 认证但这会显著增加复杂度。用户权限在 WSL 2 中将用户加入docker组是方便的但这意味着该用户拥有了等同于root的权限因为 Docker 守护进程以 root 运行。请确保你的 WSL 2 用户账户安全。6.4 与 CI/CD 流程的兼容性由于此方案使用的是标准的 Docker CE其行为与 Linux 服务器上的 Docker 完全一致。因此在本地编写的Dockerfile和docker-compose.yml文件可以无缝地用于 CI/CD 流水线如 Jenkins、GitLab CI、GitHub Actions不存在因 Docker Desktop 特定行为导致的差异问题。7. 总结是否应该告别 Docker Desktop经过完整的实测我们可以对 “WSL 2 Docker CE” 方案做出一个清晰的总结。适合采用此方案的情况追求极致轻量与性能希望开发环境占用资源更少启动更快。企业合规要求需要规避 Docker Desktop 的商业使用许可条款。Linux 原生开发体验希望开发环境更接近生产环境Linux 服务器。高级用户与定制化需要对 Docker 守护进程有更深入的控制和配置。文件系统操作频繁项目涉及大量跨系统文件读写WSL 2 的drvfs性能可能更优。可能仍需保留 Docker Desktop 的情况新手用户Docker Desktop 提供了一体化的图形界面GUI用于管理镜像、容器、卷和网络对初学者更友好。需要同时运行 Windows 容器Docker Desktop 可以方便地在 Linux 容器和 Windows 容器模式间切换。依赖特定 Docker Desktop 功能如 Kubernetes 集群一键启用、漏洞扫描、扩展市场等。不愿进行复杂配置希望开箱即用避免手动设置环境变量、TCP 连接等。最终建议 对于大多数以 Linux 容器为主要开发目标的中级及以上开发者和团队迁移到 WSL 2 原生 Docker 方案是利大于弊的。它提供了更纯净、更可控、且与生产环境一致性更高的开发体验。本文提供的步骤已经将配置过程标准化按照指南操作半小时内即可完成切换。你可以先在备用机器或虚拟机上尝试此方案熟悉整个流程后再迁移主力开发机。一旦切换成功你会发现一个更简洁高效的 Docker 世界真正实现 “Windows 原生 Linux 容器” 的开发自由。