在 Windows 上安装 Docker Desktop
Docker Desktop 条款
对于员工人数超过 250 人或年收入超过 1000 万美元的大型企业,商业使用 Docker Desktop 需要 付费订阅。
本页提供 Docker Desktop 在 Windows 上的下载链接、系统要求和分步安装说明。
有关校验和,请参阅版本说明
系统要求
提示
我应该使用 Hyper-V 还是 WSL?
Docker Desktop 在 WSL 和 Hyper-V 上的功能保持一致,无需偏好任何一种架构。Hyper-V 和 WSL 各有优劣,具体取决于您的特定设置和计划的使用场景。
- WSL 版本 1.1.3.0 或更高版本。
- Windows 11 64 位:Home 或 Pro 22H2 版或更高版本,或 Enterprise 或 Education 22H2 版或更高版本。
- Windows 10 64 位:最低要求为 Home 或 Pro 22H2(构建 19045)或更高版本,或 Enterprise 或 Education 22H2(构建 19045)或更高版本。
- 在 Windows 上启用 WSL 2 功能。有关详细说明,请参阅Microsoft 文档。
- 在 Windows 10 或 Windows 11 上成功运行 WSL 2 需要满足以下硬件先决条件
- 支持二级地址转换 (SLAT) 的 64 位处理器
- 4GB 系统内存
- 在 BIOS/UEFI 中启用硬件虚拟化。有关更多信息,请参阅虚拟化。
有关使用 Docker Desktop 设置 WSL 2 的更多信息,请参阅WSL。
注意
Docker Desktop 仅支持仍在 Microsoft 服务时间线 内的 Windows 版本。Docker Desktop 不支持 Windows Server 版本,例如 Windows Server 2019 或 Windows Server 2022。有关如何在 Windows Server 上运行容器的更多信息,请参阅 Microsoft 官方文档。
重要提示
要运行 Windows 容器,您需要 Windows 10 或 Windows 11 的 Professional 或 Enterprise 版本。Windows Home 或 Education 版本仅允许您运行 Linux 容器。
Windows 11 64 位:Enterprise、Pro 或 Education 22H2 版或更高版本。
Windows 10 64 位:Enterprise、Pro 或 Education 22H2(构建 19045)或更高版本。
开启 Hyper-V 和容器 Windows 功能。
在 Windows 10 上成功运行 Client Hyper-V 需要满足以下硬件先决条件
- 支持二级地址转换 (SLAT) 的 64 位处理器
- 4GB 系统内存
- 在 BIOS/UEFI 设置中开启 BIOS/UEFI 级别的硬件虚拟化支持。有关更多信息,请参阅虚拟化。
注意
Docker Desktop 仅支持仍在 Microsoft 服务时间线 内的 Windows 版本。Docker Desktop 不支持 Windows Server 版本,例如 Windows Server 2019 或 Windows Server 2022。有关如何在 Windows Server 上运行容器的更多信息,请参阅 Microsoft 官方文档。
重要提示
要运行 Windows 容器,您需要 Windows 10 或 Windows 11 的 Professional 或 Enterprise 版本。Windows Home 或 Education 版本仅允许您运行 Linux 容器。
- WSL 版本 1.1.3.0 或更高版本。
- Windows 11 64 位:Home 或 Pro 22H2 版或更高版本,或 Enterprise 或 Education 22H2 版或更高版本。
- Windows 10 64 位:最低要求为 Home 或 Pro 22H2(构建 19045)或更高版本,或 Enterprise 或 Education 22H2(构建 19045)或更高版本。
- 在 Windows 上启用 WSL 2 功能。有关详细说明,请参阅Microsoft 文档。
- 在 Windows 10 或 Windows 11 上成功运行 WSL 2 需要满足以下硬件先决条件
- 支持二级地址转换 (SLAT) 的 64 位处理器
- 4GB 系统内存
- 在 BIOS/UEFI 中启用硬件虚拟化。有关更多信息,请参阅虚拟化。
重要提示
不支持 Windows 容器。
使用 Docker Desktop 创建的容器和镜像可在安装它的机器上的所有用户帐户之间共享。这是因为所有 Windows 帐户都使用相同的虚拟机来构建和运行容器。请注意,使用 Docker Desktop 的 WSL 2 后端时,无法在用户帐户之间共享容器和镜像。
Docker Business 客户支持在 VMware ESXi 或 Azure VM 内运行 Docker Desktop。这首先需要在 hypervisor 上启用嵌套虚拟化。有关更多信息,请参阅在虚拟机或 VDI 环境中运行 Docker Desktop。
在 Windows 上安装 Docker Desktop
提示
请参阅常见问题解答,了解如何在无需管理员权限的情况下安装和运行 Docker Desktop。
交互式安装
使用页面顶部的下载按钮或从发行说明下载安装程序。
双击
Docker Desktop Installer.exe
运行安装程序。默认情况下,Docker Desktop 安装在C:\Program Files\Docker\Docker
。当出现提示时,根据您选择的后端,确保选中或取消选中配置页面上的使用 WSL 2 而非 Hyper-V选项。
在仅支持一种后端的系统上,Docker Desktop 会自动选择可用的选项。
按照安装向导上的说明授权安装程序并继续安装。
安装成功后,选择关闭完成安装过程。
如果您的管理员帐户与用户帐户不同,您必须将该用户添加到 docker-users 组
- 以管理员身份运行 计算机管理。
- 导航到 本地用户和组 > 组 > docker-users。
- 右键单击将用户添加到组中。
- 退出并重新登录以使更改生效。
从命令行安装
下载Docker Desktop Installer.exe
后,在终端中运行以下命令来安装 Docker Desktop
$ "Docker Desktop Installer.exe" install
如果您使用 PowerShell,应运行
Start-Process 'Docker Desktop Installer.exe' -Wait install
如果使用 Windows 命令提示符
start /w "" "Docker Desktop Installer.exe" install
默认情况下,Docker Desktop 安装在C:\Program Files\Docker\Docker
。
安装程序标志
注意
如果您使用 PowerShell,需要在任何标志之前使用
ArgumentList
参数。例如Start-Process 'Docker Desktop Installer.exe' -Wait -ArgumentList 'install', '--accept-license'
如果您的管理员帐户与用户帐户不同,您必须将该用户添加到 docker-users 组
$ net localgroup docker-users <user> /add
install
命令接受以下标志
安装行为
--quiet
:运行时抑制安装程序的信息输出--accept-license
:接受Docker 订阅服务协议,而不是在首次运行应用程序时要求接受--installation-dir=<path>
:更改默认安装位置(C:\Program Files\Docker\Docker
)--backend=<backend name>
:选择 Docker Desktop 使用的默认后端,可以是hyper-v
、windows
或wsl-2
(默认)--always-run-service
:安装完成后,启动com.docker.service
并将服务启动类型设置为自动。这可以绕过管理员权限的需求,否则启动com.docker.service
需要管理员权限。Windows 容器和 Hyper-V 后端需要com.docker.service
。
安全和访问控制
--allowed-org=<org name>
:要求用户登录并在运行应用程序时成为指定 Docker Hub 组织的一部分--admin-settings
:自动创建admin-settings.json
文件,管理员可以使用该文件来控制其组织内客户端机器上的某些 Docker Desktop 设置。更多信息请参阅设置管理。- 必须与
--allowed-org=<org name>
标志一起使用。 - 例如:
--allowed-org=<org name> --admin-settings="{'configurationFileVersion': 2, 'enhancedContainerIsolation': {'value': true, 'locked': false}}"
- 必须与
--no-windows-containers
:禁用 Windows 容器集成。这可以提高安全性。更多信息请参阅Windows 容器。
代理配置
--proxy-http-mode=<mode>
:设置 HTTP 代理模式,可以是system
(默认)或manual
--override-proxy-http=<URL>
:设置用于传出 HTTP 请求的 HTTP 代理 URL,需要将--proxy-http-mode
设置为manual
--override-proxy-https=<URL>
:设置用于传出 HTTPS 请求的 HTTP 代理 URL,需要将--proxy-http-mode
设置为manual
--override-proxy-exclude=<hosts/domains>
:绕过主机和域的代理设置。使用逗号分隔列表。--proxy-enable-kerberosntlm
:启用 Kerberos 和 NTLM 代理身份验证。如果启用此功能,请确保您的代理服务器已正确配置用于 Kerberos/NTLM 身份验证。在 Docker Desktop 4.32 及更高版本中可用。
数据根和磁盘位置
--hyper-v-default-data-root=<path>
:指定 Hyper-V VM 磁盘的默认位置。--windows-containers-default-data-root=<path>
:指定 Windows 容器的默认位置。--wsl-default-data-root=<path>
:指定 WSL 分发磁盘的默认位置。
启动 Docker Desktop
安装完成后 Docker Desktop 不会自动启动。要启动 Docker Desktop
搜索 Docker,并在搜索结果中选择Docker Desktop。
Docker 菜单(
)显示 Docker 订阅服务协议。
以下是关键点的摘要
- 对于小型企业(员工少于 250 人且年收入少于 1000 万美元)、个人使用、教育和非商业开源项目,Docker Desktop 是免费的。
- 否则,商业用途需要付费订阅。
- 政府机构也需要付费订阅。
- Docker Pro、Team 和 Business 订阅包括 Docker Desktop 的商业使用。
选择接受继续。接受条款后,Docker Desktop 将启动。
请注意,如果您不同意条款,Docker Desktop 将无法运行。您可以选择在以后通过打开 Docker Desktop 来接受条款。
更多信息请参阅Docker Desktop 订阅服务协议。建议您阅读常见问题解答。
提示
作为 IT 管理员,您可以使用端点管理 (MDM) 软件来识别您环境中的 Docker Desktop 实例数量及其版本。这可以提供准确的许可报告,帮助确保您的机器使用最新版本的 Docker Desktop,并使您能够强制执行登录。
下一步
- 浏览Docker 的订阅计划以了解 Docker 能为您提供什么。
- Docker 入门.
- 探索 Docker Desktop及其所有功能。
- 故障排除描述了常见问题、解决方法以及如何获得支持。
- 常见问题解答提供了常见问题的答案。
- 发行说明列出了组件更新、新功能以及 Docker Desktop 版本相关的改进。
- 备份和恢复数据提供了有关备份和恢复 Docker 相关数据的说明。