在腾讯云 Windows Server 2022 上安装 Docker,主要有两种主流方式:使用官方推荐的 Docker Desktop(适合开发测试)和 使用 Docker CE (Community Edition) for Windows(适合生产环境,依赖 WSL2 或 Hyper-V)。
考虑到 Windows Server 2022 的特性,以下是详细的操作步骤:
⚠️ 前置条件检查
在开始之前,请确保你的云服务器满足以下条件:
- 系统版本:必须是 Windows Server 2022 Standard 或 Datacenter 版。
- 虚拟化支持:在腾讯云控制台实例详情中,确认已开启 虚拟化功能(VT-x/AMD-V),且实例规格支持嵌套虚拟化(通常大多数通用型实例默认开启,若不确定可尝试安装后报错再排查)。
- 网络环境:服务器需能访问网络以下载镜像和更新源。
- 内存建议:Docker 运行需要一定内存,建议至少 4GB 以上。
方法一:安装 Docker Desktop(推荐用于开发/测试)
这是最简单的方式,由 Docker 官方提供,自动处理了底层配置(如 WSL2 后端),但注意:Docker Desktop 的免费许可证主要面向个人开发者、小型团队(少于 250 人且年收入低于 1000 万美元)及教育用途。如果是企业大规模生产部署,建议使用方法二。
步骤 1:下载并安装
- 访问 Docker Desktop 官网。
- 点击 Download for Windows。
- 下载完成后,双击安装包
Docker Desktop Installer.exe进行安装。- 在安装向导中,确保勾选 "Use WSL 2 instead of Hyper-V"(如果可用),这通常性能更好。
- 勾选 "Allow non-admin users to use Docker"(可选,视权限需求而定)。
- 安装完成后重启电脑。
步骤 2:验证安装
打开 PowerShell(管理员模式),输入以下命令:
docker --version
docker run hello-world
如果看到 "Hello from Docker!" 字样,说明安装成功。
注意:如果在腾讯云 Windows Server 上使用 Docker Desktop,可能会遇到“无法启动”或"WSL2 不支持”的问题。这是因为部分云厂商的虚拟化层与 WSL2 存在兼容性问题。如果遇到此情况,请直接使用方法二(Docker CE + Hyper-V)。
方法二:安装 Docker CE for Windows(推荐用于生产环境)
这种方式更轻量,不依赖 Docker Desktop 的图形界面,更适合服务器端部署。它依赖于 Hyper-V 功能。
步骤 1:启用 Hyper-V 功能
Windows Server 默认未开启 Hyper-V,需先启用:
- 打开 PowerShell (管理员)。
- 执行以下命令启用 Hyper-V 及其管理工具:
Install-WindowsFeature -Name Hyper-V -IncludeManagementTools -Restart系统会自动重启,请等待重启完成。
步骤 2:下载 Docker CE MSI 安装包
由于 Docker 官方不再直接提供旧的 MSI 包链接,我们需要通过 GitHub Release 页面获取。
- 访问 Docker CE for Windows 发布页:GitHub Releases – docker-ce-windows。
- 找到最新的稳定版本(例如
v26.x.x)。 - 在 Assets 列表中下载
.msi文件(文件名类似docker-<version>.msi)。- 提示:如果找不到直接的 MSI,也可以下载
docker-desktop的安装程序,但在服务器上通常直接使用docker-ce的 MSI 更纯净。
- 提示:如果找不到直接的 MSI,也可以下载
步骤 3:安装 Docker CE
- 双击下载的
.msi文件开始安装。 - 按照向导操作,接受许可协议。
- 选择安装路径(默认即可)。
- 安装完成后,必须重启服务器以确保 Hyper-V 服务完全加载。
步骤 4:配置国内提速镜像(关键步骤)
由于国内网络限制,拉取 Docker Hub 镜像非常慢甚至失败。你需要配置阿里云或腾讯云的镜像提速器。
-
打开 PowerShell,编辑配置文件
C:ProgramDatadockerconfigdaemon.json。- 如果文件不存在,新建该文件。
-
写入以下内容(以腾讯云镜像为例,其他云同理):
{ "registry-mirrors": [ "https://mirror.ccs.tencentyun.com" ], "log-driver": "json-file", "log-level": "warn" }注意:如果是旧版 Docker,可能需要手动指定
storage-driver。新版通常自动识别。 -
保存文件后,重启 Docker 服务:
Restart-Service docker
步骤 5:验证
再次运行:
docker run hello-world
如果能看到欢迎信息,说明安装成功且网络配置正常。
常见问题排查 (Troubleshooting)
| 问题现象 | 可能原因 | 解决方案 |
|---|---|---|
| Docker 服务启动失败 | Hyper-V 未开启或冲突 | 检查 Get-WindowsOptionalFeature -Online -FeatureName Microsoft-Hyper-V,确保状态为 Enabled。 |
| 无法连接互联网拉取镜像 | DNS 解析问题或防火墙 | 修改腾讯云安全组规则,允许出站流量;或在 daemon.json 中添加 dns 配置(如 ["8.8.8.8"])。 |
| WSL2 报错 | 虚拟化嵌套不支持 | 如果你使用的是 Docker Desktop,尝试切换到 Hyper-V 模式,或直接改用 Docker CE MSI 方案。 |
| 端口映射失败 | 防火墙拦截 | 在 Windows Defender 防火墙中放行 Docker 相关端口,或暂时关闭防火墙测试。 |
总结建议
- 开发/学习:直接安装 Docker Desktop,体验最好。
- 生产环境:推荐使用 Docker CE (MSI) + Hyper-V 模式,配合腾讯云镜像提速器,稳定性更高且资源占用更可控。
安装完成后,你可以通过 docker ps 查看当前运行的容器,并通过 docker pull <镜像名> 拉取所需应用。
CLOUD技术博