在 Windows Server 2025 Datacenter 上安装 Docker 是一个相对直接的过程,但需要注意几个关键的前置条件,因为 Windows Server 的容器支持机制与桌面版 Windows(如 Win10/Win11)略有不同。
以下是完整的安装步骤和注意事项:
核心前置条件
- 启用 Hyper-V 功能:Docker Desktop for Windows 依赖于 Hyper-V 虚拟化技术。
- 使用正确的版本:
- 推荐方式:直接使用官方提供的
Docker Desktop(适用于服务器版本)。 - 替代方式:如果无法使用 GUI 或需要更轻量级方案,可以使用
Docker Engine (Server)模式(通过 MSI 安装包),但这通常用于无头环境。 - 注意:Windows Server 2025 默认可能未开启“容器”相关功能,需先手动开启。
- 推荐方式:直接使用官方提供的
方法一:使用 Docker Desktop(推荐,图形化界面)
这是最通用的方法,适合大多数开发和管理场景。
1. 下载并安装 Docker Desktop
前往 Docker 官网下载 Docker Desktop for Windows。
- 确保下载的是支持 Windows Server 2025 的最新版本(目前 Docker Desktop 4.x 系列通常已支持 Server 2022/2025)。
- 运行安装程序,按照向导完成安装。
2. 启用必要的 Windows 功能
在安装过程中,Docker Desktop 通常会提示你需要重启并启用某些功能。如果自动失败,请手动执行以下 PowerShell 命令(以管理员身份运行):
# 启用 Hyper-V
Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Hyper-V -All -NoRestart
# 启用容器服务 (Container)
Enable-WindowsOptionalFeature -Online -FeatureName Containers -All -NoRestart
# 重启系统以使更改生效
Restart-Computer
注意:重启后,再次尝试启动 Docker Desktop。
3. 配置 Docker Desktop
- 启动 Docker Desktop。
- 首次启动时,它会检查兼容性。
- 进入 Settings (设置) -> General (常规) 或 Resources (资源):
- 确保选择了 WSL 2 backend (基于 WSL 2 的后端),这是性能最好且对 Server 2025 兼容性最好的模式。
- 如果你没有安装 WSL 2,它可能会提示你安装。可以通过 PowerShell 安装:
wsl --install -d Ubuntu # 或者指定特定版本 wsl --set-default-version 2
- 点击 Apply & Restart。
4. 验证安装
打开新的 PowerShell 窗口,输入以下命令:
docker --version
docker run hello-world
如果看到 "Hello from Docker!" 字样,说明安装成功。
方法二:使用 Docker Engine (MSI 安装,无 GUI)
如果你是在一个纯命令行环境(Headless Server)或者不需要 Docker Desktop 的图形界面,可以使用传统的 MSI 安装包。
- 下载:访问 Docker 官网获取
Docker-CE-Stable-x86_64.msi(注意:Server 版本通常称为 Docker Engine)。- 注:对于 Server 2025,建议优先确认 Docker 官方文档是否提供了针对该版本的独立 MSI,或者沿用 Server 2022 的 MSI 包(通常兼容)。
- 安装:双击 MSI 文件进行安装。
- 配置:安装完成后,Docker 服务会自动启动。
- 验证:同样使用
docker --version和docker run hello-world验证。
常见问题与排查 (Troubleshooting)
如果在 Windows Server 2025 上遇到以下问题,请按对应方案处理:
-
问题:Docker Desktop 无法启动,提示"Hyper-V is not enabled"
- 解决:确保在 BIOS/UEFI 中开启了 CPU 的虚拟化技术(Intel VT-x 或 AMD-V)。然后在 PowerShell 中以管理员身份运行
bcdedit /set hypervisorlaunchtype auto,然后重启服务器。
- 解决:确保在 BIOS/UEFI 中开启了 CPU 的虚拟化技术(Intel VT-x 或 AMD-V)。然后在 PowerShell 中以管理员身份运行
-
问题:WSL 2 后端报错
- 解决:Windows Server 2025 对 WSL 的支持非常完善,但有时内核更新滞后。请运行
wsl --update更新 WSL 内核,并确保安装了 Linux 发行版(如 Ubuntu)。
- 解决:Windows Server 2025 对 WSL 的支持非常完善,但有时内核更新滞后。请运行
-
问题:网络不通
- 解决:检查防火墙设置。Docker 创建虚拟交换机后,可能需要允许
docker0网段通过防火墙。通常 Docker 会自动配置,但如果企业有严格的防火墙策略,可能需要手动放行。
- 解决:检查防火墙设置。Docker 创建虚拟交换机后,可能需要允许
-
关于 Windows Server 2025 的特殊性
- Windows Server 2025 是较新的操作系统,部分旧版 Docker 组件可能尚未完全适配。如果遇到严重的兼容性问题,建议检查 Docker 官方博客或 GitHub 仓库,查看是否有针对 Server 2025 的补丁或特定版本要求。
总结
对于 Windows Server 2025 Datacenter:
- 首选 Docker Desktop + WSL 2 架构,这是最稳定且易于维护的方案。
- 务必确保 Hyper-V 和 Containers 功能已启用。
- 确保 BIOS 中的虚拟化功能已开启。
- 安装完成后,务必运行
docker run hello-world进行最终验证。
云知识CLOUD