Windows：Docker安装

系统要求

---

WSL 2

您必须运行 Windows 10 版本 2004 及更高版本（内部版本 19041 及更高版本）或 Windows 11。

要检查 Windows 版本和内部版本号，请选择 Windows + R，键入winver，然后选择OK。可以通过选择“开始” > “设置” > “ Windows 更新” > “检查更新”来更新到最新的 Windows 版本。

// 安装 wsl，仅在根本未安装 wsl 时才有效。否则看到的应是 wsl 帮助文本
wsl --install

// 查看可用发行版列表
wsl --list --online
或简写
wsl -l -o

// 安装指定发行版
//  替换为发行版名称
wsl --install -d 

// 检查当前版本
wsl --list --version
// 或简写
wsl -l -v

// 将默认版本设置为 WSL 1 或 WSL 2
// 替换为 1 或 2
wsl --set-default-version 

// 设置与该wsl命令一起使用的默认 Linux 发行版
// 替换为您要使用的 Linux 发行版的名称
wsl --setdefault 
// 或简写
wsl -s 

// 运行特定的 wsl 分发而不更改默认分发
// 替换为您要使用的分发的名称
wsl -d 

// 从 WSL 2 降级到 WSL 1,或将以前安装的 Linux 发行版从 WSL 1 更新到 WSL 2
wsl --set-version  2
// 例如：将 Ubuntu 20.04 发行版设置为使用 WSL 2
wsl --set-version Ubuntu-20.04 2

// 注销分发并删除根文件系统
wsl --unregister <分发>

Hyper-v

通过“控制面板” > “程序” > “ 启用或关闭 Windows 功能” 开启Hyper-v。

下载

---

地址：Docker：下载

安装

---

交互式安装

1. 双击Docker Desktop Installer.exe运行安装程序。

   如果您尚未下载安装程序 ( Docker Desktop Installer.exe)，您可以从 Docker Hub获取它。它通常会下载到您的Downloads文件夹中，或者您可以从 Web 浏览器底部的最近下载栏中运行它。

2. 出现提示时，确保根据您选择的后端选择或不选择配置页面上的使用 WSL 2 而不是 Hyper-V选项。

   如果您的系统仅支持这两个选项之一，您将无法选择使用哪个后端。

3. 按照安装向导上的说明授权安装程序并继续安装。

4. 安装成功后，单击关闭以完成安装过程。

5. 如果您的管理员帐户与您的用户帐户不同，则必须将用户添加到docker-users组。以管理员身份运行计算机管理并导航到本地用户和组>组> docker-users。右键单击以将用户添加到组。注销并重新登录以使更改生效。

从命令行安装

下载Docker Desktop Installer.exe后，在终端中运行以下命令安装 Docker Desktop：

"Docker Desktop Installer.exe" install

如果您使用的是 PowerShell，您应该将其运行为：

Start-Process '.\win\build\Docker Desktop Installer.exe' -Wait install

如果使用 Windows 命令提示符：

start /w "" "Docker Desktop Installer.exe" install

install 命令接受以下标志：

• --quiet: 运行安装程序时禁止信息输出
• --accept-license：现在接受Docker 订阅服务协议，而不是要求在应用程序首次运行时接受它
• --no-windows-containers: 禁用 Windows 容器集成
• --allowed-org=：要求用户在运行应用程序时登录并成为指定 Docker Hub 组织的一部分
• --backend=：选择用于 Docker 桌面的默认后端hyper-v，windows或wsl-2（默认）

如果您的管理员帐户与您的用户帐户不同，则必须将用户添加到docker-users组：

net localgroup docker-users  /add

启动 Docker 桌面

安装后 Docker Desktop 不会自动启动。启动 Docker 桌面：

1. 搜索 Docker，然后在搜索结果中选择Docker Desktop 。

   

2. Docker 菜单显示 Docker 订阅服务协议窗口。它包括对 Docker Desktop 使用条款的更改。

3. 单击复选框表示您接受更新后的条款，然后单击接受继续。接受条款后，Docker Desktop 将启动。

更新

当更新可用时，Docker Desktop 会在 Docker 菜单上显示一个图标，以指示更新版本的可用性。此外，设置（ Mac 上的首选项）中的软件更新部分还会通知您 Docker Desktop 可用的任何更新。您可以选择立即下载更新，或单击“发行说明”选项以了解更新版本中包含的内容。

从 Docker Desktop 4.2.0 开始，所有 Docker 订阅（包括 Docker Personal 和 Docker Pro）的用户都可以使用关闭自动检查更新的选项。

Docker订阅服务协议

从 2021 年 8 月 31 日开始，您必须同意Docker 订阅服务协议才能继续使用 Docker Desktop。阅读博客和Docker 订阅常见问题以了解有关更改的更多信息。

当您准备好下载更新时，单击下载更新。这会在后台下载更新。下载更新后，单击更新并从 Docker 菜单重新启动。这将安装最新更新并重新启动 Docker Desktop 以使更改生效。

当 Docker Desktop 启动时，它会显示 Docker 订阅服务协议窗口。阅读屏幕上显示的信息，了解这些变化对您的影响。单击复选框表示您接受更新后的条款，然后单击接受继续。

重要的

如果您不同意这些条款，Docker Desktop 应用程序将关闭，您将无法再在您的机器上运行 Docker Desktop。您可以选择在以后通过打开 Docker Desktop 来接受这些条款。

接受条款后，Docker Desktop 将启动。

卸载 Docker 桌面

要从 Windows 机器上卸载 Docker Desktop：

1. 从 Windows开始菜单中，选择设置>应用程序>应用程序和功能。
2. 从应用程序和功能列表中选择Docker Desktop，然后选择卸载。
3. 单击卸载以确认您的选择。

重要的

卸载 Docker Desktop 会破坏机器本地的 Docker 容器、镜像、卷和其他 Docker 相关数据，并删除应用程序生成的文件。请参阅备份和恢复数据 部分，了解如何在卸载前保留重要数据。

参考：

        Docker：在 windows 上安装 Docker桌面

        Microsoft：安装 wsl