在 Windows Server 2025 上安装 WSL (Windows Subsystem for Linux) 和 Docker 是一个相对直接的过程,但需要注意版本兼容性和启用特定的功能。Windows Server 2025 目前处于预览/早期发布阶段(具体取决于你使用的构建版本),因此建议优先使用最新的官方镜像和工具。
以下是完整的分步操作指南:
前置要求
- 操作系统版本:确保你的 Windows Server 2025 是最新构建版本(Build 26xxx 或更高),旧版本可能缺少必要的内核组件。
- 虚拟化支持:在 BIOS/UEFI 中必须开启 Intel VT-x / AMD-V 虚拟化技术。
- 管理员权限:所有命令需要在 PowerShell (管理员) 或 CMD (管理员) 中运行。
第一步:启用 WSL 及所需功能
WSL 需要启用几个特定的 Windows 功能。请打开 PowerShell (以管理员身份运行),依次执行以下命令:
# 启用 WSL 核心功能
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
# 启用虚拟机平台 (Docker Desktop 依赖此功能)
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
# 重启系统以使更改生效
Restart-Computer
注意:如果提示某些功能已启用,可以忽略该错误继续。
第二步:安装并配置 WSL 发行版
重启后,再次打开 PowerShell (管理员),执行以下命令下载并安装默认的 Linux 发行版(推荐 Ubuntu,因为它对 Docker 支持最好):
wsl --install -d Ubuntu
或者手动指定版本:
wsl --list --offline
wsl --install -d Ubuntu-24.04 # 根据可用列表选择
执行后,系统会自动下载并安装。完成后,再次重启计算机。
首次启动时,你会看到一个终端窗口,要求你设置 Linux 用户名 和 密码(注意:输入密码时不会显示字符)。
第三步:安装 Docker Desktop
在 Windows Server 上,最推荐的方式是使用 Docker Desktop,它集成了 WSL 2 后端,管理更加便捷。
-
下载:
- 访问 Docker Hub 或 Docker 官网 下载
Docker Desktop安装包。 - 注意:由于 Server 2025 较新,如果官方商店未更新,请尝试下载适用于 Windows 的通用
.msi安装包。
- 访问 Docker Hub 或 Docker 官网 下载
-
安装:
- 运行下载的
.msi文件。 - 在安装向导中,务必勾选 "Use WSL 2 instead of Hyper-V"(使用 WSL 2 替代 Hyper-V)。这是关键步骤,因为 Docker Desktop 在 Server 上通过 WSL 2 运行效率最高且兼容性更好。
- 运行下载的
-
启动与验证:
- 安装完成后启动 Docker Desktop。
- 等待右下角托盘图标变为绿色鲸鱼标志。
- 打开新的 PowerShell 窗口,运行以下命令验证:
docker --version wsl --status - 如果
docker命令成功返回版本号,且wsl --status显示当前发行版为 "Running" 且模式为 "WSL 2",则安装成功。
第四步:常见问题与优化 (针对 Server 环境)
1. 内存限制调整
Windows Server 默认分配给 WSL 的内存可能较少。如果运行大型容器报错 Out of memory,可以创建一个配置文件来限制或增加资源。
在 %USERPROFILE%.wslconfig 文件中添加以下内容(如果不存在则新建):
[wsl2]
memory=8GB
swap=2GB
processors=4
修改后需执行 wsl --shutdown 重启 WSL 服务。
2. 网络模式
如果在 Server 上部署生产环境,Docker 的网络模式通常默认为 nat。如果需要更灵活的网络配置,可以在 Docker Desktop 的设置中调整 Network 选项,或者直接使用 WSL 2 的原生网络接口进行桥接。
3. 命令行替代方案 (仅 CLI)
如果你不需要 Docker Desktop 的图形界面,只想在 Server 上通过命令行轻量级运行 Docker,可以直接在 WSL 内部安装 Docker Engine:
- 进入 WSL (
ubuntu)。 - 按照 Ubuntu 官方文档安装 Docker Engine:
curl -fsSL https://get.docker.com -o get-docker.sh sudo sh get-docker.sh sudo usermod -aG docker $USER - 退出 WSL,在 Windows 终端中即可直接调用
docker命令(前提是安装了 Docker Desktop 作为后端,或者配置了 Docker CLI 连接到 WSL 内的守护进程)。
总结
对于 Windows Server 2025,最佳实践路径是:
- 启用
Microsoft-Windows-Subsystem-Linux和VirtualMachinePlatform。 - 安装 Ubuntu 作为 WSL 发行版。
- 安装 Docker Desktop 并强制使用 WSL 2 后端。
这种方式利用了 Windows Server 2025 的内核优势,同时享受了 Docker Desktop 带来的现代化开发体验和管理便利。
CLOUD云枢