在 Windows Server 2022 上安装 Docker,核心步骤是启用 Windows 容器功能(因为 Docker Desktop for Windows 主要面向桌面版系统,服务器版通常推荐使用 Docker Engine)。
以下是完整的安装流程,分为准备环境、安装引擎、安装 Compose 和验证四个阶段。
⚠️ 重要前置说明
- 操作系统版本:请确保您的 Windows Server 2022 已安装最新的更新补丁。
- 容器类型:Docker 在 Windows 上有两种模式:Linux 容器(默认,推荐)和 Windows 容器。以下步骤默认安装 Linux 容器引擎。如果您需要运行纯 Windows 镜像,请在安装时选择
--type=windows。 - 权限要求:所有操作需以 管理员身份 运行 PowerShell。
第一步:启用必要的 Windows 功能
Docker 依赖于 Hyper-V 或容器功能。对于 Server 2022,最稳定且轻量化的方式是启用“容器”功能。
打开 PowerShell (管理员),依次执行以下命令:
# 1. 启用容器功能
Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Hyper-V-All -NoRestart
# 2. 如果提示需要重启,或者为了保险起见,先重启一次服务器
Restart-Computer
(注:如果您的环境已经启用了 Hyper-V,这一步可能显示已启用,直接跳过即可)
第二步:下载并安装 Docker Engine
由于 Windows Server 没有像 Docker Desktop 那样的一键安装包,我们需要通过官方提供的 MSI 安装程序进行安装。
-
下载 MSI 安装包:
- 访问微软官方 Docker Hub 页面或 GitHub Release 页。
- 下载地址示例:Docker Engine MSI for Windows
- 找到最新版本的
.msi文件(例如docker-24.x.x-x.msi),下载到服务器本地。
-
静默安装:
下载完成后,在 PowerShell 中进入下载目录,运行以下命令进行安装(这将自动安装 Docker Engine 和 Docker CLI):# 请将路径替换为您实际下载的 .msi 文件名 msiexec /i "C:Downloadsdocker-24.x.x-x.msi" /qn参数说明:
/qn表示完全静默安装,无界面交互。 -
配置环境变量:
安装程序通常会自动将 Docker 添加到系统 PATH 中。如果没有,请手动添加C:Program FilesDocker到系统环境变量Path中。
第三步:安装 Docker Compose
Docker Compose 通常作为独立工具安装,或者包含在 Docker Engine 的安装包中(取决于版本)。在较新的 Server 2022 环境中,建议单独安装二进制文件以确保兼容性。
-
下载 Docker Compose 二进制文件:
前往 Docker Compose GitHub Releases 下载适用于 Windows 的docker-compose-windows-x86_64.exe。 -
放置文件:
将下载的 exe 文件重命名为docker-compose.exe,并移动到 Docker 的二进制目录,例如:
C:Program FilesDockerbindocker-compose.exe
(如果该目录不存在,可以手动创建) -
验证安装:
重启 PowerShell(使环境变量生效),输入以下命令检查版本:docker-compose --version
第四步:启动服务与验证
-
启动 Docker 服务:
在 Server 2022 上,Docker 通常作为 Windows 服务运行。Start-Service Docker如果服务未自动注册,可能需要手动注册(视具体 MSI 版本而定):
# 尝试注册服务(如果之前没成功) C:Program FilesDockerbindockerd.exe --register-service Start-Service Docker -
运行测试容器:
运行一个最简单的 Hello World 镜像来验证一切正常:docker run hello-world如果看到欢迎信息,说明 Docker Engine 安装成功。
-
验证 Compose:
创建一个简单的docker-compose.yml文件测试 Compose:version: '3' services: test: image: nginx:alpine ports: - "8080:80"保存为
compose-test.yml后运行:docker-compose -f compose-test.yml up -d如果容器状态变为
Up,则安装完成。
常见问题排查
- 错误:无法连接到 Docker daemon
- 检查服务状态:
Get-Service Docker。如果状态不是Running,尝试Start-Service Docker。 - 检查日志:查看
Event Viewer(事件查看器) ->Applications and Services Logs->Docker。
- 检查服务状态:
- 网络问题
- Windows Server 的防火墙可能会阻止 Docker 通信。如果容器无法联网,请暂时关闭防火墙测试,或在防火墙中添加允许规则。
- 内存不足
- 确保服务器分配了足够的内存给 Hyper-V 和 Docker。Docker 会占用宿主机资源,建议在虚拟机设置中预留至少 4GB-8GB 内存。
至此,您的 Windows Server 2022 已成功部署 Docker 和 Docker Compose 环境。
云知道CLOUD