在 Windows Server 2025 上安装 WSL (Windows Subsystem for Linux) 和 Docker 是一个相对直接的过程,但需要注意 WSL 2 是运行 Docker Desktop 的必要前提。由于 Windows Server 的默认环境较为精简,我们需要先启用必要的功能组件。
以下是详细的分步操作指南:
第一步:启用必要的 Windows 功能
在开始之前,需要以管理员身份打开 PowerShell(右键点击“开始”菜单 -> 选择"Windows PowerShell (管理员)"或"Terminal (管理员)")。
依次执行以下命令来启用核心组件:
# 启用 WSL 内核更新和虚拟机平台
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
# 重启计算机以应用更改
Restart-Computer
注意:重启后,请再次以管理员身份打开 PowerShell 继续后续步骤。
第二步:安装并设置 WSL 2
-
安装最新版本的 WSL
在 PowerShell 中运行以下命令,这将自动下载并安装最新的 WSL 内核和默认发行版(通常是 Ubuntu):wsl --install如果系统提示需要先安装
.msix包,它会自动处理。 -
将 WSL 版本设置为 2
虽然wsl --install通常会默认使用 WSL 2,但为了保险起见,可以手动指定:wsl --set-default-version 2 -
启动并配置 Linux 发行版
运行wsl命令启动默认发行版。如果是首次运行,系统会提示你创建一个用户名和密码(这是你的 Linux root 用户凭证,请务必记住)。wsl # 或者明确指定发行版(如 Ubuntu) wsl -d Ubuntu此时你会进入 Linux 终端界面。建议在此处更新软件源并升级工具:
sudo apt update && sudo apt upgrade -y
第三步:安装 Docker Desktop for Windows
Docker Desktop 依赖于 WSL 2 后端。在 Windows Server 上安装时,请注意以下几点:
-
下载安装包
访问 Docker Hub 或 Microsoft Store(如果服务器启用了商店功能),下载Docker Desktop Installer.exe。
注意:确保下载的是支持 Windows Server 的版本(通常社区版 Community Edition 即可)。 -
运行安装程序
双击安装程序,按照向导进行安装。- 关键选项:在安装过程中,确保勾选 "Use WSL 2 instead of Hyper-V"(使用 WSL 2 代替 Hyper-V)。这是最佳实践,能提供更好的性能和兼容性。
-
完成安装并重启
安装完成后,根据提示重启电脑。 -
验证安装
重启后,Docker Desktop 应该会在后台托盘区域运行。打开新的 PowerShell 窗口,输入以下命令检查版本:docker --version wsl -l -v你应该能看到 Docker 版本信息,且 WSL 列表中的状态为
Running且版本为2。
第四步:常见问题与注意事项 (Windows Server 特有)
在 Windows Server 环境中,可能会遇到一些与桌面版 Windows 不同的情况:
- 图形界面依赖:Docker Desktop 的安装程序通常假设你有图形界面(GUI)。如果你使用的是 Server Core(无 GUI 版本),则无法直接安装 Docker Desktop。
- 解决方案:如果你必须使用 Server Core,你需要通过命令行安装 Docker Engine for Windows,而不是 Docker Desktop。但这通常需要配置 WSL 作为后端并手动管理容器,配置较为复杂。建议在生产环境中使用 Linux VM 运行 Docker,或者在带有 GUI 的 Server 2025 上进行开发测试。
- 防火墙设置:安装后,如果无法拉取镜像,请检查 Windows 防火墙是否阻止了 Docker 相关的网络流量。
- WSL 2 内存限制:Docker Desktop 默认可能会占用较多内存。你可以在 WSL 配置文件 (
.wslconfig) 中限制资源。- 在 C 盘用户目录下创建文件
C:Users<你的用户名>.wslconfig。 - 添加以下内容(示例限制为 4GB 内存):
[wsl2] memory=4GB swap=2GB - 保存后,在 PowerShell 中运行
wsl --shutdown使配置生效。
- 在 C 盘用户目录下创建文件
总结验证
最后,运行一个简单的测试容器来确认一切正常:
docker run hello-world
如果看到 "Hello from Docker!" 的消息,说明 WSL 2 和 Docker 已经成功在 Windows Server 2025 上协同工作。
轻量云Cloud