在 Windows Server 2025 Datacenter 上安装 Docker,目前主要推荐使用 Docker Desktop for Windows(适用于开发/测试)或 Docker Engine(Server 版)(适用于生产环境)。
由于 Windows Server 2025 是较新的版本,其核心机制与 Windows 10/11 类似,但作为服务器系统,通常建议采用更轻量、无 GUI 依赖的 Docker Engine (Linux Containers) 模式,或者使用 WSL 2 后端。
以下是两种主流的安装方案及详细步骤:
⚠️ 前置条件检查(必须执行)
无论选择哪种方案,Windows Server 2025 必须满足以下基础要求:
-
操作系统版本:确保已安装最新的累积更新(Cumulative Updates)。
-
虚拟化支持:
- 进入 BIOS/UEFI 设置,开启 Intel VT-x 或 AMD-V。
- 在 Windows 中确认 Hyper-V 功能已启用。
-
容器支持功能:
打开 PowerShell(管理员),运行以下命令启用必要的功能:Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Hyper-V -All Enable-WindowsOptionalFeature -Online -FeatureName Containers-DisposableClientVM -All注意:如果提示需要重启,请等待重启完成后再继续。
-
网络配置:
- 如果是生产环境,建议将默认网卡设置为静态 IP,并关闭不必要的防火墙规则以允许 Docker 流量(或配置特定的端口映射)。
方案一:使用 Docker Desktop for Windows(推荐用于开发/测试)
这是最简便的方法,适合需要图形界面管理、快速构建镜像的场景。Docker Desktop 会自动处理 WSL 2 后端的配置。
步骤 1:下载安装包
访问 Docker 官方发布页面,下载适用于 Windows Server 的 Docker Desktop 安装包(通常为 .msi 格式)。
- 链接地址:https://www.docker.com/products/docker-desktop/
- 注意:选择 "Download for Windows",如果是 Server 版,可能需要确认版本兼容性(通常最新版支持 Server 2022/2025)。
步骤 2:安装
双击下载的 .msi 文件进行安装。
- 在安装向导中,确保勾选 "Use WSL 2 instead of Hyper-V"(如果使用 WSL 2 后端,性能更好且资源占用更合理)。
- 按照提示完成安装,最后会提示重启计算机。
步骤 3:启动与验证
重启后,从开始菜单启动 Docker Desktop。
- 首次启动时,它会初始化 WSL 2 发行版。
- 等待托盘图标变为绿色(表示正在运行)。
- 打开 PowerShell,输入以下命令验证:
docker --version docker run hello-world如果看到
Hello from Docker!字样,则安装成功。
方案二:使用 Docker Engine(推荐用于生产环境/无头模式)
如果你不需要图形界面,或者需要在纯命令行环境下运行高可用集群,建议使用原生的 Docker Engine。这通常涉及安装 Linux 容器运行时(因为 Windows Server 2025 原生更倾向于通过 WSL 2 或 Hyper-V 运行 Linux 容器,或者直接运行 Windows 容器)。
重要说明:在 Windows Server 上,Docker Engine 有两种模式:
- Windows Containers:直接运行 Windows 镜像。
- Linux Containers:通过 WSL 2 或 Hyper-V 隔离层运行 Linux 镜像(生产环境主流做法)。
以下演示安装 Docker Engine for Windows(支持混合模式):
步骤 1:下载 MSI 安装包
前往 Docker Hub 或 GitHub Release 页面下载 docker-ce 的 Windows MSI 安装包。
- 路径参考:https://download.docker.com/win/stable/
- 文件名示例:
docker-26.x.x.msi(版本号可能随时间变化)。
步骤 2:安装
- 右键以管理员身份运行 MSI 安装程序。
- 接受许可协议。
- 关键步骤:在安装类型选择页,根据你的需求选择:
- 如果需要运行 Linux 容器:务必勾选 "Run as a Windows service" 和 "Install containerd"。
- 如果需要同时支持 Windows 容器,保持默认即可。
- 点击 Install 并完成安装。
步骤 3:配置守护进程(可选但推荐)
为了优化性能或指定存储路径,可以修改配置文件 C:ProgramDataDockerconfigdaemon.json。例如,指定镜像存储位置:
{
"storage-driver": "windowsfilter",
"data-root": "D:\DockerData"
}
(注:Windows 容器默认使用 windowsfilter,Linux 容器使用 npipe 或 vhd)
步骤 4:启动服务并验证
# 启动 Docker 服务
Start-Service Docker
# 验证版本
docker --version
# 运行 Hello World (注意:这里默认拉取的是 Linux 镜像还是 Windows 镜像取决于你的配置)
docker run hello-world
如果报错 Get-ChildItem : The system cannot find the path specified,可能是 WSL 2 未正确配置。此时建议先运行 wsl --update 和 wsl --install 来确保底层环境正常。
常见问题排查
-
WSL 2 错误:
如果在运行 Linux 容器时报错,通常是因为 WSL 2 内核未更新。
解决:运行wsl --update然后wsl --shutdown。 -
权限问题:
如果非管理员用户无法运行 Docker,需将该用户加入docker-users组(Docker Desktop 安装时自动创建),或使用Set-GroupMembership添加。 -
Windows Server 2025 特异性:
由于 2025 是最新预览版或正式版初期,如果遇到特定组件缺失,建议优先更新 Windows Update 到最新版本,因为 Docker 高度依赖底层的 .NET 框架和 Hyper-V 组件。
总结建议
- 开发/测试环境:直接使用 Docker Desktop,体验最好,配置最简单。
- 生产环境:
- 如果业务基于 Linux:强烈建议在 Windows Server 2025 上部署 Hyper-V 隔离的 Linux 容器(通过 Docker Engine + WSL 2 后端),或者考虑直接在服务器上安装 Windows Subsystem for Linux (WSL 2) 并在其中运行 Docker,以获得最佳兼容性和性能。
- 如果业务基于 Windows:直接安装 Docker Engine 并使用 Windows 容器模式。
安装完成后,请务必配置好防火墙规则(开放 TCP 2375/2376 端口如需远程连接)以及镜像仓库的提速X_X(国内环境通常需要配置阿里云或腾讯云提速器)。
CLOUD云计算